METADATA 6.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156
  1. Metadata-Version: 2.4
  2. Name: urllib3
  3. Version: 2.6.2
  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. Much of the
  57. Python ecosystem already uses urllib3 and you should too.
  58. urllib3 brings many critical features that are missing from the Python
  59. standard libraries:
  60. - Thread safety.
  61. - Connection pooling.
  62. - Client-side SSL/TLS verification.
  63. - File uploads with multipart encoding.
  64. - Helpers for retrying requests and dealing with HTTP redirects.
  65. - Support for gzip, deflate, brotli, and zstd encoding.
  66. - Proxy support for HTTP and SOCKS.
  67. - 100% test coverage.
  68. urllib3 is powerful and easy to use:
  69. ```python3
  70. >>> import urllib3
  71. >>> resp = urllib3.request("GET", "http://httpbin.org/robots.txt")
  72. >>> resp.status
  73. 200
  74. >>> resp.data
  75. b"User-agent: *\nDisallow: /deny\n"
  76. ```
  77. ## Installing
  78. urllib3 can be installed with [pip](https://pip.pypa.io):
  79. ```bash
  80. $ python -m pip install urllib3
  81. ```
  82. Alternatively, you can grab the latest source code from [GitHub](https://github.com/urllib3/urllib3):
  83. ```bash
  84. $ git clone https://github.com/urllib3/urllib3.git
  85. $ cd urllib3
  86. $ pip install .
  87. ```
  88. ## Documentation
  89. urllib3 has usage and reference documentation at [urllib3.readthedocs.io](https://urllib3.readthedocs.io).
  90. ## Community
  91. urllib3 has a [community Discord channel](https://discord.gg/urllib3) for asking questions and
  92. collaborating with other contributors. Drop by and say hello 👋
  93. ## Contributing
  94. urllib3 happily accepts contributions. Please see our
  95. [contributing documentation](https://urllib3.readthedocs.io/en/latest/contributing.html)
  96. for some tips on getting started.
  97. ## Security Disclosures
  98. To report a security vulnerability, please use the
  99. [Tidelift security contact](https://tidelift.com/security).
  100. Tidelift will coordinate the fix and disclosure with maintainers.
  101. ## Maintainers
  102. - Lead: [@illia-v](https://github.com/illia-v) (Illia Volochii)
  103. - [@sethmlarson](https://github.com/sethmlarson) (Seth M. Larson)
  104. - [@pquentin](https://github.com/pquentin) (Quentin Pradet)
  105. - [@theacodes](https://github.com/theacodes) (Thea Flowers)
  106. - [@haikuginger](https://github.com/haikuginger) (Jess Shapiro)
  107. - [@lukasa](https://github.com/lukasa) (Cory Benfield)
  108. - [@sigmavirus24](https://github.com/sigmavirus24) (Ian Stapleton Cordasco)
  109. - [@shazow](https://github.com/shazow) (Andrey Petrov)
  110. 👋
  111. ## Sponsorship
  112. If your company benefits from this library, please consider [sponsoring its
  113. development](https://urllib3.readthedocs.io/en/latest/sponsors.html).
  114. ## For Enterprise
  115. Professional support for urllib3 is available as part of the [Tidelift
  116. Subscription][1]. Tidelift gives software development teams a single source for
  117. purchasing and maintaining their software, with professional grade assurances
  118. from the experts who know it best, while seamlessly integrating with existing
  119. tools.
  120. [1]: https://tidelift.com/subscription/pkg/pypi-urllib3?utm_source=pypi-urllib3&utm_medium=referral&utm_campaign=readme