tree: 3a01cbb1b7f297fbedad78eefec8a10bd1a522a2 [path history] [tgz]
  1. .github/
  2. _appveyor/
  3. docs/
  4. ext/
  5. requests/
  6. tests/
  7. .coveragerc
  8. .gitignore
  9. .travis.yml
  10. appveyor.yml
  11. AUTHORS.rst
  12. HISTORY.md
  13. LICENSE
  14. Makefile
  15. MANIFEST.in
  16. Pipfile
  17. Pipfile.lock
  18. pytest.ini
  19. README.md
  20. setup.cfg
  21. setup.py
  22. tox.ini
README.md
>>> 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.

Requests is ready for the demands of building robust and reliable HTTP–speak applications, for the needs of today.

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.