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
"{"type":"User"..."
>>> r.json()
{"disk_usage": 368627, "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.
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!
✨ 🍰 ✨
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
.