Python 3.7.4 (default, Sep 7 2019, 18:27:02)
>>> import requests
>>> r = requests.get('https://api.github.com/repos/psf/requests')
>>> r.json()["description"]
'A simple, yet elegant HTTP library.'
This software has been designed for you, with much joy, by Kenneth Reitz & is protected by The Python Software Foundation.
Requests is an elegant and simple HTTP library for Python, built with ♥.
>>> import requests
>>> r = requests.get('https://api.github.com/user', auth=('user', 'pass'))
>>> r.status_code
200
>>> r.headers['content-type']
'application/json; charset=utf8'
>>> r.encoding
'utf-8'
>>> r.text
u'{"type":"User"...'
>>> r.json()
{u'disk_usage': 368627, u'private_gists': 484, ...}
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!
Requests is the most downloaded Python package today, pulling in around 14M downloads / week
— according to GitHub, Requests is currently depended upon by 367_296
repositories. You may certainly put your trust in this code.
Supported Features & Best–Practices
Requests is ready for the demands of building robust and reliable HTTP–speak applications, for the needs of today.
+ 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* + Multi-part File Uploads + SOCKS Proxy Support + Connection Timeouts + Streaming Downloads + Automatic honoring of `.netrc` + Chunked HTTP Requests &, of course, rock–solid stability!
✨ 🍰 ✨
Requests Module Installation
The recommended way to intall the requests
module is to simply use pipenv
(or pip
, of
course):
$ pipenv install requests
Adding requests to Pipfile's [packages]…
✔ Installation Succeeded
…
Requests officially supports Python 2.7 & 3.5+.
P.S. — Documentation is Available at //requests.readthedocs.io
.