diff --git a/docs/user/advanced.rst b/docs/user/advanced.rst index 5b0d61cd..bfdea39c 100644 --- a/docs/user/advanced.rst +++ b/docs/user/advanced.rst @@ -268,13 +268,19 @@ Requests also supports Chunked transfer encoding for outgoing and incoming reque To send a chunk-encoded request, simply provide a generator (or any iterator without a length) for your body:: - def gen(): yield 'hi' yield 'there' requests.post('http://some.url/chunked', data=gen()) +For chunked encoded responses, it's best to iterate over the data using +:meth:`Response.iter_content() `. In +an ideal situation you'll have set ``stream=True`` on the request, in which +case you can iterate chunk-by-chunk by calling ``iter_content`` with a chunk +size parameter of ``None``. If you want to set a maximum size of the chunk, +you can set a chunk size parameter to any integer. + .. _multipart: