![urllib3](https://github.com/urllib3/urllib3/raw/main/docs/_static/banner_github.svg)

urllib3 is a powerful, *user-friendly* HTTP client for Python. 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. ... and many more features, but most importantly: Our maintainers have a 15+ year track record of maintaining urllib3 with the highest code standards and attention to security and safety. [Much of the Python ecosystem already uses urllib3](https://urllib3.readthedocs.io/en/stable/#who-uses) and you should too. ## Installing urllib3 can be installed with [pip](https://pip.pypa.io): ```bash $ python -m pip install urllib3 ``` Alternatively, you can grab the latest source code from [GitHub](https://github.com/urllib3/urllib3): ```bash $ git clone https://github.com/urllib3/urllib3.git $ cd urllib3 $ pip install . ``` ## Getting Started urllib3 is easy to use: ```python3 >>> import urllib3 >>> resp = urllib3.request("GET", "http://httpbin.org/robots.txt") >>> resp.status 200 >>> resp.data b"User-agent: *\nDisallow: /deny\n" ``` urllib3 has usage and reference documentation at [urllib3.readthedocs.io](https://urllib3.readthedocs.io). ## Community urllib3 has a [community Discord channel](https://discord.gg/urllib3) for asking questions and collaborating with other contributors. Drop by and say hello 👋 ## Contributing urllib3 happily accepts contributions. Please see our [contributing documentation](https://urllib3.readthedocs.io/en/latest/contributing.html) for some tips on getting started. ## Security Disclosures To report a security vulnerability, please use the [Tidelift security contact](https://tidelift.com/security). Tidelift will coordinate the fix and disclosure with maintainers. See the repository [Security Policy](.github/SECURITY.md) for more details. ## Maintainers Meet our maintainers since 2008: - Current Lead: [@illia-v](https://github.com/illia-v) (Illia Volochii) - [@sethmlarson](https://github.com/sethmlarson) (Seth M. Larson) - [@pquentin](https://github.com/pquentin) (Quentin Pradet) - [@theacodes](https://github.com/theacodes) (Thea Flowers) - [@haikuginger](https://github.com/haikuginger) (Jess Shapiro) - [@lukasa](https://github.com/lukasa) (Cory Benfield) - [@sigmavirus24](https://github.com/sigmavirus24) (Ian Stapleton Cordasco) - [@shazow](https://github.com/shazow) (Andrey Petrov) 👋 ## Sponsorship If your company benefits from this library, please consider [sponsoring its development](https://urllib3.readthedocs.io/en/latest/sponsors.html). ## For Enterprise Professional support for urllib3 is available as part of the [Tidelift Subscription][1]. 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. [1]: https://tidelift.com/subscription/pkg/pypi-urllib3?utm_source=pypi-urllib3&utm_medium=referral&utm_campaign=readme