Skip to main content

A utility belt for advanced users of python-requests

Project description

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

requests-toolbelt-0.1.0.tar.gz (6.6 kB view details)

Uploaded Source

Built Distribution

requests_toolbelt-0.1.0-py2.py3-none-any.whl (9.3 kB view details)

Uploaded Python 2Python 3

File details

Details for the file requests-toolbelt-0.1.0.tar.gz.

File metadata

File hashes

Hashes for requests-toolbelt-0.1.0.tar.gz
Algorithm Hash digest
SHA256 da30a109ac7de56c8d8e1c4ab21db83726e66e5e2dcd5499b51436e70c6039e0
MD5 9882ca071ba3700a494a3fe807fac6ce
BLAKE2b-256 4b2589bb98ef07cbf6b3006c3094a6268cf483f126349192ea548f528a0e1f62

See more details on using hashes here.

File details

Details for the file requests_toolbelt-0.1.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for requests_toolbelt-0.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 e10aa7bd0c574233e14e40227a4652beca23805cfec2b9b6a0571fb8c2c1aabc
MD5 629d83ac4700da332a6c121c8c916a3e
BLAKE2b-256 9167105c0bcd07750781ce10aba6848e4e1374bea0b94ec01d4c2729694e814f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page