Skip to content
A simple, yet elegant HTTP library.
Python PowerShell Makefile
Branch: master
Clone or download

Latest commit

graingert fix raise_for_status docstring (#5293)
the exception isn't stored it's created new each call
Latest commit 9ed5db8 May 9, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Also update GitHub's Security Disclosure document (#5370) Feb 28, 2020
_appveyor revert azure pipeline changes Dec 10, 2018
docs fixing rst markup Apr 3, 2020
ext The Principle of Polarity Sep 23, 2019
requests fix raise_for_status docstring (#5293) May 9, 2020
tests Fix test_conflicting_post_params to work on pytest 5 (#5305) May 9, 2020
.coveragerc omit coverage packages Jan 17, 2017
.gitignore Merge branch 'master' into feature/strip-utf8-bom Aug 20, 2019
.travis.yml Add PyPy3 to Travis test suite (#5193) Jan 21, 2020
AUTHORS.rst changing of the guard Feb 27, 2020
HISTORY.md Add changelog entry for pyOpenSSL change May 1, 2020
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 update bleach security vulnerability Apr 3, 2020
README.md fix README typo Apr 3, 2020
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 Limit dependencies to major instead of minor (#5342) Feb 18, 2020
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.'

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.

 

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.5+.


P.S. — Documentation is available at requests.readthedocs.io.


 

 

You can’t perform that action at this time.