diff --git a/README.md b/README.md index 673f2464..1af0f7e4 100644 --- a/README.md +++ b/README.md @@ -3,7 +3,7 @@ 
-    
+    
     

     

      Python 3.7.4 (default, Sep  7 2019, 18:27:02)
@@ -16,29 +16,19 @@
 
     
     

-This project has been brought to you, with much joy, 
-by Kenneth Reitz & The Python Software Foundation.
-

-    
-
- -

+This software has been designed for you, with much joy, +by Kenneth Reitz & is secured by The Python Software Foundation. +

+ --------------------- -**Requests** is an elegant and simple HTTP library for Python, built for human beings. +

Requests is an elegant and simple HTTP library for Python, built with ♥

-[![Downloads](https://pepy.tech/badge/requests)](https://pepy.tech/project/requests) -[![image](https://img.shields.io/pypi/pyversions/requests.svg)](https://pypi.org/project/requests/) -[![image](https://img.shields.io/github/contributors/psf/requests.svg)](https://github.com/psf/requests/graphs/contributors) - - -Behold, the power of Requests: - -``` {.sourceCode .python} +```pycon >>> import requests >>> r = requests.get('https://api.github.com/user', auth=('user', 'pass')) >>> r.status_code @@ -53,55 +43,50 @@ u'{"type":"User"...' {u'disk_usage': 368627, u'private_gists': 484, ...} ``` -See [the similar code, sans Requests](https://gist.github.com/973705). +

Downloads +image +image

-[![image]()](http://docs.python-requests.org/) +--------------------------------------------------------------------- -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, thanks to -[urllib3](https://github.com/shazow/urllib3). +Requests allows you to send HTTP/1.1 requests extremely easily. There’s no need to manually add query strings to your URLs, or to form-encode your `PUT` & `POST` data — but nowadays, just use the `json` method! -Besides, all the cool kids are doing it. Requests is one of the most -downloaded Python packages of all time, pulling about 60,000,000 -downloads every month. You don't want to be left out! +Requests is one of the most downloaded Python packages of all time, pulling in around `14M downloads / week`— according to GitHub, Requests is currently [depended upon](https://github.com/psf/requests/network/dependents?package_id=UGFja2FnZS01NzA4OTExNg%3D%3D) by `367_296` repositories. You can trust this code. -Feature Support ---------------- +

Supported Features & Best–Practices

-Requests is ready for today's web. +Requests is ready for the demands of building robust and reliable HTTP–speaking applications, on today's web (or your own infrastructure). -- 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 - -Requests officially supports Python 2.7 & 3.4–3.8, and runs great on -PyPy. +
+         + International Domains and URLs       + Keep-Alive & Connection Pooling
+         + Sessions with Cookie Persistence     + Browser-style SSL Verification 
+         + Basic & Digest Authentication        + Familiar `dict`–like Cookies   
+         + Automatic Decompression of Content   + Automatic Content Decoding     
+         + Automatic Connection Pooling         + Unicode Response Bodies*
+         + Multi-part File Uploads              + SOCKS Proxy Support            
+         + Connection Timeouts                  + Streaming Downloads
+         + Automatic honoring of `.netrc`       + Chunked HTTP Requests          
+              
+                            &, of course, rock–solid stability!
+
+ Installation ------------ -To install Requests, simply use [pipenv](http://pipenv.org/) (or pip, of +To install **Requests**, simply use [**pipenv**](http://pipenv.org/) (or **pip**, of course): -``` {.sourceCode .bash} +```console $ pipenv install requests +Adding requests to Pipfile's [packages]… +✔ Installation Succeeded +… ``` -Satisfaction guaranteed. +Requests officially supports Python 2.7 & 3.4–3.8, and runs great on +PyPy. + Documentation ------------- @@ -109,5 +94,10 @@ Documentation Fantastic documentation is available at , for a limited time only. +Your satisfaction is guaranteed. ✨ 🍰 ✨ + +

+ +