diff options
Diffstat (limited to 'PKG-INFO')
| -rw-r--r-- | PKG-INFO | 158 |
1 files changed, 71 insertions, 87 deletions
@@ -1,7 +1,7 @@ Metadata-Version: 1.0 Name: requests -Version: 0.5.0 -Summary: Awesome Python HTTP Library that's actually usable. +Version: 0.6.1 +Summary: Python HTTP for Humans. Home-page: http://python-requests.org Author: Kenneth Reitz Author-email: me@kennethreitz.com @@ -9,11 +9,35 @@ License: ISC Description: Requests: HTTP for Humans ========================= - Most existing Python modules for dealing HTTP requests are insane. I have to look up *everything* that I want to do. Most of my worst Python experiences are a result of the various built-in HTTP libraries (yes, even worse than Logging). + Requests is an ISC Licensed HTTP library, written in Python, for human + beings. - But this one's different. This one's going to be awesome. And simple. + 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. + + :: + + >>> r = requests.get('https://api.github.com', auth=('user', 'pass')) + >>> r.status_code + 204 + >>> r.headers['content-type'] + 'application/json' + >>> r.content + ... + + See `the same code, without Requests <https://gist.github.com/973705>`_. + + Requests allow you to send **HEAD**, **GET**, **POST**, **PUT**, + **PATCH**, and **DELETE** HTTP 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 urllib2, but it does + all the hard work and crazy hacks for you. - Really simple. Features -------- @@ -44,14 +68,14 @@ Description: Requests: HTTP for Humans HTTPS? Basic Authentication? :: - >>> r = requests.get('https://httpbin.ep.ip/basic-auth/user/pass') + >>> r = requests.get('https://httpbin.ep.io/basic-auth/user/pass') >>> r.status_code 401 Uh oh, we're not authorized! Let's add authentication. :: - >>> r = requests.get(https://httpbin.ep.ip/basic-auth/user/pass', auth=('user', 'pass')) + >>> r = requests.get('https://httpbin.ep.io/basic-auth/user/pass', auth=('user', 'pass')) >>> r.status_code 200 @@ -63,80 +87,6 @@ Description: Requests: HTTP for Humans '{"authenticated": true, "user": "user"}' - - API - --- - - **Requests:** - - All request functions return a Response object (see below). - - If a {filename: fileobject} dictionary is passed in (files=...), a multipart_encode upload will be performed. - If CookieJar object is is passed in (cookies=...), the cookies will be sent with the request. - - HEAD Requests - >>> requests.head(url, params={}, headers={}, cookies=None, auth=None, timeout=None, proxies={}) - <Response [200]> - - GET Requests - >>> requests.get(url, params={}, headers={}, cookies=None, auth=None, timeout=None, proxies={}) - <Response [200]> - - POST Requests - >>> requests.post(url, data={}, headers={}, files={}, cookies=None, auth=None, timeout=None, allow_redirects=False, params{}, proxies={}) - <Response [200]> - - PUT Requests - >>> requests.put(url, data={}, headers={}, files={}, cookies=None, auth=None, timeout=None, allow_redirects=False, params{}, proxies={}) - <Response [200]> - - PATCH Requests - >>> requests.post(url, data={}, headers={}, files={}, cookies=None, auth=None, timeout=None, allow_redirects=False, params{}, proxies={}) - <Response [200]> - - DELETE Requests - >>> requests.delete(url, params={}, headers={}, cookies=None, auth=None, timeout=None, allow_redirects=False, params{}, proxies={}) - <Response [200]> - - - **Responses:** - - Response.status_code - (Integer) Received HTTP Status Code Response - - Response.headers - ((CaseInsensitive) Dictionary) Received HTTP Response Headers. - - Response.content - (Bytes) Received Content. - - Response.history - (List of Responses) Redirection History. - - Response.url - (String) URL of response. Useful for detecting redirects. - - Response.ok - (Bool) True if no errors occurred during the request, and the status_code is kosher. - - Response.cached - (Bool) True if Response.content is stored within the object. - - Response.error - (HTTPError) If an HTTPError occurred (e.g. status of 404), Otherwise this is None. - - Response.raise_for_status() - Raises HTTPError if a request is not kosher. - - - **HTTP Authentication Registry:** - - You can register AuthObjects to automatically enable HTTP Authentication on requests that contain a registered base URL string. - - >>> requests.auth_manager.add_auth(url, authobject) - - - Installation ------------ @@ -158,12 +108,6 @@ Description: Requests: HTTP for Humans If you'd like to contribute, simply fork `the repository`_, commit your changes to the **develop** branch (or branch off of it), and send a pull request. Make sure you add yourself to AUTHORS_. - - Roadmap - ------- - - - Sphinx Documentation - .. _`the repository`: http://github.com/kennethreitz/requests .. _AUTHORS: http://github.com/kennethreitz/requests/blob/master/AUTHORS @@ -171,6 +115,46 @@ Description: Requests: HTTP for Humans History ------- + + 0.6.1 (2011-08-20) + ++++++++++++++++++ + + * Enhanced status codes experience ``\o/`` + * Set a maximum number of redirects (``settings.max_redirects``) + * Full Unicode URL support + * Support for protocol-less redirects. + * Allow for arbitrary request types. + * Bugfixes + + + 0.6.0 (2011-08-17) + ++++++++++++++++++ + + * New callback hook system + * New persistient sessions object and context manager + * Transparent Dict-cookie handling + * Status code reference object + * Removed Response.cached + * Added Response.request + * All args are kwargs + * Relative redirect support + * HTTPError handling improvements + * Improved https testing + * Bugfixes + + 0.5.1 (2011-07-23) + ++++++++++++++++++ + + * International Domain Name Support! + * Access headers without fetching entire body (``read()``) + * Use lists as dicts for parameters + * Add Forced Basic Authentication + * Forced Basic is default authentication type + * ``python-requests.org`` default User-Agent header + * CaseInsensitiveDict lower-case caching + * Response.history bugfix + + 0.5.0 (2011-06-21) ++++++++++++++++++ |