Skip to main content

HTTP library with thread-safe connection pooling, file post, and more.

Project description

urllib3

PyPI Version Python Versions Join our Discord Coverage Status Build Status on GitHub Documentation Status
OpenSSF Scorecard SLSA 3 CII Best Practices

urllib3 is a powerful, user-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, deflate, brotli, and zstd encoding.
  • Proxy support for HTTP and SOCKS.
  • 100% test coverage.

urllib3 is powerful and easy to use:

>>> import urllib3
>>> resp = urllib3.request("GET", "http://httpbin.org/robots.txt")
>>> resp.status
200
>>> resp.data
b"User-agent: *\nDisallow: /deny\n"

Installing

urllib3 can be installed with pip:

$ python -m pip install urllib3

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

$ git clone https://github.com/urllib3/urllib3.git
$ cd urllib3
$ pip install .

Documentation

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

Community

urllib3 has a community Discord channel for asking questions and collaborating with other contributors. Drop by and say hello 👋

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

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

For Enterprise

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.

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

urllib3-2.3.0.tar.gz (307.3 kB view details)

Uploaded Source

Built Distribution

urllib3-2.3.0-py3-none-any.whl (128.4 kB view details)

Uploaded Python 3

File details

Details for the file urllib3-2.3.0.tar.gz.

File metadata

  • Download URL: urllib3-2.3.0.tar.gz
  • Upload date:
  • Size: 307.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for urllib3-2.3.0.tar.gz
Algorithm Hash digest
SHA256 f8c5449b3cf0861679ce7e0503c7b44b5ec981bec0d1d3795a07f1ba96f0204d
MD5 6388afd062cf2e1ef27843738629dbc1
BLAKE2b-256 aa63e53da845320b757bf29ef6a9062f5c669fe997973f966045cb019c3f4b66

See more details on using hashes here.

Provenance

The following attestation bundles were made for urllib3-2.3.0.tar.gz:

Publisher: publish.yml on urllib3/urllib3

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file urllib3-2.3.0-py3-none-any.whl.

File metadata

  • Download URL: urllib3-2.3.0-py3-none-any.whl
  • Upload date:
  • Size: 128.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for urllib3-2.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1cee9ad369867bfdbbb48b7dd50374c0967a0bb7710050facf0dd6911440e3df
MD5 21cc339da6ff13770c290e665a50d1a6
BLAKE2b-256 c8194ec628951a74043532ca2cf5d97b7b14863931476d117c471e8e2b1eb39f

See more details on using hashes here.

Provenance

The following attestation bundles were made for urllib3-2.3.0-py3-none-any.whl:

Publisher: publish.yml on urllib3/urllib3

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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