Release v1.2.0. (Instalação)
Requests é uma biblioteca HTTP licensiada sob Apache2, escrita em Python, para seres humanos.
O módulo urllib2, parte da biblioteca padrão do Python, oferece a maioria das funcionalidades do protocolo HTTP que você precisa, mas a API está completamente quebrada. Ela foi feita para uma época diferente — e uma web diferente. Ela demanda uma enorme quantidade de trabalho (inclusive para sobrescrever métodos) para realizar as tarefas mais simples.
As coisas não deveriam ser desse jeito. Não em Python.
>>> 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'private_gists': 419, u'total_private_repos': 77, ...}
Veja um código similiar, sem Requests.
Requests retira todo o trabalho do protocolo HTTP/1.1 do Python - deixando a integração dos seus serviços web sem problemas. Não há necessidade para adicionar query string nas suas URLs manualmente, ou de codificar seus dados de formulário POST. Keep-alive e gerência de conexões HTTP são 100% automáticas, feitas com urllib3, que está incluso no Requests.
O Governo de Sua Majestade, Amazon, Google, Twilio, Mozilla, Heroku, PayPal, NPR, Obama for America, Transifex, Native Instruments, The Washington Post, Twitter, SoundCloud, Kippt, Readability, e Institutos Federais dos Estados Unidos usam Requests internamente. Requests já foi baixado mais de 2 milhões de vezes pelo PyPI.
Requests está pronto para a web de hoje.
Esta parte da documentação, que é principalmente prosa, começa com algumas informações sobre o Requests e então foca em instruções passo-a-passo para aproveitar o máximo do Requests.
Esta parte da documentação, que é principalmente prosa, detalha o ecossistema e a comunidade do Requests.
Se você estiver procurando por informações sobre uma função, classe ou método específico, esta parte da documentação é para você.
Se você quiser contribuir para o projeto, esta parte da documentação é para você.