requests README

The project's README from github.com/psf/requests. As one markdown file: README.md.

Requests

Version Supported Versions Downloads Contributors Documentation

Requests is a simple, yet elegant, HTTP library.

>>> import requests
>>> r = requests.get('https://httpbin.org/basic-auth/user/pass', auth=('user', 'pass'))
>>> r.status_code
200
>>> r.headers['content-type']
'application/json; charset=utf8'
>>> r.encoding
'utf-8'
>>> r.text
'{"authenticated": true, ...'
>>> r.json()
{'authenticated': True, ...}

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 one of the most downloaded Python packages today, pulling in around 300M downloads / week — according to GitHub, Requests is currently depended upon by 4,000,000+ repositories.

Installing Requests and Supported Versions

Requests is available on PyPI:

$ python -m pip install requests

Requests officially supports Python 3.10+.

Supported Features & Best–Practices

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

Cloning the repository

When cloning the Requests repository, you may need to add the -c fetch.fsck.badTimezone=ignore flag to avoid an error about a bad commit timestamp (see this issue for more background):

git clone -c fetch.fsck.badTimezone=ignore https://github.com/psf/requests.git

You can also apply this setting to your global Git config:

git config --global fetch.fsck.badTimezone ignore

Kenneth Reitz Python Software Foundation

requests (psf/requests)

Searching Database…

54.5K ·GitHub
Что это такое?Это простая, но элегантная HTTP-библиотека для Python, которая позволяет отправлять HTTP/1.1-запросы максимально легко.
Это библиотека, которую я импортирую в свой код, или утилита командной строки?Библиотека: вы устанавливаете её и вызываете из собственного кода на Python; в README не описан интерфейс командной строки.
Как добавить её в проект?Установите её с PyPI командой pip install requests, а затем импортируйте в своём коде.
Какие версии Python она поддерживает?Requests официально поддерживает Python 3.10 и новее.
Она предназначена для быстрых скриптов или для надёжных продакшн-приложений?И для того, и для другого — в README сказано, что она готова к нагрузкам при построении надёжных приложений, работающих по HTTP.
Что она делает за меня помимо базового запроса?Keep-alive и пулинг соединений, сессии с сохранением cookie, проверку TLS/SSL как в браузере, Basic- и Digest-аутентификацию, поддержку прокси SOCKS, таймауты соединения, потоковую загрузку файлов, multipart-загрузку файлов и автоматическую распаковку содержимого.
Насколько широко она используется?Это один из самых скачиваемых пакетов Python сегодня — около 300 млн загрузок в неделю, а на GitHub более 4 000 000 репозиториев зависят от него.
Creator
psf
Size
13.3 MB
Stars
54.5K
Age
15y
Commits · 90 Days