Requests: HTTP for Humans™¶
Release v2.32.3. (Installation)
Requests is an elegant and simple HTTP library for Python, built for human beings.
Behold, the power of Requests:
>>>r=requests.get('https://api.github.com/user',auth=('user','pass'))>>>r.status_code200>>>r.headers['content-type']'application/json; charset=utf8'>>>r.encoding'utf-8'>>>r.text'{"type":"User"...'>>>r.json(){'private_gists': 419, 'total_private_repos': 77, ...}
Seesimilar code, sans Requests.
Requests allows you to send HTTP/1.1 requests extremely easily.There’s no need to manually add query strings to yourURLs, or to form-encode your POST data. Keep-alive and HTTP connection poolingare 100% automatic, thanks tourllib3.
Beloved Features¶
Requests is ready for today’s web.
Keep-Alive & Connection Pooling
International Domains and URLs
Sessions with Cookie Persistence
Browser-style SSL Verification
Automatic Content Decoding
Basic/Digest Authentication
Elegant Key/Value Cookies
Automatic Decompression
Unicode Response Bodies
HTTP(S) Proxy Support
Multipart File Uploads
Streaming Downloads
Connection Timeouts
Chunked Requests
.netrcSupport
Requests officially supports Python 3.8+, and runs great on PyPy.
The User Guide¶
This part of the documentation, which is mostly prose, begins with somebackground information about Requests, then focuses on step-by-stepinstructions for getting the most out of Requests.
- Installation of Requests
- Quickstart
- Advanced Usage
- Session Objects
- Request and Response Objects
- Prepared Requests
- SSL Cert Verification
- Client Side Certificates
- CA Certificates
- Body Content Workflow
- Keep-Alive
- Streaming Uploads
- Chunk-Encoded Requests
- POST Multiple Multipart-Encoded Files
- Event Hooks
- Custom Authentication
- Streaming Requests
- Proxies
- Compliance
- HTTP Verbs
- Custom Verbs
- Link Headers
- Transport Adapters
- Blocking Or Non-Blocking?
- Header Ordering
- Timeouts
- Authentication
The Community Guide¶
This part of the documentation, which is mostly prose, details theRequests ecosystem and community.
The API Documentation / Guide¶
If you are looking for information on a specific function, class, or method,this part of the documentation is for you.
The Contributor Guide¶
If you want to contribute to the project, this part of the documentation is foryou.
There are no more guides. You are now guideless.Good luck.
