Python HTTP library with thread-safe connection pooling, file post support, sanity friendly, and more.
Permalink
Failed to load latest commit information.
_appveyor Test AppVeyor Oct 23, 2016
_travis Drop support for Python 2.6 (#1429) Aug 23, 2018
docs Drop support for Python 2.6 (#1429) Aug 23, 2018
dummyserver Drop support for Python 2.6 (#1429) Aug 23, 2018
src/urllib3 Add missing key_server_hostname variable (#1449) Oct 12, 2018
test Early-out ipv6 checks when running on App Engine (#1450) Oct 5, 2018
.coveragerc Fix codecov coverage by collapsing paths in tox (#1428) Aug 20, 2018
.gitignore Reverted some changes to gitignore Jan 13, 2012
.hgignore Removed egg-info, updated hgignore. Sep 18, 2011
.hgtags Added tag 0.4.1 for changeset 38339cf1816e Jul 18, 2011
.travis.yml Drop support for Python 2.6 (#1429) Aug 23, 2018
CHANGES.rst Update changelog for 1.24 release Oct 16, 2018
CONTRIBUTORS.txt Fix for parsing Content-Type: message/* Responses without warnings (#… Sep 19, 2018
LICENSE.txt Update license year range to 2016 Jan 26, 2016
MANIFEST.in Packaging: Tweaking MANIFEST.in to add missing files. Aug 6, 2014
Makefile clarify how to setup a virtual env and run a small number of tests (#… Apr 8, 2018
README.rst Fix my name in README.rst (#1390) May 28, 2018
appveyor.yml Test against Python 3.7 on AppVeyor (#1453) Oct 11, 2018
codecov.yml Make codecov enforce 100% coverage. Oct 20, 2016
dev-requirements.txt Resolve pytest pluggy version conflict (#1457) Oct 17, 2018
release.sh Fix release script Jun 11, 2016
setup.cfg Drop support for Python 2.6 (#1429) Aug 23, 2018
setup.py Drop support for Python 2.6 (#1429) Aug 23, 2018
tox.ini Drop support for Python 2.6 (#1429) Aug 23, 2018

README.rst

urllib3

Build status on Travis Build status on AppVeyor Documentation Status Coverage Status PyPI version Bountysource Gitter

urllib3 is a powerful, sanity-friendly HTTP client for Python. Much of the Python ecosystem already uses urllib3 and you should too. urllib3 brings many critical features that are missing from the Python standard 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.status
200
>>> r.data
'User-agent: *\nDisallow: /deny\n'

Installing

urllib3 can be installed with pip:

$ pip install urllib3

Alternatively, you can grab the latest source code from GitHub:

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

Documentation

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

Contributing

urllib3 happily accepts contributions. Please see our contributing documentation for some tips on getting started.

Maintainers

👋

Sponsorship

If your company benefits from this library, please consider sponsoring its development.

Sponsors include:

  • Google Cloud Platform (2018-present), sponsors @theacodes's work on an ongoing basis
  • Abbott (2018-present), sponsors @SethMichaelLarson's work on an ongoing basis
  • Akamai (2017-present), sponsors @haikuginger's work on an ongoing basis
  • Hewlett Packard Enterprise (2016-2017), sponsored @Lukasa’s work on urllib3