METADATA 6.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164
  1. Metadata-Version: 2.4
  2. Name: urllib3
  3. Version: 2.6.3
  4. Summary: HTTP library with thread-safe connection pooling, file post, and more.
  5. Project-URL: Changelog, https://github.com/urllib3/urllib3/blob/main/CHANGES.rst
  6. Project-URL: Documentation, https://urllib3.readthedocs.io
  7. Project-URL: Code, https://github.com/urllib3/urllib3
  8. Project-URL: Issue tracker, https://github.com/urllib3/urllib3/issues
  9. Author-email: Andrey Petrov <andrey.petrov@shazow.net>
  10. Maintainer-email: Seth Michael Larson <sethmichaellarson@gmail.com>, Quentin Pradet <quentin@pradet.me>, Illia Volochii <illia.volochii@gmail.com>
  11. License-Expression: MIT
  12. License-File: LICENSE.txt
  13. Keywords: filepost,http,httplib,https,pooling,ssl,threadsafe,urllib
  14. Classifier: Environment :: Web Environment
  15. Classifier: Intended Audience :: Developers
  16. Classifier: Operating System :: OS Independent
  17. Classifier: Programming Language :: Python
  18. Classifier: Programming Language :: Python :: 3
  19. Classifier: Programming Language :: Python :: 3 :: Only
  20. Classifier: Programming Language :: Python :: 3.9
  21. Classifier: Programming Language :: Python :: 3.10
  22. Classifier: Programming Language :: Python :: 3.11
  23. Classifier: Programming Language :: Python :: 3.12
  24. Classifier: Programming Language :: Python :: 3.13
  25. Classifier: Programming Language :: Python :: 3.14
  26. Classifier: Programming Language :: Python :: Free Threading :: 2 - Beta
  27. Classifier: Programming Language :: Python :: Implementation :: CPython
  28. Classifier: Programming Language :: Python :: Implementation :: PyPy
  29. Classifier: Topic :: Internet :: WWW/HTTP
  30. Classifier: Topic :: Software Development :: Libraries
  31. Requires-Python: >=3.9
  32. Provides-Extra: brotli
  33. Requires-Dist: brotli>=1.2.0; (platform_python_implementation == 'CPython') and extra == 'brotli'
  34. Requires-Dist: brotlicffi>=1.2.0.0; (platform_python_implementation != 'CPython') and extra == 'brotli'
  35. Provides-Extra: h2
  36. Requires-Dist: h2<5,>=4; extra == 'h2'
  37. Provides-Extra: socks
  38. Requires-Dist: pysocks!=1.5.7,<2.0,>=1.5.6; extra == 'socks'
  39. Provides-Extra: zstd
  40. Requires-Dist: backports-zstd>=1.0.0; (python_version < '3.14') and extra == 'zstd'
  41. Description-Content-Type: text/markdown
  42. <h1 align="center">
  43. ![urllib3](https://github.com/urllib3/urllib3/raw/main/docs/_static/banner_github.svg)
  44. </h1>
  45. <p align="center">
  46. <a href="https://pypi.org/project/urllib3"><img alt="PyPI Version" src="https://img.shields.io/pypi/v/urllib3.svg?maxAge=86400" /></a>
  47. <a href="https://pypi.org/project/urllib3"><img alt="Python Versions" src="https://img.shields.io/pypi/pyversions/urllib3.svg?maxAge=86400" /></a>
  48. <a href="https://discord.gg/urllib3"><img alt="Join our Discord" src="https://img.shields.io/discord/756342717725933608?color=%237289da&label=discord" /></a>
  49. <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>
  50. <a href="https://github.com/urllib3/urllib3/actions/workflows/ci.yml?query=branch%3Amain"><img alt="Build Status on GitHub" src="https://github.com/urllib3/urllib3/actions/workflows/ci.yml/badge.svg?branch:main&workflow:CI" /></a>
  51. <a href="https://urllib3.readthedocs.io"><img alt="Documentation Status" src="https://readthedocs.org/projects/urllib3/badge/?version=latest" /></a><br>
  52. <a href="https://deps.dev/pypi/urllib3"><img alt="OpenSSF Scorecard" src="https://api.securityscorecards.dev/projects/github.com/urllib3/urllib3/badge" /></a>
  53. <a href="https://slsa.dev"><img alt="SLSA 3" src="https://slsa.dev/images/gh-badge-level3.svg" /></a>
  54. <a href="https://bestpractices.coreinfrastructure.org/projects/6227"><img alt="CII Best Practices" src="https://bestpractices.coreinfrastructure.org/projects/6227/badge" /></a>
  55. </p>
  56. urllib3 is a powerful, *user-friendly* HTTP client for Python.
  57. urllib3 brings many critical features that are missing from the Python
  58. standard libraries:
  59. - Thread safety.
  60. - Connection pooling.
  61. - Client-side SSL/TLS verification.
  62. - File uploads with multipart encoding.
  63. - Helpers for retrying requests and dealing with HTTP redirects.
  64. - Support for gzip, deflate, brotli, and zstd encoding.
  65. - Proxy support for HTTP and SOCKS.
  66. - 100% test coverage.
  67. ... and many more features, but most importantly: Our maintainers have a 15+
  68. year track record of maintaining urllib3 with the highest code standards and
  69. attention to security and safety.
  70. [Much of the Python ecosystem already uses urllib3](https://urllib3.readthedocs.io/en/stable/#who-uses)
  71. and you should too.
  72. ## Installing
  73. urllib3 can be installed with [pip](https://pip.pypa.io):
  74. ```bash
  75. $ python -m pip install urllib3
  76. ```
  77. Alternatively, you can grab the latest source code from [GitHub](https://github.com/urllib3/urllib3):
  78. ```bash
  79. $ git clone https://github.com/urllib3/urllib3.git
  80. $ cd urllib3
  81. $ pip install .
  82. ```
  83. ## Getting Started
  84. urllib3 is easy to use:
  85. ```python3
  86. >>> import urllib3
  87. >>> resp = urllib3.request("GET", "http://httpbin.org/robots.txt")
  88. >>> resp.status
  89. 200
  90. >>> resp.data
  91. b"User-agent: *\nDisallow: /deny\n"
  92. ```
  93. urllib3 has usage and reference documentation at [urllib3.readthedocs.io](https://urllib3.readthedocs.io).
  94. ## Community
  95. urllib3 has a [community Discord channel](https://discord.gg/urllib3) for asking questions and
  96. collaborating with other contributors. Drop by and say hello 👋
  97. ## Contributing
  98. urllib3 happily accepts contributions. Please see our
  99. [contributing documentation](https://urllib3.readthedocs.io/en/latest/contributing.html)
  100. for some tips on getting started.
  101. ## Security Disclosures
  102. To report a security vulnerability, please use the
  103. [Tidelift security contact](https://tidelift.com/security).
  104. Tidelift will coordinate the fix and disclosure with maintainers.
  105. ## Maintainers
  106. Meet our maintainers since 2008:
  107. - Current Lead: [@illia-v](https://github.com/illia-v) (Illia Volochii)
  108. - [@sethmlarson](https://github.com/sethmlarson) (Seth M. Larson)
  109. - [@pquentin](https://github.com/pquentin) (Quentin Pradet)
  110. - [@theacodes](https://github.com/theacodes) (Thea Flowers)
  111. - [@haikuginger](https://github.com/haikuginger) (Jess Shapiro)
  112. - [@lukasa](https://github.com/lukasa) (Cory Benfield)
  113. - [@sigmavirus24](https://github.com/sigmavirus24) (Ian Stapleton Cordasco)
  114. - [@shazow](https://github.com/shazow) (Andrey Petrov)
  115. 👋
  116. ## Sponsorship
  117. If your company benefits from this library, please consider [sponsoring its
  118. development](https://urllib3.readthedocs.io/en/latest/sponsors.html).
  119. ## For Enterprise
  120. Professional support for urllib3 is available as part of the [Tidelift
  121. Subscription][1]. Tidelift gives software development teams a single source for
  122. purchasing and maintaining their software, with professional grade assurances
  123. from the experts who know it best, while seamlessly integrating with existing
  124. tools.
  125. [1]: https://tidelift.com/subscription/pkg/pypi-urllib3?utm_source=pypi-urllib3&utm_medium=referral&utm_campaign=readme