mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-02 07:05:24 +00:00
86 lines
2.9 KiB
ReStructuredText
86 lines
2.9 KiB
ReStructuredText
Requests: HTTP for Humans
|
|
=========================
|
|
|
|
.. image:: https://badge.fury.io/py/requests.png
|
|
:target: http://badge.fury.io/py/requests
|
|
|
|
.. image:: https://pypip.in/d/requests/badge.png
|
|
:target: https://crate.io/packages/requests/
|
|
|
|
|
|
Requests is an Apache2 Licensed HTTP library, written in Python, for human
|
|
beings.
|
|
|
|
Most existing Python modules for sending HTTP requests are extremely
|
|
verbose and cumbersome. Python's builtin urllib2 module provides most of
|
|
the HTTP capabilities you should need, but the api is thoroughly broken.
|
|
It requires an enormous amount of work (even method overrides) to
|
|
perform the simplest of tasks.
|
|
|
|
Things shouldn't be this way. Not in Python.
|
|
|
|
.. code-block:: python
|
|
|
|
>>> r = requests.get('https://api.github.com', auth=('user', 'pass'))
|
|
>>> r.status_code
|
|
204
|
|
>>> r.headers['content-type']
|
|
'application/json'
|
|
>>> r.text
|
|
...
|
|
|
|
See `the same code, without Requests <https://gist.github.com/973705>`_.
|
|
|
|
Requests allow you to send HTTP/1.1 requests. You can add headers, form data,
|
|
multipart files, and parameters with simple Python dictionaries, and access the
|
|
response data in the same way. It's powered by httplib and `urllib3
|
|
<https://github.com/shazow/urllib3>`_, but it does all the hard work and crazy
|
|
hacks for you.
|
|
|
|
|
|
Features
|
|
--------
|
|
|
|
- International Domains and URLs
|
|
- Keep-Alive & Connection Pooling
|
|
- Sessions with Cookie Persistence
|
|
- Browser-style SSL Verification
|
|
- Basic/Digest Authentication
|
|
- Elegant Key/Value Cookies
|
|
- Automatic Decompression
|
|
- Unicode Response Bodies
|
|
- Multipart File Uploads
|
|
- Connection Timeouts
|
|
- Thread-safety
|
|
- HTTP(S) proxy support
|
|
|
|
|
|
Installation
|
|
------------
|
|
|
|
To install Requests, simply:
|
|
|
|
.. code-block:: bash
|
|
|
|
$ pip install requests
|
|
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
Documentation is available at http://docs.python-requests.org/.
|
|
|
|
|
|
Contribute
|
|
----------
|
|
|
|
#. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug. There is a `Contributor Friendly`_ tag for issues that should be ideal for people who are not very familiar with the codebase yet.
|
|
#. If you feel uncomfortable or uncertain about an issue or your changes, feel free to email @sigmavirus24 and he will happily help you via email, Skype, remote pairing or whatever you are comfortable with.
|
|
#. Fork `the repository`_ on GitHub to start making your changes to the **master** branch (or branch off of it).
|
|
#. Write a test which shows that the bug was fixed or that the feature works as expected.
|
|
#. Send a pull request and bug the maintainer until it gets merged and published. :) Make sure to add yourself to AUTHORS_.
|
|
|
|
.. _`the repository`: http://github.com/kennethreitz/requests
|
|
.. _AUTHORS: https://github.com/kennethreitz/requests/blob/master/AUTHORS.rst
|
|
.. _Contributor Friendly: https://github.com/kennethreitz/requests/issues?direction=desc&labels=Contributor+Friendly&page=1&sort=updated&state=open
|