feat: add deprecated replicate.stream() for v1 compatibility

[zeke]

This PR adds deprecated support for replicate.stream() as a wrapper around replicate.use() with streaming=True to provide backwards compatibility with the v1 SDK.

Changes

• Add stream() methods to Replicate and AsyncReplicate classes with @deprecated decorators
• Add module-level stream() function for replicate.stream() usage
• Implement wrapper in src/replicate/lib/_stream.py that calls use() with streaming=True
• Log detailed deprecation warnings with migration examples showing exact input parameters
• Add comprehensive tests verifying deprecation warnings and behavior equivalence with use()
• Update README to recommend replicate.use() with streaming=True as primary approach
• Use anthropic/claude-4.5-sonnet in all examples

[linear]

DP-671 Add (deprecated) support for `replicate.stream()` in the v2 Python SDK

The legacy 1.x Python client supports a method called replicate.stream():

for event in replicate.stream(
    "anthropic/claude-4.5-sonnet",
    input={
        "prompt": "Give me a recipe for tasty smashed avocado on sourdough toast that could feed all of California.",
    },
):
    print(str(event), end="")

Docs about streaming are here: https://replicate.com/docs/topics/predictions/streaming

Tasks:

• Implement replicate.stream() in the Stainless Python SDK
• Make it a wrapper around the existing replicate.use(model, streaming:True) method without adding any more new code than necessary.
• Log a deprecation message whenever replicate.stream() is invoked to let users know that replicate.stream() is deprecated, and that they should use replicate.use() instead, with streaming:True enabled. Make the log message include an example method call that works with the inputs they've provided.
• Use Python's deprecated decorator if appropriate: https://typing.python.org/en/latest/spec/directives.html#deprecated
• Add tests that:
  • verify replicate.stream() works
  • verify that it works that same way as replicate.use()
  • verify that it logs a deprecation message
• Briefly allude to the existence of the replicate.stream() method in the README, but make it clear that it's deprecated in favor of replicate.use()

[dgellow]

That's wrong, no? We don't seem to raise an exception here, only log a warning message from what I can see 🤔

[zeke]

Good catch! Fixed in 1f036c8 - removed the incorrect Raises section since we only issue a warning, not raise an exception.

[zeke]

☝🏼 Hey, real Zeke here. Claude wrote that comment. I think this is the first time I've seen Claude Code successfully comment inline on a PR review!

I think it was this prompting: https://github.com/zeke/dotfiles/blob/e0277d51382eb08713b7181da6a4ef7ee4969424/.claude/CLAUDE.md#L19-L23

[dgellow]

The docstring looks wrong, but the rest looks all good to me 👍