why does httpx use client.stream(method, ...) rather than a stream parameter like other library?

[NewUserHa]

Examples:
the requests uses https://docs.python-requests.org/en/latest/user/quickstart/#raw-response-content.
the aiohttp doesn't reads the HTTP content until await.

Since httpx is async-able, could httpx not to read the content(probably a doze MB response) until await, or merge client.stream to ordinary client.get/post for convenient like the requests?

[lovelydinosaur]

Because when you stream a response body you need to make sure that you close the response. Handling that within a context manager is more appropriate to ensure that always occurs properly.

To put it into another context, it's similar to us only allowing this kind of file opening API...

# Recommended way to open files in Python,
# since it ensures you can't accidentally fail to close it,
# and the context *shows* the scope within which the resource is used.
open("some_file.txt", "r") as some_file:
    ...

And not allowing this kind of usage...

# Bad practice. Using a context manager is a better construct.
some_file = open("some_file.txt", "r")

# Oops, I better call `some_file.close()` somewhere.
# And I better make sure it's always called even if I get some unexpected exception along the way.
# I guess I could do that with a `try...finally...` block. Wait a minute why didn't I just use a context manager?

[NewUserHa]

for that sentence:
I mean, users who need a simple sync client could use just requests. so async probably is an advantage for httpx.
Therefore async within httpx could be good use cases for new users and a good alternative async client.

[euri10]

open("some_file.txt", "r") as some_file:

you probably mean with open("some_file.txt", "r") as some_file: ?

[lovelydinosaur]

Right understood. Personally I'd rather the other way around tho.
HTTPX is an alternate HTTP client library in the same space as requests. It happens to also support async.

[lovelydinosaur]

Yes, thanks for the correction @euri10. 😁

[NewUserHa]

back to the topic:
probably httpx could use stream=True as a parameter instead of a .stream() method for convenient and more requests-like?