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

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 Update disclosure contact info (#5369) Feb 27, 2020
ext The Principle of Polarity Sep 23, 2019
requests Normalize exception docstrings (#5338) Feb 23, 2020
tests Revert "Fix for response with UTF-8 BOM #4976" Feb 19, 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 v2.23.0 Feb 19, 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 updating pipfile.lock for bleach security issue (#5364) Feb 27, 2020
README.md Update link to pipenv in README. Feb 17, 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
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.5+.


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


 

 

You can’t perform that action at this time.