From: Kenneth Reitz <me@kennethreitz.com>
Date: Wed, 17 Aug 2011 07:58:55 +0000 (-0400)
Subject: cookies docs
X-Git-Tag: v0.6.0~9
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=3992ed6ad17347c128dac1784020c5e627b3e742;p=services%2Fpython-requests.git

cookies docs
---

diff --git a/docs/user/quickstart.rst b/docs/user/quickstart.rst
index 4669e81..61d5c7b 100644
--- a/docs/user/quickstart.rst
+++ b/docs/user/quickstart.rst
@@ -104,4 +104,33 @@ So, we can access the headers using any capitalization we want::
 If a header doesn't exist in the Response, its value defaults to ``None``::
 
     >>> r.headers['X-Random']
-    None
\ No newline at end of file
+    None
+
+
+Cookies
+-------
+
+If a response contains some Cookies, you can get quick access to them::
+
+    # cookies test url
+    >>> url = 'http://httpbin.org/cookies/set/requests-is/awesome'
+
+    >>> r = requests.get(url)
+
+    >>> print r.cookies
+    {'requests-is': 'awesome'}
+
+The underlying CookieJar is also available for more advanced handing::
+
+    >>> r.request.cookiejar
+    <cookielib.CookieJar>
+
+To send your own cookies to the server, you can use the ``cookies``
+parameter::
+
+    >>> url = 'http://httpbin.org/cookies'
+    >>> cookies = dict(cookies_are='working')
+
+    >>> r = requests.get(url, cookies=cookies)
+    >>> r.content
+    '{"cookies": {"cookies_are": "working"}}'