# requests toolbelt

This is a collection of utilities that some users of python-requests might need but do not belong in requests proper. The library is actively maintained by members of the requests core development team, and so reflects the functionality most requested by users of the requests library.

To get an overview of what the library contains, consult the user documentation.

## Overview

- The Requests Toolbelt
- Contributing to this project

## Full Documentation

- Transport Adapters
  - FingerprintAdapter
  - SSLAdapter
  - HostHeaderSSLAdapter
  - SourceAddressAdapter
  - SocketOptionsAdapter
  - TCPKeepAliveAdapter
  - X509Adapter
- Authentication
  - AuthHandler
  - GuessAuth
  - GuessProxyAuth
  - HTTPProxyDigestAuth
- Deprecated Requests Utilities
  - `find_charset()`
  - `find_pragma()`
  - `find_xml()`
  - `get_encodings_from_content()`
  - `get_unicode_from_response()`
- Utilities for Downloading Streaming Responses
  - `stream_response_to_file()`
  - `tee()`
  - `tee_to_bytearray()`
  - `tee_to_file()`
- Utilities for Dumping Information About Responses
  - `dump_all()`
  - `dump_response()`
- Utilities for Enhanced Form-Data Serialization
  - `urlencode()`
- Custom Toolbelt Exceptions
  - `RequestsVersionTooOld`
  - `StreamingError`
  - `VersionMismatchError`
- Specialized Sessions
  - `BaseUrlSession`
  - BaseUrlSession
- Using requests with Threading
  - API and Module Auto-Generated Documentation
- Uploading Data
  - Streaming Multipart Data Encoder
  - Monitoring Your Streaming Multipart Upload
  - Streaming Data from a Generator
- User-Agent Constructor
  - Adding Extra Information to Your User-Agent String
  - Selecting Only What You Want

# Indices and tables

- Index

- Module Index

- Search Page