diff --git a/README.md b/README.md index ee3b2bf5..947fb86e 100644 --- a/README.md +++ b/README.md @@ -8,47 +8,40 @@ Requests: HTTP for Humans™ [![image](https://img.shields.io/github/contributors/requests/requests.svg)](https://github.com/requests/requests/graphs/contributors) [![image](https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg)](https://saythanks.io/to/kennethreitz) -**If you're interested in financially supporting Kenneth Reitz open source, consider [visiting this link](https://cash.me/$KennethReitz). Your support helps tremendously with sustainability of motivation, as Open Source is no longer part of my day job.** +**If you're interested in financially supporting Requests 3 development, please [make a donation](https://cash.me/$KennethReitz). Your support helps tremendously with sustainability of motivation.** -Requests is the only *Non-GMO* HTTP library for Python, safe for human -consumption. +**Requests III** is an HTTP library for Python, built for Humans and Machines, alike. **This repository is a work in progress, and the expected release timeline is "before PyCon 2020". ![image](https://farm5.staticflickr.com/4317/35198386374_1939af3de6_k_d.jpg) -Behold, the power of Requests: +Behold, the power of Requests III: ``` {.sourceCode .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, ...} -``` +>>> from requests import HTTPSession -See [the similar code, sans Requests](https://gist.github.com/973705). +# Make a connection pool. +>>> http = HTTPSession() + +# Make a request. +>>> r = http.request('get', 'https://httpbin.org/ip') +>>> r.json() +{'ip': '172.69.48.124'} [![image](https://raw.githubusercontent.com/requests/requests/master/docs/_static/requests-logo-small.png)](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 +Requests III allows you to send *organic, grass-fed* HTTP/1.1 & HTTP/2 requests, +without the need for manual thought-labor. There's no need to 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). +HTTP connection pooling are 100% automatic, as well. Besides, all the cool kids are doing it. Requests is one of the most -downloaded Python packages of all time, pulling in over 11,000,000 -downloads every month. You don't want to be left out! +downloaded Python packages of all time, pulling in over ~1.6 million +installations *per day*! Feature Support --------------- -Requests is ready for today's web. +Requests III is ready for today's web. - International Domains and URLs - Keep-Alive & Connection Pooling @@ -76,7 +69,7 @@ To install Requests, simply use [pipenv](http://pipenv.org/) (or pip, of course): ``` {.sourceCode .bash} -$ pipenv install requests +$ pipenv install requests3 ✨🍰✨ ``` @@ -86,7 +79,7 @@ Documentation ------------- Fantastic documentation is available at -, for a limited time only. +, for a limited time only. How to Contribute ----------------- @@ -104,4 +97,3 @@ How to Contribute 4. Send a pull request and bug the maintainer until it gets merged and published. :) Make sure to add yourself to [AUTHORS](https://github.com/requests/requests/blob/master/AUTHORS.rst). -