METADATA 6.3 KB

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