aboutsummaryrefslogtreecommitdiff
path: root/PKG-INFO
diff options
context:
space:
mode:
Diffstat (limited to 'PKG-INFO')
-rw-r--r--PKG-INFO158
1 files changed, 71 insertions, 87 deletions
diff --git a/PKG-INFO b/PKG-INFO
index 28554d0..5240199 100644
--- a/PKG-INFO
+++ b/PKG-INFO
@@ -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)
++++++++++++++++++