| 1 |
Metadata-Version: 2.1 |
| 2 |
Name: requests |
| 3 |
Version: 2.32.3 |
| 4 |
Summary: Python HTTP for Humans. |
| 5 |
Home-page: https://requests.readthedocs.io |
| 6 |
Author: Kenneth Reitz |
| 7 |
Author-email: [email protected] |
| 8 |
License: Apache-2.0 |
| 9 |
Project-URL: Documentation, https://requests.readthedocs.io |
| 10 |
Project-URL: Source, https://github.com/psf/requests |
| 11 |
Classifier: Development Status :: 5 - Production/Stable |
| 12 |
Classifier: Environment :: Web Environment |
| 13 |
Classifier: Intended Audience :: Developers |
| 14 |
Classifier: License :: OSI Approved :: Apache Software License |
| 15 |
Classifier: Natural Language :: English |
| 16 |
Classifier: Operating System :: OS Independent |
| 17 |
Classifier: Programming Language :: Python |
| 18 |
Classifier: Programming Language :: Python :: 3 |
| 19 |
Classifier: Programming Language :: Python :: 3.8 |
| 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 :: Only |
| 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.8 |
| 30 |
Description-Content-Type: text/markdown |
| 31 |
License-File: LICENSE |
| 32 |
Requires-Dist: charset-normalizer <4,>=2 |
| 33 |
Requires-Dist: idna <4,>=2.5 |
| 34 |
Requires-Dist: urllib3 <3,>=1.21.1 |
| 35 |
Requires-Dist: certifi >=2017.4.17 |
| 36 |
Provides-Extra: security |
| 37 |
Provides-Extra: socks |
| 38 |
Requires-Dist: PySocks !=1.5.7,>=1.5.6 ; extra == 'socks' |
| 39 |
Provides-Extra: use_chardet_on_py3 |
| 40 |
Requires-Dist: chardet <6,>=3.0.2 ; extra == 'use_chardet_on_py3' |
| 41 |
|
| 42 |
# Requests |
| 43 |
|
| 44 |
**Requests** is a simple, yet elegant, HTTP library. |
| 45 |
|
| 46 |
```python |
| 47 |
>>> import requests |
| 48 |
>>> r = requests.get('https://httpbin.org/basic-auth/user/pass', auth=('user', 'pass')) |
| 49 |
>>> r.status_code |
| 50 |
200 |
| 51 |
>>> r.headers['content-type'] |
| 52 |
'application/json; charset=utf8' |
| 53 |
>>> r.encoding |
| 54 |
'utf-8' |
| 55 |
>>> r.text |
| 56 |
'{"authenticated": true, ...' |
| 57 |
>>> r.json() |
| 58 |
{'authenticated': True, ...} |
| 59 |
``` |
| 60 |
|
| 61 |
Requests allows you to send HTTP/1.1 requests extremely easily. There’s no need to manually add query strings to your URLs, or to form-encode your `PUT` & `POST` data — but nowadays, just use the `json` method! |
| 62 |
|
| 63 |
Requests is one of the most downloaded Python packages today, pulling in around `30M downloads / week`— according to GitHub, Requests is currently [depended upon](https://github.com/psf/requests/network/dependents?package_id=UGFja2FnZS01NzA4OTExNg%3D%3D) by `1,000,000+` repositories. You may certainly put your trust in this code. |
| 64 |
|
| 65 |
[](https://pepy.tech/project/requests) |
| 66 |
[](https://pypi.org/project/requests) |
| 67 |
[](https://github.com/psf/requests/graphs/contributors) |
| 68 |
|
| 69 |
## Installing Requests and Supported Versions |
| 70 |
|
| 71 |
Requests is available on PyPI: |
| 72 |
|
| 73 |
```console |
| 74 |
$ python -m pip install requests |
| 75 |
``` |
| 76 |
|
| 77 |
Requests officially supports Python 3.8+. |
| 78 |
|
| 79 |
## Supported Features & Best–Practices |
| 80 |
|
| 81 |
Requests is ready for the demands of building robust and reliable HTTP–speaking applications, for the needs of today. |
| 82 |
|
| 83 |
- Keep-Alive & Connection Pooling |
| 84 |
- International Domains and URLs |
| 85 |
- Sessions with Cookie Persistence |
| 86 |
- Browser-style TLS/SSL Verification |
| 87 |
- Basic & Digest Authentication |
| 88 |
- Familiar `dict`–like Cookies |
| 89 |
- Automatic Content Decompression and Decoding |
| 90 |
- Multi-part File Uploads |
| 91 |
- SOCKS Proxy Support |
| 92 |
- Connection Timeouts |
| 93 |
- Streaming Downloads |
| 94 |
- Automatic honoring of `.netrc` |
| 95 |
- Chunked HTTP Requests |
| 96 |
|
| 97 |
## API Reference and User Guide available on [Read the Docs](https://requests.readthedocs.io) |
| 98 |
|
| 99 |
[](https://requests.readthedocs.io) |
| 100 |
|
| 101 |
## Cloning the repository |
| 102 |
|
| 103 |
When cloning the Requests repository, you may need to add the `-c |
| 104 |
fetch.fsck.badTimezone=ignore` flag to avoid an error about a bad commit (see |
| 105 |
[this issue](https://github.com/psf/requests/issues/2690) for more background): |
| 106 |
|
| 107 |
```shell |
| 108 |
git clone -c fetch.fsck.badTimezone=ignore https://github.com/psf/requests.git |
| 109 |
``` |
| 110 |
|
| 111 |
You can also apply this setting to your global Git config: |
| 112 |
|
| 113 |
```shell |
| 114 |
git config --global fetch.fsck.badTimezone ignore |
| 115 |
``` |
| 116 |
|
| 117 |
--- |
| 118 |
|
| 119 |
[](https://kennethreitz.org) [](https://www.python.org/psf) |