diff env/lib/python3.7/site-packages/requests_toolbelt-0.9.1.dist-info/METADATA @ 0:26e78fe6e8c4 draft

"planemo upload commit c699937486c35866861690329de38ec1a5d9f783"
author shellac
date Sat, 02 May 2020 07:14:21 -0400
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/env/lib/python3.7/site-packages/requests_toolbelt-0.9.1.dist-info/METADATA	Sat May 02 07:14:21 2020 -0400
@@ -0,0 +1,482 @@
+Metadata-Version: 2.1
+Name: requests-toolbelt
+Version: 0.9.1
+Summary: A utility belt for advanced users of python-requests
+Home-page: https://toolbelt.readthedocs.org
+Author: Ian Cordasco, Cory Benfield
+Author-email: graffatcolmingov@gmail.com
+License: Apache 2.0
+Platform: UNKNOWN
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Requires-Dist: requests (<3.0.0,>=2.0.1)
+
+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()
+
+Known Issues
+------------
+
+On Python 3.3.0 and 3.3.1, the standard library's ``http`` module will fail
+when passing an instance of the ``MultipartEncoder``. This is fixed in later
+minor releases of Python 3.3. Please consider upgrading to a later minor
+version or Python 3.4. *There is absolutely nothing this library can do to
+work around that bug.*
+
+Contributing
+------------
+
+Please read the `suggested workflow
+<https://toolbelt.readthedocs.org/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
+=======
+
+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.org>`_.
+
+- 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``
+
+