skip to navigation
skip to content

requests-toolbelt 0.2.0

A utility belt for advanced users of python-requests

Latest Version: 0.8.0

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('', 'rb'), 'text/plain')}

r ='', 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 ='', 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('', headers=headers)


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


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
File Type Py Version Uploaded on Size
requests-toolbelt-0.2.0.tar.gz (md5) Source 2014-02-24 7KB
requests_toolbelt-0.2.0-py2.py3-none-any.whl (md5) Python Wheel 2.7 2014-02-24 9KB