METADATA 6.3 KB

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