jpayne@7: Metadata-Version: 2.1
jpayne@7: Name: urllib3
jpayne@7: Version: 2.2.1
jpayne@7: Summary: HTTP library with thread-safe connection pooling, file post, and more.
jpayne@7: Project-URL: Changelog, https://github.com/urllib3/urllib3/blob/main/CHANGES.rst
jpayne@7: Project-URL: Documentation, https://urllib3.readthedocs.io
jpayne@7: Project-URL: Code, https://github.com/urllib3/urllib3
jpayne@7: Project-URL: Issue tracker, https://github.com/urllib3/urllib3/issues
jpayne@7: Author-email: Andrey Petrov <andrey.petrov@shazow.net>
jpayne@7: Maintainer-email: Seth Michael Larson <sethmichaellarson@gmail.com>, Quentin Pradet <quentin@pradet.me>, Illia Volochii <illia.volochii@gmail.com>
jpayne@7: License-File: LICENSE.txt
jpayne@7: Keywords: filepost,http,httplib,https,pooling,ssl,threadsafe,urllib
jpayne@7: Classifier: Environment :: Web Environment
jpayne@7: Classifier: Intended Audience :: Developers
jpayne@7: Classifier: License :: OSI Approved :: MIT License
jpayne@7: Classifier: Operating System :: OS Independent
jpayne@7: Classifier: Programming Language :: Python
jpayne@7: Classifier: Programming Language :: Python :: 3
jpayne@7: Classifier: Programming Language :: Python :: 3 :: Only
jpayne@7: Classifier: Programming Language :: Python :: 3.8
jpayne@7: Classifier: Programming Language :: Python :: 3.9
jpayne@7: Classifier: Programming Language :: Python :: 3.10
jpayne@7: Classifier: Programming Language :: Python :: 3.11
jpayne@7: Classifier: Programming Language :: Python :: 3.12
jpayne@7: Classifier: Programming Language :: Python :: Implementation :: CPython
jpayne@7: Classifier: Programming Language :: Python :: Implementation :: PyPy
jpayne@7: Classifier: Topic :: Internet :: WWW/HTTP
jpayne@7: Classifier: Topic :: Software Development :: Libraries
jpayne@7: Requires-Python: >=3.8
jpayne@7: Provides-Extra: brotli
jpayne@7: Requires-Dist: brotli>=1.0.9; (platform_python_implementation == 'CPython') and extra == 'brotli'
jpayne@7: Requires-Dist: brotlicffi>=0.8.0; (platform_python_implementation != 'CPython') and extra == 'brotli'
jpayne@7: Provides-Extra: h2
jpayne@7: Requires-Dist: h2<5,>=4; extra == 'h2'
jpayne@7: Provides-Extra: socks
jpayne@7: Requires-Dist: pysocks!=1.5.7,<2.0,>=1.5.6; extra == 'socks'
jpayne@7: Provides-Extra: zstd
jpayne@7: Requires-Dist: zstandard>=0.18.0; extra == 'zstd'
jpayne@7: Description-Content-Type: text/markdown
jpayne@7: 
jpayne@7: <h1 align="center">
jpayne@7: 
jpayne@7: ![urllib3](https://github.com/urllib3/urllib3/raw/main/docs/_static/banner_github.svg)
jpayne@7: 
jpayne@7: </h1>
jpayne@7: 
jpayne@7: <p align="center">
jpayne@7:   <a href="https://pypi.org/project/urllib3"><img alt="PyPI Version" src="https://img.shields.io/pypi/v/urllib3.svg?maxAge=86400" /></a>
jpayne@7:   <a href="https://pypi.org/project/urllib3"><img alt="Python Versions" src="https://img.shields.io/pypi/pyversions/urllib3.svg?maxAge=86400" /></a>
jpayne@7:   <a href="https://discord.gg/urllib3"><img alt="Join our Discord" src="https://img.shields.io/discord/756342717725933608?color=%237289da&label=discord" /></a>
jpayne@7:   <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>
jpayne@7:   <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>
jpayne@7:   <a href="https://urllib3.readthedocs.io"><img alt="Documentation Status" src="https://readthedocs.org/projects/urllib3/badge/?version=latest" /></a><br>
jpayne@7:   <a href="https://deps.dev/pypi/urllib3"><img alt="OpenSSF Scorecard" src="https://api.securityscorecards.dev/projects/github.com/urllib3/urllib3/badge" /></a>
jpayne@7:   <a href="https://slsa.dev"><img alt="SLSA 3" src="https://slsa.dev/images/gh-badge-level3.svg" /></a>
jpayne@7:   <a href="https://bestpractices.coreinfrastructure.org/projects/6227"><img alt="CII Best Practices" src="https://bestpractices.coreinfrastructure.org/projects/6227/badge" /></a>
jpayne@7: </p>
jpayne@7: 
jpayne@7: urllib3 is a powerful, *user-friendly* HTTP client for Python. Much of the
jpayne@7: Python ecosystem already uses urllib3 and you should too.
jpayne@7: urllib3 brings many critical features that are missing from the Python
jpayne@7: standard libraries:
jpayne@7: 
jpayne@7: - Thread safety.
jpayne@7: - Connection pooling.
jpayne@7: - Client-side SSL/TLS verification.
jpayne@7: - File uploads with multipart encoding.
jpayne@7: - Helpers for retrying requests and dealing with HTTP redirects.
jpayne@7: - Support for gzip, deflate, brotli, and zstd encoding.
jpayne@7: - Proxy support for HTTP and SOCKS.
jpayne@7: - 100% test coverage.
jpayne@7: 
jpayne@7: urllib3 is powerful and easy to use:
jpayne@7: 
jpayne@7: ```python3
jpayne@7: >>> import urllib3
jpayne@7: >>> resp = urllib3.request("GET", "http://httpbin.org/robots.txt")
jpayne@7: >>> resp.status
jpayne@7: 200
jpayne@7: >>> resp.data
jpayne@7: b"User-agent: *\nDisallow: /deny\n"
jpayne@7: ```
jpayne@7: 
jpayne@7: ## Installing
jpayne@7: 
jpayne@7: urllib3 can be installed with [pip](https://pip.pypa.io):
jpayne@7: 
jpayne@7: ```bash
jpayne@7: $ python -m pip install urllib3
jpayne@7: ```
jpayne@7: 
jpayne@7: Alternatively, you can grab the latest source code from [GitHub](https://github.com/urllib3/urllib3):
jpayne@7: 
jpayne@7: ```bash
jpayne@7: $ git clone https://github.com/urllib3/urllib3.git
jpayne@7: $ cd urllib3
jpayne@7: $ pip install .
jpayne@7: ```
jpayne@7: 
jpayne@7: 
jpayne@7: ## Documentation
jpayne@7: 
jpayne@7: urllib3 has usage and reference documentation at [urllib3.readthedocs.io](https://urllib3.readthedocs.io).
jpayne@7: 
jpayne@7: 
jpayne@7: ## Community
jpayne@7: 
jpayne@7: urllib3 has a [community Discord channel](https://discord.gg/urllib3) for asking questions and
jpayne@7: collaborating with other contributors. Drop by and say hello 👋
jpayne@7: 
jpayne@7: 
jpayne@7: ## Contributing
jpayne@7: 
jpayne@7: urllib3 happily accepts contributions. Please see our
jpayne@7: [contributing documentation](https://urllib3.readthedocs.io/en/latest/contributing.html)
jpayne@7: for some tips on getting started.
jpayne@7: 
jpayne@7: 
jpayne@7: ## Security Disclosures
jpayne@7: 
jpayne@7: To report a security vulnerability, please use the
jpayne@7: [Tidelift security contact](https://tidelift.com/security).
jpayne@7: Tidelift will coordinate the fix and disclosure with maintainers.
jpayne@7: 
jpayne@7: 
jpayne@7: ## Maintainers
jpayne@7: 
jpayne@7: - [@sethmlarson](https://github.com/sethmlarson) (Seth M. Larson)
jpayne@7: - [@pquentin](https://github.com/pquentin) (Quentin Pradet)
jpayne@7: - [@illia-v](https://github.com/illia-v) (Illia Volochii)
jpayne@7: - [@theacodes](https://github.com/theacodes) (Thea Flowers)
jpayne@7: - [@haikuginger](https://github.com/haikuginger) (Jess Shapiro)
jpayne@7: - [@lukasa](https://github.com/lukasa) (Cory Benfield)
jpayne@7: - [@sigmavirus24](https://github.com/sigmavirus24) (Ian Stapleton Cordasco)
jpayne@7: - [@shazow](https://github.com/shazow) (Andrey Petrov)
jpayne@7: 
jpayne@7: 👋
jpayne@7: 
jpayne@7: 
jpayne@7: ## Sponsorship
jpayne@7: 
jpayne@7: If your company benefits from this library, please consider [sponsoring its
jpayne@7: development](https://urllib3.readthedocs.io/en/latest/sponsors.html).
jpayne@7: 
jpayne@7: 
jpayne@7: ## For Enterprise
jpayne@7: 
jpayne@7: Professional support for urllib3 is available as part of the [Tidelift
jpayne@7: Subscription][1].  Tidelift gives software development teams a single source for
jpayne@7: purchasing and maintaining their software, with professional grade assurances
jpayne@7: from the experts who know it best, while seamlessly integrating with existing
jpayne@7: tools.
jpayne@7: 
jpayne@7: [1]: https://tidelift.com/subscription/pkg/pypi-urllib3?utm_source=pypi-urllib3&utm_medium=referral&utm_campaign=readme