[lovelydinosaur]

Streaming a request looks like this...

async with httpx.stream("GET", "https://www.example.com") as response:
    async for line in response.stream_lines():
        print(line)

This ensures that our streaming I/O is always properly context scoped.

Essentially closes #555
Closes #588

TODO:

• Documentation.
• Notes in Requests compat section.

[florimondmanca]

Great!

(Aren’t you missing an « async » in front of « for » in your example?)

[lovelydinosaur]

Thanks, yes! (Amended now)

[lovelydinosaur]

@florimondmanca Thanks for having looked this over! Got the docs in now, too.

This one makes me particularly happy - just seems might nicer having any streaming I/O tightly scoped like this. 🤩

[florimondmanca]

Darn typos! 🙈

[florimondmanca]

Suggested change

	* `stream()`. - HTTPX provides a `.stream()` interface rather than using `stream=True`. This ensures that streaming responses are always properly closed outside of the stream block, and makes it visually clearer at which points streaming I/O APIs may be used with a response. Streaming request data is made avialable with `.stream_bytes()`, `.stream_text()`, `.stream_lines()`, and `.stream_raw()`.
	* `stream()` - HTTPX provides a `.stream()` interface rather than using `stream=True`. This ensures that streaming responses are always properly closed outside of the stream block, and makes it visually clearer at which points streaming I/O APIs may be used with a response. Streaming request data is made available with `.stream_bytes()`, `.stream_text()`, `.stream_lines()`, and `.stream_raw()`.

[vjpr]

This was marked as making #393 obsolete, however it now departs from the aiohttp api which allows:

  async with aiohttp.ClientSession() as client:
            async with client.request() as resp:
                ...

SOLVED: client.request can be aliased to client.stream and everything works fine.