diff options
| author | Kenneth Reitz <me@kennethreitz.org> | 2017-02-02 15:18:24 -0500 |
|---|---|---|
| committer | Kenneth Reitz <me@kennethreitz.org> | 2017-02-02 15:18:24 -0500 |
| commit | 6bd091ca7046585e4dc4cdb7bc33d7f29022834e (patch) | |
| tree | 002945fbc7170b0b48b821f4f64400bf9c33abfc /docs | |
| parent | 260763a83d26d829c5308dfc937793a302a70f7a (diff) | |
| download | python-requests-6bd091ca7046585e4dc4cdb7bc33d7f29022834e.tar.gz | |
improved homepage
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/index.rst | 46 |
1 files changed, 34 insertions, 12 deletions
diff --git a/docs/index.rst b/docs/index.rst index cf0bebef..7a5568e3 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -8,14 +8,36 @@ Requests: HTTP for Humans Release v\ |version|. (:ref:`Installation <install>`) -Requests is the only *Non-GMO* HTTP library for Python, safe for human +.. image:: https://img.shields.io/pypi/l/requests.svg + :target: https://pypi.python.org/pypi/requests + +.. image:: https://img.shields.io/pypi/wheel/requests.svg + :target: https://pypi.python.org/pypi/requests + +.. image:: https://img.shields.io/pypi/pyversions/requests.svg + :target: https://pypi.python.org/pypi/requests + +.. image:: https://travis-ci.org/kennethreitz/requests.svg?branch=master + :target: https://travis-ci.org/kennethreitz/requests + +.. image:: https://codecov.io/github/kennethreitz/requests/coverage.svg?branch=master + :target: https://codecov.io/github/kennethreitz/requests + :alt: codecov.io + +.. image:: https://img.shields.io/badge/Say%20Thanks!-🦉-1EAEDB.svg + :target: https://saythanks.io/to/kennethreitz + + +**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, +*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. +constantly reading documentation, depression, headaches, or even death.* -Behold, the power of Requests:: +------------------- + +**Behold, the power of Requests**:: >>> r = requests.get('https://api.github.com/user', auth=('user', 'pass')) >>> r.status_code @@ -32,7 +54,7 @@ Behold, the power of Requests:: See `similar code, sans Requests <https://gist.github.com/973705>`_. -Requests allows you to send *organic, grass-fed* HTTP/1.1 requests, without the +**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>`_, @@ -65,26 +87,26 @@ Institutions that prefer to be unnamed claim to use Requests internally. Requests is one of the most downloaded Python packages of all time, pulling in over 11,000,000 downloads every month. All the cool kids are doing it! -Supported Features ------------------- +Beloved Features +---------------- Requests is ready for today's web. -- International Domains and URLs - Keep-Alive & Connection Pooling +- International Domains and URLs - Sessions with Cookie Persistence - Browser-style SSL Verification +- Automatic Content Decoding - Basic/Digest Authentication - Elegant Key/Value Cookies - Automatic Decompression -- Automatic Content Decoding - Unicode Response Bodies -- Multipart File Uploads - HTTP(S) Proxy Support -- Connection Timeouts +- Multipart File Uploads - Streaming Downloads -- ``.netrc`` Support +- Connection Timeouts - Chunked Requests +- ``.netrc`` Support - Thread-safety Requests officially supports Python 2.6–2.7 & 3.3–3.7, and runs great on PyPy. |
