Mercurial > repos > bcclaywell > argo_navis
diff venv/lib/python2.7/site-packages/requests_toolbelt-0.4.0.dist-info/METADATA @ 0:d67268158946 draft
planemo upload commit a3f181f5f126803c654b3a66dd4e83a48f7e203b
| author | bcclaywell |
|---|---|
| date | Mon, 12 Oct 2015 17:43:33 -0400 |
| parents | |
| children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/venv/lib/python2.7/site-packages/requests_toolbelt-0.4.0.dist-info/METADATA Mon Oct 12 17:43:33 2015 -0400 @@ -0,0 +1,249 @@ +Metadata-Version: 2.0 +Name: requests-toolbelt +Version: 0.4.0 +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: Copyright 2014 Ian Cordasco, Cory Benfield +Requires-Dist: requests (>=2.0.1,<=3.0.0) + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. + +Description: 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. + + + 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)) + + + 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.* + + .. _Cory Benfield's blog: https://lukasa.co.uk/2013/01/Choosing_SSL_Version_In_Requests/ + .. _python-requests: https://github.com/kennethreitz/requests + + + History + ======= + + 0.4.0 -- 2015-04-03 + ------------------- + + For more information about this release, please see `milestone 0.4.0 + <https://github.com/sigmavirus24/requests-toolbelt/issues/46>`_ 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`` + +Platform: UNKNOWN +Classifier: Development Status :: 5 - Production/Stable +Classifier: License :: OSI Approved +Classifier: Intended Audience :: Developers +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 2 +Classifier: Programming Language :: Python :: 2.6 +Classifier: Programming Language :: Python :: 2.7 +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.2 +Classifier: Programming Language :: Python :: 3.3 +Classifier: Programming Language :: Python :: Implementation :: CPython
