Documentation for CookieJar class (#1000)

docs/client.rst

@@ -392,13 +392,13 @@ Cookie safety
 -------------
 
 By default :class:`~aiohttp.ClientSession` uses strict version of
-:class:`~aiohttp.CookieJar`. :rfc:`2109` explicitly forbids cookie
+:class:`aiohttp.CookieJar`. :rfc:`2109` explicitly forbids cookie
 accepting from URLs with IP address instead of DNS name
 (e.g. `http://127.0.0.1:80/cookie`).
 
 It's good but sometimes for testing we need to enable support for such
 cookies. It should be done by passing `usafe=True` to
-:class:`~aiohttp.CookieJar` constructor::
+:class:`aiohttp.CookieJar` constructor::
 
 
     jar = aiohttp.CookieJar(unsafe=True)

docs/client_reference.rst

@@ -1395,4 +1395,32 @@ BasicAuth
       :return: encoded authentication data, :class:`str`.
 
 
+CookieJar
+^^^^^^^^^
+
+.. class:: CookieJar(unsafe=False, loop=None)
+
+   Implements cookie storage adhering to RFC 6265.
+
+   :param bool unsafe: (optional) Whether to accept cookies from IPs.
+   :param bool loop: an :ref:`event loop<asyncio-event-loop>` instance.
+      See :class:`aiohttp.abc.AbstractCookieJar`
+
+   .. method:: update_cookies(cookies, response_url=None)
+
+      Update cookies.
+
+      :param cookies: cookies to update.
+         The parameter can be of :class:`str`, :class:`dict` or :class:`http.cookies.Morsel`
+         instance representing cookies to send.
+
+      :param str response_url: (optional) URL to store cookies for.
+
+   .. method:: filter_cookies(request_url)
+
+      Returns this jar's cookies filtered by their attributes.
+
+      :param str request_url: URL to fetch cookies for.
+
+
 .. disqus::