From: Kenneth Reitz <me@kennethreitz.com>
Date: Sun, 23 Dec 2012 06:14:22 +0000 (-0500)
Subject: request docstrings
X-Git-Tag: v1.0.4~24
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=f8a59c3e6fc7a6f1dd5d4f9783ee25c8458bccee;p=services%2Fpython-requests.git

request docstrings
---

diff --git a/requests/models.py b/requests/models.py
index 3922a86..b3c9dda 100644
--- a/requests/models.py
+++ b/requests/models.py
@@ -35,7 +35,6 @@ log = logging.getLogger(__name__)
 
 
 class RequestEncodingMixin(object):
-
     @property
     def path_url(self):
         """Build the path URL to use."""
@@ -147,7 +146,19 @@ class RequestHooksMixin(object):
 
 
 class Request(RequestHooksMixin):
-    """A user-created :class:`Request <Request>` object."""
+    """A user-created :class:`Request <Request>` object.
+
+    :param method: HTTP method to use.
+    :param url: URL to send.
+    :param headers: dictionary of headers to send.
+    :param files: dictionary of {filename: fileobject} files to multipart upload.
+    :param data: the body to attach the request. If a dictionary is provided, form-encoding will take place.
+    :param params: dictionary of URL parameters to append to the URL.
+    :param auth: Auth handler or (user, pass) tuple.
+    :param cookies: dictionary or CookieJar of cookies to attach to this request.
+    :param timeout: REMOVE REMOVE.
+    :param hooks: dictionary of callback hooks, for internal usage.
+    """
     def __init__(self,
         method=None,
         url=None,
@@ -160,6 +171,7 @@ class Request(RequestHooksMixin):
         timeout=None,
         hooks=None):
 
+
         # Default empty dicts for dict params.
         data = [] if data is None else data
         files = [] if files is None else files