Requests: HTTP pour les humains¶

Requests est une librairie HTTP sous licence ISC, écrite en Python, pour les êtres humains.

Le module urllib2 de la librairie standard fournit toutes les fonctionnalités dont vous avez besoin, mais son API est complètement moisie. Il a été crée dans une autre époque - lorsque le web était autre chose, et demande une énorme quantité de travail (voire des remplacements de méthodes) pour achever les plus simples tâches.

Ca ne devrait pas se passer comme ca. Pas en 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, ...}

Voir le même code, sans Requests.

Requests reprend tout les travaux autour de Python HTTP/1.1 - et rend l’intégration avec des webservices très facile. Pas besoin d’ajouter des querystrings à vos URLs manuellement, ou d’encoder vous-même vos datas pour les POST. Les Keep-alive et le groupement des connexions HTTP sont 100% automatisés, grâce à urllib3, qui est directement intégré à Requests.

Témoignages¶

Kippt, Heroku, PayPal, Transifex, Native Instruments, The Washington Post, Twitter, Inc, Readability, and Federal US Institutions utilisent Requests en interne. Le module a été installé plus de 100,000 fois via PyPI.

Armin Ronacher: Requests est l’exemple parfait de ce que peut être une belle API grâce à la bonne dose d’abstraction.
Matt DeBoard: Je vais me tatouer le module Python requests de @kennethreitz sur le corps, d’une façon ou d’une autre. partout.
Daniel Greenfeld: Je viens de passer de 1200 lignes de code spaghetti à 10 lignes de code grâce au module requests de @kennethreitz. Aujourd’hui est un grand jour.
Kenny Meyers: HTTP avec Python: si vous avez un doute, ou pas, utilisez Requests. Beau, simple, pythonic.

Fonctionnalités¶

Requests est prêt pour le web d’aujourd’hui

Gestion domaines et URLS internationales
Keep-Alive & Groupement de connections (Pooling)
Sessions et Cookies persistants
Verification SSL
Authentifications Basic/Digest ou personnalisées
Gestion élégante des Cookies clé/valeur
Décompression automatique
Corps des réponses en unicode
Upload de fichiers multiparts
Timeouts de connexion
supprt de .netrc
Thread-safe.

Guide utilisateur¶

Cette partie de la documentation commence avec des informations de fond sur Requests, puis nous présentons étape par étape les instructions pour tirer le meilleur parti de Requests.

Guide de la communauté¶

Cette partie de la documentation détaille l’ecosystème de Requests et de sa communauté

Documentation de l’API¶

Si vous cherchez des informations sur une fonction, une classe ou une méthode spécifique, c’est dans cette partie de la documentation que vous devez regarder.

API

Guide du développeur¶

Si vous voulez contribuer au projet, cette partie de la documentation est pour vous

Requests: HTTP pour les humains¶

Témoignages¶

Fonctionnalités¶

Guide utilisateur¶

Guide de la communauté¶

Documentation de l’API¶

Guide du développeur¶

Donate

Feedback

Useful Links

Navigation

Requests: HTTP pour les humains¶

Témoignages¶

Fonctionnalités¶

Guide utilisateur¶

Guide de la communauté¶

Documentation de l’API¶

Guide du développeur¶

Donate

Feedback

Useful Links

Quick search