| Index: recipe_engine/third_party/requests/README.rst
|
| diff --git a/recipe_engine/third_party/requests/README.rst b/recipe_engine/third_party/requests/README.rst
|
| deleted file mode 100644
|
| index 9fe548d2c23c37889584a8785d8033de739ea591..0000000000000000000000000000000000000000
|
| --- a/recipe_engine/third_party/requests/README.rst
|
| +++ /dev/null
|
| @@ -1,97 +0,0 @@
|
| -Requests: HTTP for Humans
|
| -=========================
|
| -
|
| -.. image:: https://img.shields.io/pypi/v/requests.svg
|
| - :target: https://pypi.python.org/pypi/requests
|
| -
|
| -.. image:: https://img.shields.io/pypi/dm/requests.svg
|
| - :target: https://pypi.python.org/pypi/requests
|
| -
|
| -Requests is the only *Non-GMO* HTTP library for Python, safe for human
|
| -consumption.
|
| -
|
| -**Warning:** Recreational use of other HTTP libraries may result in dangerous side-effects,
|
| -including: security vulnerabilities, verbose code, reinventing the wheel,
|
| -constantly reading documentation, depression, headaches, or even death.
|
| -
|
| -Behold, the power of Requests:
|
| -
|
| -.. code-block:: 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'disk_usage': 368627, u'private_gists': 484, ...}
|
| -
|
| -See `the similar code, sans Requests <https://gist.github.com/973705>`_.
|
| -
|
| -Requests allows you to send *organic, grass-fed* HTTP/1.1 requests, without the
|
| -need for manual labor. There's no need to manually add query strings to your
|
| -URLs, or to form-encode your POST data. Keep-alive and HTTP connection pooling
|
| -are 100% automatic, powered by `urllib3 <https://github.com/shazow/urllib3>`_,
|
| -which is embedded within Requests.
|
| -
|
| -Besides, all the cool kids are doing it. Requests is one of the most
|
| -downloaded Python packages of all time, pulling in over 7,000,000 downloads
|
| -every month. You don't want to be left out!
|
| -
|
| -Feature Support
|
| ----------------
|
| -
|
| -Requests is ready for today's web.
|
| -
|
| -- 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
|
| -- Automatic Content Decoding
|
| -- Unicode Response Bodies
|
| -- Multipart File Uploads
|
| -- HTTP(S) Proxy Support
|
| -- Connection Timeouts
|
| -- Streaming Downloads
|
| -- ``.netrc`` Support
|
| -- Chunked Requests
|
| -- Thread-safety
|
| -
|
| -Requests supports Python 2.6 — 3.5, and runs great on PyPy.
|
| -
|
| -Installation
|
| -------------
|
| -
|
| -To install Requests, simply:
|
| -
|
| -.. code-block:: bash
|
| -
|
| - $ pip install requests
|
| - ✨🍰✨
|
| -
|
| -Satisfaction, guaranteed.
|
| -
|
| -Documentation
|
| --------------
|
| -
|
| -Fantastic documentation is available at http://docs.python-requests.org/, for a limited time only.
|
| -
|
| -
|
| -How to 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.
|
| -#. 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
|
|
|