Skip to content

Commit

Permalink
v1.1.0 and docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Kenneth Reitz committed Jan 10, 2013
1 parent 9d33629 commit 41687c8
Show file tree
Hide file tree
Showing 3 changed files with 35 additions and 4 deletions.
9 changes: 9 additions & 0 deletions HISTORY.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,15 @@
History
-------

1.1.0 (2013-01-10)
++++++++++++++++++

- CHUNKED REQUESTS
- Support for iterable response bodies
- Assume servers persist redirect params
- Allow explicit content types to be specified for file data
- Make merge_kwargs case-insensitive when looking up keys

1.0.3 (2012-12-18)
++++++++++++++++++

Expand Down
22 changes: 22 additions & 0 deletions docs/user/advanced.rst
Original file line number Diff line number Diff line change
Expand Up @@ -138,6 +138,28 @@ Excellent news — thanks to urllib3, keep-alive is 100% automatic within a ses
Note that connections are only released back to the pool for reuse once all body data has been read; be sure to either set ``stream`` to ``False`` or read the ``content`` property of the ``Response`` object.


Streaming Uploads
-----------------

Requests supports streaming uploads, which allow you to send large streams or files without reading them into memory. To stream and upload, simply provide a file-like object for your body::

with open('massive-body') as f:
request.post('http://some.url/streamed', data=f)


Chunk-Encoded Requests
----------------------

Requests also supports Chunked transfer encoding for outgoing and incoming requests. 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'

request.post('http://some.url/chunked', data=gen())


Event Hooks
-----------

Expand Down
8 changes: 4 additions & 4 deletions requests/__init__.py
Original file line number Diff line number Diff line change
Expand Up @@ -36,17 +36,17 @@
The other HTTP methods are supported - see `requests.api`. Full documentation
is at <http://python-requests.org>.
:copyright: (c) 2012 by Kenneth Reitz.
:copyright: (c) 2013 by Kenneth Reitz.
:license: Apache 2.0, see LICENSE for more details.
"""

__title__ = 'requests'
__version__ = '1.0.4'
__build__ = 0x01004
__version__ = '1.1.0'
__build__ = 0x010100
__author__ = 'Kenneth Reitz'
__license__ = 'Apache 2.0'
__copyright__ = 'Copyright 2012 Kenneth Reitz'
__copyright__ = 'Copyright 2013 Kenneth Reitz'


from . import utils
Expand Down

0 comments on commit 41687c8

Please sign in to comment.