| Metadata-Version: 2.1 |
| Name: urllib3 |
| Version: 2.1.0 |
| Summary: HTTP library with thread-safe connection pooling, file post, and more. |
| Project-URL: Changelog, https://github.com/urllib3/urllib3/blob/main/CHANGES.rst |
| Project-URL: Documentation, https://urllib3.readthedocs.io |
| Project-URL: Code, https://github.com/urllib3/urllib3 |
| Project-URL: Issue tracker, https://github.com/urllib3/urllib3/issues |
| Author-email: Andrey Petrov <andrey.petrov@shazow.net> |
| Maintainer-email: Seth Michael Larson <sethmichaellarson@gmail.com>, Quentin Pradet <quentin@pradet.me>, Illia Volochii <illia.volochii@gmail.com> |
| License-File: LICENSE.txt |
| Keywords: filepost,http,httplib,https,pooling,ssl,threadsafe,urllib |
| Classifier: Environment :: Web Environment |
| Classifier: Intended Audience :: Developers |
| Classifier: License :: OSI Approved :: MIT License |
| Classifier: Operating System :: OS Independent |
| Classifier: Programming Language :: Python |
| Classifier: Programming Language :: Python :: 3 |
| Classifier: Programming Language :: Python :: 3 :: Only |
| Classifier: Programming Language :: Python :: 3.8 |
| Classifier: Programming Language :: Python :: 3.9 |
| Classifier: Programming Language :: Python :: 3.10 |
| Classifier: Programming Language :: Python :: 3.11 |
| Classifier: Programming Language :: Python :: 3.12 |
| Classifier: Programming Language :: Python :: Implementation :: CPython |
| Classifier: Programming Language :: Python :: Implementation :: PyPy |
| Classifier: Topic :: Internet :: WWW/HTTP |
| Classifier: Topic :: Software Development :: Libraries |
| Requires-Python: >=3.8 |
| Provides-Extra: brotli |
| Requires-Dist: brotli>=1.0.9; platform_python_implementation == 'CPython' and extra == 'brotli' |
| Requires-Dist: brotlicffi>=0.8.0; platform_python_implementation != 'CPython' and extra == 'brotli' |
| Provides-Extra: socks |
| Requires-Dist: pysocks!=1.5.7,<2.0,>=1.5.6; extra == 'socks' |
| Provides-Extra: zstd |
| Requires-Dist: zstandard>=0.18.0; extra == 'zstd' |
| Description-Content-Type: text/markdown |
|
|
| <h1 align="center"> |
|
|
|  |
|
|
| </h1> |
|
|
| <p align="center"> |
| <a href="https://pypi.org/project/urllib3"><img alt="PyPI Version" src="https://img.shields.io/pypi/v/urllib3.svg?maxAge=86400" /></a> |
| <a href="https://pypi.org/project/urllib3"><img alt="Python Versions" src="https://img.shields.io/pypi/pyversions/urllib3.svg?maxAge=86400" /></a> |
| <a href="https://discord.gg/urllib3"><img alt="Join our Discord" src="https://img.shields.io/discord/756342717725933608?color=%237289da&label=discord" /></a> |
| <a href="https://github.com/urllib3/urllib3/actions?query=workflow%3ACI"><img alt="Coverage Status" src="https://img.shields.io/badge/coverage-100%25-success" /></a> |
| <a href="https://github.com/urllib3/urllib3/actions?query=workflow%3ACI"><img alt="Build Status on GitHub" src="https://github.com/urllib3/urllib3/workflows/CI/badge.svg" /></a> |
| <a href="https://urllib3.readthedocs.io"><img alt="Documentation Status" src="https://readthedocs.org/projects/urllib3/badge/?version=latest" /></a><br> |
| <a href="https://deps.dev/pypi/urllib3"><img alt="OpenSSF Scorecard" src="https://api.securityscorecards.dev/projects/github.com/urllib3/urllib3/badge" /></a> |
| <a href="https://slsa.dev"><img alt="SLSA 3" src="https://slsa.dev/images/gh-badge-level3.svg" /></a> |
| <a href="https://bestpractices.coreinfrastructure.org/projects/6227"><img alt="CII Best Practices" src="https://bestpractices.coreinfrastructure.org/projects/6227/badge" /></a> |
| </p> |
|
|
| 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: |
|
|
| ```python3 |
| >>> import urllib3 |
| >>> resp = urllib3.request("GET", "http://httpbin.org/robots.txt") |
| >>> resp.status |
| 200 |
| >>> resp.data |
| b"User-agent: *\nDisallow: /deny\n" |
| ``` |
|
|
| |
|
|
| 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 . |
| ``` |
|
|
|
|
| |
|
|
| urllib3 has usage and reference documentation at [urllib3.readthedocs.io](https://urllib3.readthedocs.io). |
|
|
|
|
| |
|
|
| urllib3 has a [community Discord channel](https://discord.gg/urllib3) for asking questions and |
| collaborating with other contributors. Drop by and say hello 👋 |
|
|
|
|
| |
|
|
| urllib3 happily accepts contributions. Please see our |
| [contributing documentation](https://urllib3.readthedocs.io/en/latest/contributing.html) |
| for some tips on getting started. |
|
|
|
|
| |
|
|
| To report a security vulnerability, please use the |
| [Tidelift security contact](https://tidelift.com/security). |
| Tidelift will coordinate the fix and disclosure with maintainers. |
|
|
|
|
| |
|
|
| - [@sethmlarson](https://github.com/sethmlarson) (Seth M. Larson) |
| - [@pquentin](https://github.com/pquentin) (Quentin Pradet) |
| - [@illia-v](https://github.com/illia-v) (Illia Volochii) |
| - [@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) |
|
|
| 👋 |
|
|
|
|
| |
|
|
| If your company benefits from this library, please consider [sponsoring its |
| development](https://urllib3.readthedocs.io/en/latest/sponsors.html). |
|
|
|
|
| |
|
|
| 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 |
|
|