mirror of
https://github.com/kennethreitz/requests.git
synced 2026-06-05 14:50:16 +00:00
Merge branch 'master' of github.com:psf/requests
This commit is contained in:
@@ -3,7 +3,7 @@
|
||||
<span align="center">
|
||||
|
||||
<pre>
|
||||
<img src="https://github.com/psf/requests/blob/master/ext/requests-logo.png?raw=true" align="center" />
|
||||
<img src="https://raw.githubusercontent.com/psf/requests/master/ext/requests-logo.png" align="center" />
|
||||
<div align="left">
|
||||
<p></p>
|
||||
<code> Python 3.7.4 (default, Sep 7 2019, 18:27:02)</code>
|
||||
@@ -16,29 +16,19 @@
|
||||
<img src="https://github.com/psf/requests/blob/master/ext/flower-of-life.jpg?raw=true" />
|
||||
|
||||
<p align="center">
|
||||
This project has been brought to you, with much joy,
|
||||
by <a href="https://kennethreitz.org/">Kenneth Reitz</a> & The <a href="https://www.python.org/psf/">Python Software Foundation</a>.
|
||||
</p>
|
||||
<img src="https://github.com/psf/requests/blob/master/ext/flourish.png?raw=true" />
|
||||
</pre>
|
||||
|
||||
<p></p>
|
||||
This software has been designed for you, with much joy,
|
||||
by <a href="https://kennethreitz.org/">Kenneth Reitz</a> & is secured by The <a href="https://www.python.org/psf/">Python Software Foundation</a>.
|
||||
</p>
|
||||
</pre>
|
||||
|
||||
</span>
|
||||
|
||||
---------------------
|
||||
|
||||
|
||||
**Requests** is an elegant and simple HTTP library for Python, built for human beings.
|
||||
<p align="center"><strong>Requests</strong> is an elegant and simple HTTP library for Python, built with ♥</p>
|
||||
|
||||
[](https://pepy.tech/project/requests)
|
||||
[](https://pypi.org/project/requests/)
|
||||
[](https://github.com/psf/requests/graphs/contributors)
|
||||
|
||||
|
||||
Behold, the power of Requests:
|
||||
|
||||
``` {.sourceCode .python}
|
||||
```pycon
|
||||
>>> import requests
|
||||
>>> r = requests.get('https://api.github.com/user', auth=('user', 'pass'))
|
||||
>>> r.status_code
|
||||
@@ -53,55 +43,50 @@ u'{"type":"User"...'
|
||||
{u'disk_usage': 368627, u'private_gists': 484, ...}
|
||||
```
|
||||
|
||||
See [the similar code, sans Requests](https://gist.github.com/973705).
|
||||
<p align="center"><a href="https://pepy.tech/project/requests" rel="nofollow"><img src="https://camo.githubusercontent.com/e1dedc9f5ce5cd6b6c699f33d2e812daadcf3645/68747470733a2f2f706570792e746563682f62616467652f7265717565737473" alt="Downloads" data-canonical-src="https://pepy.tech/badge/requests" style="max-width:100%;"></a>
|
||||
<a href="https://pypi.org/project/requests/" rel="nofollow"><img src="https://camo.githubusercontent.com/6d78aeec0a9a1cfe147ad064bfb99069e298e29b/68747470733a2f2f696d672e736869656c64732e696f2f707970692f707976657273696f6e732f72657175657374732e737667" alt="image" data-canonical-src="https://img.shields.io/pypi/pyversions/requests.svg" style="max-width:100%;"></a>
|
||||
<a href="https://github.com/psf/requests/graphs/contributors"><img src="https://camo.githubusercontent.com/a70ea15870b38bba9203b969f6a6b7e7845fbb8a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6e7472696275746f72732f7073662f72657175657374732e737667" alt="image" data-canonical-src="https://img.shields.io/github/contributors/psf/requests.svg" style="max-width:100%;"></a></p>
|
||||
|
||||
[![image]()](http://docs.python-requests.org/)
|
||||
---------------------------------------------------------------------
|
||||
|
||||
Requests allows you to send *organic, grass-fed* HTTP/1.1 requests,
|
||||
without the need for manual labor. There's no need to manually add query
|
||||
strings to your URLs, or to form-encode your POST data. Keep-alive and
|
||||
HTTP connection pooling are 100% automatic, thanks to
|
||||
[urllib3](https://github.com/shazow/urllib3).
|
||||
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!
|
||||
|
||||
Besides, all the cool kids are doing it. Requests is one of the most
|
||||
downloaded Python packages of all time, pulling about 60,000,000
|
||||
downloads every month. You don't want to be left out!
|
||||
Requests is one of the most downloaded Python packages of all time, pulling in around `14M downloads / week`— according to GitHub, Requests is currently [depended upon](https://github.com/psf/requests/network/dependents?package_id=UGFja2FnZS01NzA4OTExNg%3D%3D) by `367_296` repositories. You can trust this code.
|
||||
|
||||
Feature Support
|
||||
---------------
|
||||
<h2 align="center">Supported Features & Best–Practices</h2>
|
||||
|
||||
Requests is ready for today's web.
|
||||
Requests is ready for the demands of building robust and reliable HTTP–speaking applications, on today's web (or your own infrastructure).
|
||||
|
||||
- International Domains and URLs
|
||||
- Keep-Alive & Connection Pooling
|
||||
- Sessions with Cookie Persistence
|
||||
- Browser-style SSL Verification
|
||||
- Basic/Digest Authentication
|
||||
- Elegant Key/Value Cookies
|
||||
- Automatic Decompression
|
||||
- Automatic Content Decoding
|
||||
- Unicode Response Bodies
|
||||
- Multipart File Uploads
|
||||
- HTTP(S) Proxy Support
|
||||
- Connection Timeouts
|
||||
- Streaming Downloads
|
||||
- `.netrc` Support
|
||||
- Chunked Requests
|
||||
|
||||
Requests officially supports Python 2.7 & 3.4–3.8, and runs great on
|
||||
PyPy.
|
||||
<pre class="test">
|
||||
+ International Domains and URLs + Keep-Alive & Connection Pooling
|
||||
+ Sessions with Cookie Persistence + Browser-style SSL Verification
|
||||
+ Basic & Digest Authentication + Familiar `dict`–like Cookies
|
||||
+ Automatic Decompression of Content + Automatic Content Decoding
|
||||
+ Automatic Connection Pooling + Unicode Response Bodies<super>*</super>
|
||||
+ Multi-part File Uploads + SOCKS Proxy Support
|
||||
+ Connection Timeouts + Streaming Downloads
|
||||
+ Automatic honoring of `.netrc` + Chunked HTTP Requests
|
||||
|
||||
&, of course, rock–solid stability!
|
||||
</pre>
|
||||
</div>
|
||||
|
||||
Installation
|
||||
------------
|
||||
|
||||
To install Requests, simply use [pipenv](http://pipenv.org/) (or pip, of
|
||||
To install **Requests**, simply use [**pipenv**](http://pipenv.org/) (or **pip**, of
|
||||
course):
|
||||
|
||||
``` {.sourceCode .bash}
|
||||
```console
|
||||
$ pipenv install requests
|
||||
Adding requests to Pipfile's [packages]…
|
||||
✔ Installation Succeeded
|
||||
…
|
||||
```
|
||||
|
||||
Satisfaction guaranteed.
|
||||
Requests officially supports Python 2.7 & 3.4–3.8, and runs great on
|
||||
PyPy.
|
||||
|
||||
|
||||
Documentation
|
||||
-------------
|
||||
@@ -109,5 +94,10 @@ Documentation
|
||||
Fantastic documentation is available at
|
||||
<http://docs.python-requests.org/>, for a limited time only.
|
||||
|
||||
Your satisfaction is guaranteed.
|
||||
|
||||
✨ 🍰 ✨
|
||||
|
||||
<p align="center">
|
||||
<img src="https://github.com/psf/requests/blob/master/ext/flourish.png?raw=true" />
|
||||
</p>
|
||||
|
||||
Reference in New Issue
Block a user