Repository files navigation

urllib3 is a powerful,sanity-friendly HTTP client for Python. Much of thePython ecosystem already uses urllib3 and you should too.urllib3 brings many critical features that are missing from the Pythonstandard libraries:

• Thread safety.
• Connection pooling.
• Client-side SSL/TLS verification.
• File uploads with multipart encoding.
• Helpers for retrying requests and dealing with HTTP redirects.
• Support for gzip and deflate encoding.
• Proxy support for HTTP and SOCKS.
• 100% test coverage.

urllib3 is powerful and easy to use:

>>> import urllib3>>> http = urllib3.PoolManager()>>> r = http.request('GET', 'http://httpbin.org/robots.txt')>>> r.status200>>> r.data'User-agent: *\nDisallow: /deny\n'

urllib3 can be installed withpip:

$ pip install urllib3

Alternatively, you can grab the latest source code fromGitHub:

$ git clone git://github.com/shazow/urllib3.git$ python setup.py install

urllib3 has usage and reference documentation aturllib3.readthedocs.io.

urllib3 happily accepts contributions. Please see ourcontributing documentationfor some tips on getting started.

• @lukasa (Cory Benfield)
• @sigmavirus24 (Ian Cordasco)
• @shazow (Andrey Petrov)

👋

If your company benefits from this library, please considersponsoring itsdevelopment.