The Requests Toolbelt
=====================
This is just a collection of utilities for `python-requests`_, but don't
really belong in ``requests`` proper. The minimum tested requests version is
``2.1.0``. In reality, the toolbelt should work with ``2.0.1`` as well, but
some idiosyncracies prevent effective or sane testing on that version.
``pip install requests-toolbelt`` to get started!
multipart/form-data Encoder
---------------------------
The main attraction is a streaming multipart form-data object, ``MultipartEncoder``.
Its API looks like this:
.. code-block:: python
from requests_toolbelt import MultipartEncoder
import requests
m = MultipartEncoder(
fields={'field0': 'value', 'field1': 'value',
'field2': ('filename', open('file.py', 'rb'), 'text/plain')}
)
r = requests.post('http://httpbin.org/post', data=m,
headers={'Content-Type': m.content_type})
You can also use ``multipart/form-data`` encoding for requests that don't
require files:
.. code-block:: python
from requests_toolbelt import MultipartEncoder
import requests
m = MultipartEncoder(fields={'field0': 'value', 'field1': 'value'})
r = requests.post('http://httpbin.org/post', data=m,
headers={'Content-Type': m.content_type})
Or, you can just create the string and examine the data:
.. code-block:: python
# Assuming `m` is one of the above
m.to_string() # Always returns unicode
User-Agent constructor
----------------------
You can easily construct a requests-style ``User-Agent`` string::
from requests_toolbelt import user_agent
headers = {
'User-Agent': user_agent('my_package', '0.0.1')
}
r = requests.get('https://api.github.com/users', headers=headers)
SSLAdapter
----------
The ``SSLAdapter`` was originally published on `Cory Benfield's blog`_.
This adapter allows the user to choose one of the SSL protocols made available
in Python's ``ssl`` module for outgoing HTTPS connections:
.. code-block:: python
from requests_toolbelt import SSLAdapter
import requests
import ssl
s = requests.Session()
s.mount('https://', SSLAdapter(ssl.PROTOCOL_TLSv1))
cookies/ForgetfulCookieJar
--------------------------
The ``ForgetfulCookieJar`` prevents a particular requests session from storing
cookies:
.. code-block:: python
from requests_toolbelt.cookies.forgetful import ForgetfulCookieJar
session = requests.Session()
session.cookies = ForgetfulCookieJar()
Contributing
------------
Please read the `suggested workflow
<https://toolbelt.readthedocs.io/en/latest/contributing.html>`_ for
contributing to this project.
Please report any bugs on the `issue tracker`_
.. _Cory Benfield's blog: https://lukasa.co.uk/2013/01/Choosing_SSL_Version_In_Requests/
.. _python-requests: https://github.com/kennethreitz/requests
.. _issue tracker: https://github.com/requests/toolbelt/issues
History
=======
1.0.0 -- 2023-05-01
-------------------
Breaking Changes
~~~~~~~~~~~~~~~~
- Removed Google App Engine support to allow using urllib3 2.0
Fixed Bugs
~~~~~~~~~~
- Ensured the test suite no longer reaches the Internet
Miscellaneous
~~~~~~~~~~~~~
- Added explicit support for Python 3.11
0.10.1 -- 2022-10-25
--------------------
Fixed Bugs
~~~~~~~~~~
- Fix urllib3 warning to only emit on X509Adapter usage
0.10.0 -- 2022-10-06
--------------------
New Features
~~~~~~~~~~~~
- Add support for preparing requests in BaseUrlSession
Fixed Bugs
~~~~~~~~~~
- Fixing missing newline in dump utility
0.9.1 -- 2019-01-29
-------------------
Fixed Bugs
~~~~~~~~~~
- Fix import of pyOpenSSL shim from urllib3 for PKCS12 adapter
0.9.0 -- 2019-01-29
-------------------
New Features
~~~~~~~~~~~~
- Add X509 Adapter that can handle PKCS12
- Add stateless solution for streaming files by MultipartEncoder from one host to another (in chunks)
Fixed Bugs
~~~~~~~~~~
- Update link to example
- Move import of ``ABCs`` from collections into version-specific part of
_compat module
- Fix backwards incompatibility in ``get_encodings_from_content``
- Correct callback documentation for ``MultipartEncoderMonitor``
- Fix bug when ``MultipartEncoder`` is asked to encode zero parts
- Correct the type of non string request body dumps
- Removed content from being stored in MultipartDecoder
- Fix bug by enabling support for contenttype with capital letters.
- Coerce proxy URL to bytes before dumping request
- Avoid bailing out with exception upon empty response reason
- Corrected Pool documentation
- Corrected parentheses match in example usage
- Fix "oject" to "object" in ``MultipartEncoder``
- Fix URL for the project after the move
- Add fix for OSX TCPKeepAliveAdapter
Miscellaneous
~~~~~~~~~~~~~
- Remove py33 from testing and add Python 3.6 and nightly testing to the travis matrix.
0.8.0 -- 2017-05-20
-------------------
More information about this release can be found on the `0.8.0 milestone`_.
New Features
~~~~~~~~~~~~
- Add ``UserAgentBuilder`` to provide more control over generated User-Agent
strings.
Fixed Bugs
~~~~~~~~~~
- Include ``_validate_certificate`` in the lits of picked attributes on the
``AppEngineAdapter``.
- Fix backwards incompatibility in ``get_encodings_from_content``
.. _0.8.0 milestone:
https://github.com/requests/toolbelt/milestones/0.8.0
0.7.1 -- 2017-02-13
-------------------
More information about this release can be found on the `0.7.1 milestone`_.
Fixed Bugs
~~~~~~~~~~
- Fixed monkey-patching for the AppEngineAdapter.
- Make it easier to disable certificate verification when monkey-patching
AppEngine.
- Handle ``multipart/form-data`` bodies without a trailing ``CRLF``.
.. links
.. _0.7.1 milestone:
https://github.com/requests/toolbelt/milestone/9
0.7.0 -- 2016-07-21
-------------------
More information about this release can be found on the `0.7.0 milestone`_.
New Features
~~~~~~~~~~~~
- Add ``BaseUrlSession`` to allow developers to have a session that has a
"Base" URL. See the documentation for more details and examples.
- Split the logic of ``stream_response_to_file`` into two separate functions:
* ``get_download_file_path`` to generate the file name from the Response.
* ``stream_response_to_file`` which will use ``get_download_file_path`` if
necessary
Fixed Bugs
~~~~~~~~~~
- Fixed the issue for people using *very* old versions of Requests where they
would see an ImportError from ``requests_toolbelt._compat`` when trying to
import ``connection``.
.. _0.7.0 milestone:
https://github.com/requests/toolbelt/milestones/0.7.0
0.6.2 -- 2016-05-10
-------------------
Fixed Bugs
~~~~~~~~~~
- When passing a timeout via Requests, it was not appropriately translated to
the timeout that the urllib3 code was expecting.
0.6.1 -- 2016-05-05
-------------------
Fixed Bugs
~~~~~~~~~~
- Remove assertion about request URLs in the AppEngineAdapter.
- Prevent pip from installing requests 3.0.0 when that is released until we
are ready to handle it.
0.6.0 -- 2016-01-27
-------------------
More information about this release can be found on the `0.6.0 milestone`_.
New Features
~~~~~~~~~~~~
- Add ``AppEngineAdapter`` to support developers using Google's AppEngine
platform with Requests.
- Add ``GuessProxyAuth`` class to support guessing between Basic and Digest
Authentication for proxies.
Fixed Bugs
~~~~~~~~~~
- Ensure that proxies use the correct TLS version when using the
``SSLAdapter``.
- Fix an ``AttributeError`` when using the ``HTTPProxyDigestAuth`` class.
Miscellaneous
~~~~~~~~~~~~~
- Drop testing support for Python 3.2. virtualenv and pip have stopped
supporting it meaning that it is harder to test for this with our CI
infrastructure. Moving forward we will make a best-effort attempt to
support 3.2 but will not test for it.
.. _0.6.0 milestone:
https://github.com/requests/toolbelt/milestones/0.6.0
0.5.1 -- 2015-12-16
-------------------
More information about this release can be found on the `0.5.1 milestone`_.
Fixed Bugs
~~~~~~~~~~
- Now papers over the differences in requests' ``super_len`` function from
versions prior to 2.9.0 and versions 2.9.0 and later.
.. _0.5.1 milestone:
https://github.com/requests/toolbelt/milestones/0.5.1
0.5.0 -- 2015-11-24
-------------------
More information about this release can be found on the `milestone
<https://github.com/requests/toolbelt/issues?utf8=%E2%9C%93&q=is%3Aall+milestone%3A0.5+>`_
for 0.5.0.
New Features
~~~~~~~~~~~~
- The ``tee`` submodule was added to ``requests_toolbelt.downloadutils``. It
allows you to iterate over the bytes of a response while also writing them
to a file. The ``tee.tee`` function, expects you to pass an open file
object, while ``tee.tee_to_file`` will use the provided file name to open
the file for you.
- Added a new parameter to ``requests_toolbelt.utils.user_agent`` that allows
the user to specify additional items.
- Added nested form-data helper,
``requests_toolbelt.utils.formdata.urlencode``.
- Added the ``ForgetfulCookieJar`` to ``requests_toolbelt.cookies``.
- Added utilities for dumping the information about a request-response cycle
in ``requests_toolbelt.utils.dump``.
- Implemented the API described in the ``requests_toolbelt.threaded`` module
docstring, i.e., added ``requests_toolbelt.threaded.map`` as an available
function.
Fixed Bugs
~~~~~~~~~~
- Now papers over the API differences in versions of requests installed from
system packages versus versions of requests installed from PyPI.
- Allow string types for ``SourceAddressAdapter``.
0.4.0 -- 2015-04-03
-------------------
For more information about this release, please see `milestone 0.4.0
<https://github.com/requests/toolbelt/issues?q=milestone%3A0.4>`_
on the project's page.
New Features
~~~~~~~~~~~~
- A naive implemenation of a thread pool is now included in the toolbelt. See
the docs in ``docs/threading.rst`` or on `Read The Docs
<https://toolbelt.readthedocs.io/>`_.
- The ``StreamingIterator`` now accepts files (such as ``sys.stdin``) without
a specific length and will properly stream them.
- The ``MultipartEncoder`` now accepts exactly the same format of fields as
requests' ``files`` parameter does. In other words, you can now also pass in
extra headers to add to a part in the body. You can also now specify a
custom ``Content-Type`` for a part.
- An implementation of HTTP Digest Authentication for Proxies is now included.
- A transport adapter that allows a user to specify a specific Certificate
Fingerprint is now included in the toolbelt.
- A transport adapter that simplifies how users specify socket options is now
included.
- A transport adapter that simplifies how users can specify TCP Keep-Alive
options is now included in the toolbelt.
- Deprecated functions from ``requests.utils`` are now included and
maintained.
- An authentication tool that allows users to specify how to authenticate to
several different domains at once is now included.
- A function to save streamed responses to disk by analyzing the
``Content-Disposition`` header is now included in the toolbelt.
Fixed Bugs
~~~~~~~~~~
- The ``MultipartEncoder`` will now allow users to upload files larger than
4GB on 32-bit systems.
- The ``MultipartEncoder`` will now accept empty unicode strings for form
values.
0.3.1 -- 2014-06-23
-------------------
- Fix the fact that 0.3.0 bundle did not include the ``StreamingIterator``
0.3.0 -- 2014-05-21
-------------------
Bug Fixes
~~~~~~~~~
- Complete rewrite of ``MultipartEncoder`` fixes bug where bytes were lost in
uploads
New Features
~~~~~~~~~~~~
- ``MultipartDecoder`` to accept ``multipart/form-data`` response bodies and
parse them into an easy to use object.
- ``SourceAddressAdapter`` to allow users to choose a local address to bind
connections to.
- ``GuessAuth`` which accepts a username and password and uses the
``WWW-Authenticate`` header to determine how to authenticate against a
server.
- ``MultipartEncoderMonitor`` wraps an instance of the ``MultipartEncoder``
and keeps track of how many bytes were read and will call the provided
callback.
- ``StreamingIterator`` will wrap an iterator and stream the upload instead of
chunk it, provided you also provide the length of the content you wish to
upload.
0.2.0 -- 2014-02-24
-------------------
- Add ability to tell ``MultipartEncoder`` which encoding to use. By default
it uses 'utf-8'.
- Fix #10 - allow users to install with pip
- Fix #9 - Fix ``MultipartEncoder#to_string`` so that it properly handles file
objects as fields
0.1.2 -- 2014-01-19
-------------------
- At some point during development we broke how we handle normal file objects.
Thanks to @konomae this is now fixed.
0.1.1 -- 2014-01-19
-------------------
- Handle ``io.BytesIO``-like objects better
0.1.0 -- 2014-01-18
-------------------
- Add initial implementation of the streaming ``MultipartEncoder``
- Add initial implementation of the ``user_agent`` function
- Add the ``SSLAdapter``
Raw data
{
"_id": null,
"home_page": "https://toolbelt.readthedocs.io/",
"name": "requests-toolbelt",
"maintainer": "",
"docs_url": null,
"requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
"maintainer_email": "",
"keywords": "",
"author": "Ian Cordasco, Cory Benfield",
"author_email": "graffatcolmingov@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/f3/61/d7545dafb7ac2230c70d38d31cbfe4cc64f7144dc41f6e4e4b78ecd9f5bb/requests-toolbelt-1.0.0.tar.gz",
"platform": null,
"description": "The Requests Toolbelt\n=====================\n\nThis is just a collection of utilities for `python-requests`_, but don't\nreally belong in ``requests`` proper. The minimum tested requests version is\n``2.1.0``. In reality, the toolbelt should work with ``2.0.1`` as well, but\nsome idiosyncracies prevent effective or sane testing on that version.\n\n``pip install requests-toolbelt`` to get started!\n\n\nmultipart/form-data Encoder\n---------------------------\n\nThe main attraction is a streaming multipart form-data object, ``MultipartEncoder``.\nIts API looks like this:\n\n.. code-block:: python\n\n from requests_toolbelt import MultipartEncoder\n import requests\n\n m = MultipartEncoder(\n fields={'field0': 'value', 'field1': 'value',\n 'field2': ('filename', open('file.py', 'rb'), 'text/plain')}\n )\n\n r = requests.post('http://httpbin.org/post', data=m,\n headers={'Content-Type': m.content_type})\n\n\nYou can also use ``multipart/form-data`` encoding for requests that don't\nrequire files:\n\n.. code-block:: python\n\n from requests_toolbelt import MultipartEncoder\n import requests\n\n m = MultipartEncoder(fields={'field0': 'value', 'field1': 'value'})\n\n r = requests.post('http://httpbin.org/post', data=m,\n headers={'Content-Type': m.content_type})\n\n\nOr, you can just create the string and examine the data:\n\n.. code-block:: python\n\n # Assuming `m` is one of the above\n m.to_string() # Always returns unicode\n\n\nUser-Agent constructor\n----------------------\n\nYou can easily construct a requests-style ``User-Agent`` string::\n\n from requests_toolbelt import user_agent\n\n headers = {\n 'User-Agent': user_agent('my_package', '0.0.1')\n }\n\n r = requests.get('https://api.github.com/users', headers=headers)\n\n\nSSLAdapter\n----------\n\nThe ``SSLAdapter`` was originally published on `Cory Benfield's blog`_.\nThis adapter allows the user to choose one of the SSL protocols made available\nin Python's ``ssl`` module for outgoing HTTPS connections:\n\n.. code-block:: python\n\n from requests_toolbelt import SSLAdapter\n import requests\n import ssl\n\n s = requests.Session()\n s.mount('https://', SSLAdapter(ssl.PROTOCOL_TLSv1))\n\ncookies/ForgetfulCookieJar\n--------------------------\n\nThe ``ForgetfulCookieJar`` prevents a particular requests session from storing\ncookies:\n\n.. code-block:: python\n\n from requests_toolbelt.cookies.forgetful import ForgetfulCookieJar\n\n session = requests.Session()\n session.cookies = ForgetfulCookieJar()\n\nContributing\n------------\n\nPlease read the `suggested workflow\n<https://toolbelt.readthedocs.io/en/latest/contributing.html>`_ for\ncontributing to this project.\n\nPlease report any bugs on the `issue tracker`_\n\n.. _Cory Benfield's blog: https://lukasa.co.uk/2013/01/Choosing_SSL_Version_In_Requests/\n.. _python-requests: https://github.com/kennethreitz/requests\n.. _issue tracker: https://github.com/requests/toolbelt/issues\n\n\nHistory\n=======\n\n1.0.0 -- 2023-05-01\n-------------------\n\nBreaking Changes\n~~~~~~~~~~~~~~~~\n\n- Removed Google App Engine support to allow using urllib3 2.0\n\nFixed Bugs\n~~~~~~~~~~\n\n- Ensured the test suite no longer reaches the Internet\n\nMiscellaneous\n~~~~~~~~~~~~~\n\n- Added explicit support for Python 3.11\n\n0.10.1 -- 2022-10-25\n--------------------\n\nFixed Bugs\n~~~~~~~~~~\n\n- Fix urllib3 warning to only emit on X509Adapter usage\n\n0.10.0 -- 2022-10-06\n--------------------\n\nNew Features\n~~~~~~~~~~~~\n\n- Add support for preparing requests in BaseUrlSession\n\nFixed Bugs\n~~~~~~~~~~\n\n- Fixing missing newline in dump utility\n\n0.9.1 -- 2019-01-29\n-------------------\n\nFixed Bugs\n~~~~~~~~~~\n\n- Fix import of pyOpenSSL shim from urllib3 for PKCS12 adapter\n\n0.9.0 -- 2019-01-29\n-------------------\n\nNew Features\n~~~~~~~~~~~~\n\n- Add X509 Adapter that can handle PKCS12\n- Add stateless solution for streaming files by MultipartEncoder from one host to another (in chunks)\n\nFixed Bugs\n~~~~~~~~~~\n\n- Update link to example\n- Move import of ``ABCs`` from collections into version-specific part of\n _compat module\n- Fix backwards incompatibility in ``get_encodings_from_content``\n- Correct callback documentation for ``MultipartEncoderMonitor``\n- Fix bug when ``MultipartEncoder`` is asked to encode zero parts\n- Correct the type of non string request body dumps\n- Removed content from being stored in MultipartDecoder\n- Fix bug by enabling support for contenttype with capital letters.\n- Coerce proxy URL to bytes before dumping request\n- Avoid bailing out with exception upon empty response reason\n- Corrected Pool documentation\n- Corrected parentheses match in example usage\n- Fix \"oject\" to \"object\" in ``MultipartEncoder``\n- Fix URL for the project after the move\n- Add fix for OSX TCPKeepAliveAdapter\n\nMiscellaneous\n~~~~~~~~~~~~~\n\n- Remove py33 from testing and add Python 3.6 and nightly testing to the travis matrix.\n\n0.8.0 -- 2017-05-20\n-------------------\n\nMore information about this release can be found on the `0.8.0 milestone`_.\n\nNew Features\n~~~~~~~~~~~~\n\n- Add ``UserAgentBuilder`` to provide more control over generated User-Agent\n strings.\n\nFixed Bugs\n~~~~~~~~~~\n\n- Include ``_validate_certificate`` in the lits of picked attributes on the\n ``AppEngineAdapter``.\n- Fix backwards incompatibility in ``get_encodings_from_content``\n\n.. _0.8.0 milestone:\n https://github.com/requests/toolbelt/milestones/0.8.0\n\n0.7.1 -- 2017-02-13\n-------------------\n\nMore information about this release can be found on the `0.7.1 milestone`_.\n\nFixed Bugs\n~~~~~~~~~~\n\n- Fixed monkey-patching for the AppEngineAdapter.\n\n- Make it easier to disable certificate verification when monkey-patching\n AppEngine.\n\n- Handle ``multipart/form-data`` bodies without a trailing ``CRLF``.\n\n\n.. links\n.. _0.7.1 milestone:\n https://github.com/requests/toolbelt/milestone/9\n\n0.7.0 -- 2016-07-21\n-------------------\n\nMore information about this release can be found on the `0.7.0 milestone`_.\n\nNew Features\n~~~~~~~~~~~~\n\n- Add ``BaseUrlSession`` to allow developers to have a session that has a\n \"Base\" URL. See the documentation for more details and examples.\n\n- Split the logic of ``stream_response_to_file`` into two separate functions:\n\n * ``get_download_file_path`` to generate the file name from the Response.\n\n * ``stream_response_to_file`` which will use ``get_download_file_path`` if\n necessary\n\nFixed Bugs\n~~~~~~~~~~\n\n- Fixed the issue for people using *very* old versions of Requests where they\n would see an ImportError from ``requests_toolbelt._compat`` when trying to\n import ``connection``.\n\n\n.. _0.7.0 milestone:\n https://github.com/requests/toolbelt/milestones/0.7.0\n\n0.6.2 -- 2016-05-10\n-------------------\n\nFixed Bugs\n~~~~~~~~~~\n\n- When passing a timeout via Requests, it was not appropriately translated to\n the timeout that the urllib3 code was expecting.\n\n0.6.1 -- 2016-05-05\n-------------------\n\nFixed Bugs\n~~~~~~~~~~\n\n- Remove assertion about request URLs in the AppEngineAdapter.\n\n- Prevent pip from installing requests 3.0.0 when that is released until we\n are ready to handle it.\n\n0.6.0 -- 2016-01-27\n-------------------\n\nMore information about this release can be found on the `0.6.0 milestone`_.\n\nNew Features\n~~~~~~~~~~~~\n\n- Add ``AppEngineAdapter`` to support developers using Google's AppEngine\n platform with Requests.\n\n- Add ``GuessProxyAuth`` class to support guessing between Basic and Digest\n Authentication for proxies.\n\nFixed Bugs\n~~~~~~~~~~\n\n- Ensure that proxies use the correct TLS version when using the\n ``SSLAdapter``.\n\n- Fix an ``AttributeError`` when using the ``HTTPProxyDigestAuth`` class.\n\nMiscellaneous\n~~~~~~~~~~~~~\n\n- Drop testing support for Python 3.2. virtualenv and pip have stopped\n supporting it meaning that it is harder to test for this with our CI\n infrastructure. Moving forward we will make a best-effort attempt to\n support 3.2 but will not test for it.\n\n\n.. _0.6.0 milestone:\n https://github.com/requests/toolbelt/milestones/0.6.0\n\n0.5.1 -- 2015-12-16\n-------------------\n\nMore information about this release can be found on the `0.5.1 milestone`_.\n\nFixed Bugs\n~~~~~~~~~~\n\n- Now papers over the differences in requests' ``super_len`` function from\n versions prior to 2.9.0 and versions 2.9.0 and later.\n\n\n.. _0.5.1 milestone:\n https://github.com/requests/toolbelt/milestones/0.5.1\n\n0.5.0 -- 2015-11-24\n-------------------\n\nMore information about this release can be found on the `milestone\n<https://github.com/requests/toolbelt/issues?utf8=%E2%9C%93&q=is%3Aall+milestone%3A0.5+>`_\nfor 0.5.0.\n\nNew Features\n~~~~~~~~~~~~\n\n- The ``tee`` submodule was added to ``requests_toolbelt.downloadutils``. It\n allows you to iterate over the bytes of a response while also writing them\n to a file. The ``tee.tee`` function, expects you to pass an open file\n object, while ``tee.tee_to_file`` will use the provided file name to open\n the file for you.\n\n- Added a new parameter to ``requests_toolbelt.utils.user_agent`` that allows\n the user to specify additional items.\n\n- Added nested form-data helper,\n ``requests_toolbelt.utils.formdata.urlencode``.\n\n- Added the ``ForgetfulCookieJar`` to ``requests_toolbelt.cookies``.\n\n- Added utilities for dumping the information about a request-response cycle\n in ``requests_toolbelt.utils.dump``.\n\n- Implemented the API described in the ``requests_toolbelt.threaded`` module\n docstring, i.e., added ``requests_toolbelt.threaded.map`` as an available\n function.\n\nFixed Bugs\n~~~~~~~~~~\n\n- Now papers over the API differences in versions of requests installed from\n system packages versus versions of requests installed from PyPI.\n\n- Allow string types for ``SourceAddressAdapter``.\n\n0.4.0 -- 2015-04-03\n-------------------\n\nFor more information about this release, please see `milestone 0.4.0\n<https://github.com/requests/toolbelt/issues?q=milestone%3A0.4>`_\non the project's page.\n\nNew Features\n~~~~~~~~~~~~\n\n- A naive implemenation of a thread pool is now included in the toolbelt. See\n the docs in ``docs/threading.rst`` or on `Read The Docs\n <https://toolbelt.readthedocs.io/>`_.\n\n- The ``StreamingIterator`` now accepts files (such as ``sys.stdin``) without\n a specific length and will properly stream them.\n\n- The ``MultipartEncoder`` now accepts exactly the same format of fields as\n requests' ``files`` parameter does. In other words, you can now also pass in\n extra headers to add to a part in the body. You can also now specify a\n custom ``Content-Type`` for a part.\n\n- An implementation of HTTP Digest Authentication for Proxies is now included.\n\n- A transport adapter that allows a user to specify a specific Certificate\n Fingerprint is now included in the toolbelt.\n\n- A transport adapter that simplifies how users specify socket options is now\n included.\n\n- A transport adapter that simplifies how users can specify TCP Keep-Alive\n options is now included in the toolbelt.\n\n- Deprecated functions from ``requests.utils`` are now included and\n maintained.\n\n- An authentication tool that allows users to specify how to authenticate to\n several different domains at once is now included.\n\n- A function to save streamed responses to disk by analyzing the\n ``Content-Disposition`` header is now included in the toolbelt.\n\nFixed Bugs\n~~~~~~~~~~\n\n- The ``MultipartEncoder`` will now allow users to upload files larger than\n 4GB on 32-bit systems.\n\n- The ``MultipartEncoder`` will now accept empty unicode strings for form\n values.\n\n0.3.1 -- 2014-06-23\n-------------------\n\n- Fix the fact that 0.3.0 bundle did not include the ``StreamingIterator``\n\n0.3.0 -- 2014-05-21\n-------------------\n\nBug Fixes\n~~~~~~~~~\n\n- Complete rewrite of ``MultipartEncoder`` fixes bug where bytes were lost in\n uploads\n\nNew Features\n~~~~~~~~~~~~\n\n- ``MultipartDecoder`` to accept ``multipart/form-data`` response bodies and\n parse them into an easy to use object.\n\n- ``SourceAddressAdapter`` to allow users to choose a local address to bind\n connections to.\n\n- ``GuessAuth`` which accepts a username and password and uses the\n ``WWW-Authenticate`` header to determine how to authenticate against a\n server.\n\n- ``MultipartEncoderMonitor`` wraps an instance of the ``MultipartEncoder``\n and keeps track of how many bytes were read and will call the provided\n callback.\n\n- ``StreamingIterator`` will wrap an iterator and stream the upload instead of\n chunk it, provided you also provide the length of the content you wish to\n upload.\n\n0.2.0 -- 2014-02-24\n-------------------\n\n- Add ability to tell ``MultipartEncoder`` which encoding to use. By default\n it uses 'utf-8'.\n\n- Fix #10 - allow users to install with pip\n\n- Fix #9 - Fix ``MultipartEncoder#to_string`` so that it properly handles file\n objects as fields\n\n0.1.2 -- 2014-01-19\n-------------------\n\n- At some point during development we broke how we handle normal file objects.\n Thanks to @konomae this is now fixed.\n\n0.1.1 -- 2014-01-19\n-------------------\n\n- Handle ``io.BytesIO``-like objects better\n\n0.1.0 -- 2014-01-18\n-------------------\n\n- Add initial implementation of the streaming ``MultipartEncoder``\n\n- Add initial implementation of the ``user_agent`` function\n\n- Add the ``SSLAdapter``\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "A utility belt for advanced users of python-requests",
"version": "1.0.0",
"project_urls": {
"Changelog": "https://github.com/requests/toolbelt/blob/master/HISTORY.rst",
"Homepage": "https://toolbelt.readthedocs.io/",
"Source": "https://github.com/requests/toolbelt"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3f51d4db610ef29373b879047326cbf6fa98b6c1969d6f6dc423279de2b1be2c",
"md5": "a85998b5e6620919a7e79e854128fae4",
"sha256": "cccfdd665f0a24fcf4726e690f65639d272bb0637b9b92dfd91a5568ccf6bd06"
},
"downloads": -1,
"filename": "requests_toolbelt-1.0.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "a85998b5e6620919a7e79e854128fae4",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
"size": 54481,
"upload_time": "2023-05-01T04:11:28",
"upload_time_iso_8601": "2023-05-01T04:11:28.427086Z",
"url": "https://files.pythonhosted.org/packages/3f/51/d4db610ef29373b879047326cbf6fa98b6c1969d6f6dc423279de2b1be2c/requests_toolbelt-1.0.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f361d7545dafb7ac2230c70d38d31cbfe4cc64f7144dc41f6e4e4b78ecd9f5bb",
"md5": "6a8348cfc9991b44e499345db1c6f925",
"sha256": "7681a0a3d047012b5bdc0ee37d7f8f07ebe76ab08caeccfc3921ce23c88d5bc6"
},
"downloads": -1,
"filename": "requests-toolbelt-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "6a8348cfc9991b44e499345db1c6f925",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*",
"size": 206888,
"upload_time": "2023-05-01T04:11:33",
"upload_time_iso_8601": "2023-05-01T04:11:33.229998Z",
"url": "https://files.pythonhosted.org/packages/f3/61/d7545dafb7ac2230c70d38d31cbfe4cc64f7144dc41f6e4e4b78ecd9f5bb/requests-toolbelt-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-01 04:11:33",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "requests",
"github_project": "toolbelt",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "requests-toolbelt"
}
JSON
