Resolved #1219 - Support load and save for CookieJar

CHANGES.rst

@@ -45,7 +45,7 @@ CHANGES
 
 - Show more verbose message on import errors #1319
 
--
+- Added save and load functionality for `CookieJar` #1219
 
 -
 

aiohttp/cookiejar.py

@@ -1,4 +1,6 @@
 import datetime
+import pathlib
+import pickle
 import re
 from collections import defaultdict
 from collections.abc import Mapping
@@ -37,6 +39,16 @@ def __init__(self, *, unsafe=False, loop=None):
         self._next_expiration = ceil(self._loop.time())
         self._expirations = {}
 
+    def save(self, file_path):
+        file_path = pathlib.Path(file_path)
+        with file_path.open(mode='wb') as f:
+            pickle.dump(self._cookies, f, pickle.HIGHEST_PROTOCOL)
+
+    def load(self, file_path):
+        file_path = pathlib.Path(file_path)
+        with file_path.open(mode='rb') as f:
+            self._cookies = pickle.load(f)
+
     def clear(self):
         self._cookies.clear()
         self._host_only_cookies.clear()

docs/client_reference.rst

@@ -1538,5 +1538,19 @@ CookieJar
       :return: :class:`http.cookies.SimpleCookie` with filtered
          cookies for given URL.
 
+   .. method:: save(file_path)
+
+      Write a pickled representation of cookies into the file
+      at provided path.
+
+      :param str file_path: Path to file where cookies will be serialized.
+
+   .. method:: load(file_path)
+
+      Load a pickled representation of cookies from the file
+      at provided path.
+
+      :param str file_path: Path to file from where cookies will be imported.
+
 .. disqus::
   :title: aiohttp client reference

tests/test_cookiejar.py

@@ -1,5 +1,7 @@
 import asyncio
 import datetime
+import os
+import tempfile
 import unittest
 from http.cookies import SimpleCookie
 from unittest import mock
@@ -141,6 +143,25 @@ def test_constructor(loop, cookies_to_send, cookies_to_receive):
     assert jar._loop is loop
 
 
+def test_save_load(loop, cookies_to_send, cookies_to_receive):
+    file_path = tempfile.mkdtemp() + '/aiohttp.test.cookie'
+
+    # export cookie jar
+    jar_save = CookieJar(loop=loop)
+    jar_save.update_cookies(cookies_to_receive)
+    jar_save.save(file_path=file_path)
+
+    jar_load = CookieJar(loop=loop)
+    jar_load.load(file_path=file_path)
+
+    jar_test = SimpleCookie()
+    for cookie in jar_load:
+        jar_test[cookie.key] = cookie
+
+    os.unlink(file_path)
+    assert jar_test == cookies_to_receive
+
+
 def test_ctor_ith_default_loop(loop):
     asyncio.set_event_loop(loop)
     jar = CookieJar()