Skip to content
A simple, yet elegant HTTP library.
Python PowerShell Makefile
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update FUNDING.yml Sep 18, 2019
_appveyor revert azure pipeline changes Dec 10, 2018
docs Change documentation website to requests.readthedocs.io (#5236) Oct 25, 2019
ext The Principle of Polarity Sep 23, 2019
requests Change documentation website to requests.readthedocs.io (#5236) Oct 25, 2019
tests Merge branch 'master' into feature/strip-utf8-bom Aug 20, 2019
.coveragerc omit coverage packages Jan 17, 2017
.gitignore Merge branch 'master' into feature/strip-utf8-bom Aug 20, 2019
.travis.yml Test on Python 3.8 final Oct 22, 2019
AUTHORS.rst AUTHORS.rst Sep 23, 2019
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md May 27, 2017
CONTRIBUTING.md Change documentation website to requests.readthedocs.io (#5236) Oct 25, 2019
HISTORY.md Change documentation website to requests.readthedocs.io (#5236) Oct 25, 2019
LICENSE Update LICENSE Sep 18, 2019
MANIFEST.in Update MANIFEST.in Sep 17, 2018
Makefile Force pipenv to use the lockfile Jan 19, 2019
Pipfile resolve more-itertools py2.7 issues Sep 19, 2019
Pipfile.lock resolve more-itertools py2.7 issues Sep 19, 2019
README.md Change documentation website to requests.readthedocs.io (#5236) Oct 25, 2019
SECURITY.md Create SECURITY.md Sep 18, 2019
appveyor.yml revert azure pipeline changes Dec 10, 2018
pytest.ini [add] add NORMALIZE_WHITESPACE and ELLIPSIS to pytest.ini and remove … May 19, 2019
setup.cfg Include license file in the generated wheel package Oct 21, 2017
setup.py Change documentation website to requests.readthedocs.io (#5236) Oct 25, 2019
tox.ini Test on Python 3.8 beta Sep 26, 2019

README.md

    
    
    

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. Handcrafted, with ♥, for the Python community.'

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.

 

Downloads image image

 

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.4–3.8.


P.S. — Documentation is Available at //requests.readthedocs.io.


 

 

You can’t perform that action at this time.