requests-toolbelt

requests toolbelt

This is just a collection of utilities that some users of python-requests might need but do not belong in requests proper.

multipart/form-data Encoder

The main attraction is a streaming multipart form-data object. Its API looks like:

from requests_toolbelt import MultipartEncoder

import requests


m = MultipartEncoder(
    fields={'field0': 'value', 'field1': 'value',
            'field2': ('filename', open('file.py'), 'text/plain')}
    )

r = requests.post('http://httpbin.org/post', data=m,
                  headers={'Content-Type': m.content_type})

You can also use it to just plain use multipart/form-data encoding for requests that do not require files:

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})

You can also just use it to create the string to examine the data:

# Assuming `m` is one of the above

m.to_string()  # Always returns unicode

User-Agent constructor

You can easily construct your own 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 is an implementation of the adapter proposed over on @Lukasa’s blog, here. This adapter allows the user to choose one of the SSL protocols made available in Python’s ssl module for outgoing HTTPS connections.:

from requests_toolbelt import SSLAdapter

import requests
import ssl

s = requests.Session()
s.mount('https://', SSLAdapter(ssl.PROTOCOL_TLSv1))

History

0.1.0 – 2014-01-18

Add initial implementation of the streaming MultipartEncoder
Add initial implementation of the user_agent function
Add the SSLAdapter

Release files for requests-toolbelt 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for requests-toolbelt 0.1.0
File	Size	Uploaded
requests-toolbelt-0.1.0.tar.gz	6.6 kB	Jan 18, 2014	Details

Built distribution (wheel)

Table of built distributions (wheels) for requests-toolbelt 0.1.0
File	Interpreter	ABI	Platform	Reset
requests_toolbelt-0.1.0-py2.py3-none-any.whl 9.3 kB Jan 18, 2014	Python 2, Python 3	none	any	Details

Total release size: 15.8 kB

Release files / requests-toolbelt-0.1.0.tar.gz

Download URL	requests-toolbelt-0.1.0.tar.gz
Size	6.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`da30a109ac7de56c8d8e1c4ab21db83726e66e5e2dcd5499b51436e70c6039e0`
BLAKE2b-256 checksum How to use checksums	`4b2589bb98ef07cbf6b3006c3094a6268cf483f126349192ea548f528a0e1f62`
Upload date	Jan 18, 2014
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / requests_toolbelt-0.1.0-py2.py3-none-any.whl

Download URL	requests_toolbelt-0.1.0-py2.py3-none-any.whl
Size	9.3 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`e10aa7bd0c574233e14e40227a4652beca23805cfec2b9b6a0571fb8c2c1aabc`
BLAKE2b-256 checksum How to use checksums	`9167105c0bcd07750781ce10aba6848e4e1374bea0b94ec01d4c2729694e814f`
Upload date	Jan 18, 2014
Uploaded using Trusted Publishing? What is trusted publishing?	No