Skip to content
Working repository for adding async support to urllib3
Branch: bleach-spike
Clone or download
Pull request Compare This branch is 571 commits ahead, 63 commits behind urllib3:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
_appveyor
_travis
demo
docs
dummyserver
src/urllib3
test
.coveragerc
.gitignore
.travis.yml
CHANGES.rst
CONTRIBUTORS.txt
LICENSE.txt
MANIFEST.in
Makefile
README.rst
appveyor.yml
cleancov.py
codecov.yml
dev-requirements.txt
notes.org
pyproject.toml
release.sh
setup.cfg
setup.py
tox.ini

README.rst

urllib3

Build status on Travis Build status on AppVeyor Documentation Status Coverage Status PyPI version Gitter Tidelift Dependencies

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:

Currently not supporting SOCKS proxies, pyOpenSSL and SecureTransport.

  • 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.

Security Disclosures

To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure with maintainers.

Maintainers

👋

Sponsorship

Tidelift Professional support for urllib3 is available as part of the Tidelift Subscription. Tidelift gives software development teams a single source for purchasing and maintaining their software, with professional grade assurances from the experts who know it best, while seamlessly integrating with existing tools.

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 @sethmlarson'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
You can’t perform that action at this time.