Add make_reader(..., _storage=...) argument (private for now).

For #168.

docs/api.rst

@@ -16,7 +16,7 @@ All of *reader*'s functionality can be accessed through a :class:`Reader` instan
 
     Split this into sub-sections.
 
-.. autofunction:: make_reader
+.. autofunction:: make_reader(url: str) -> reader.core.Reader
 
 .. autoclass:: Reader(...)
     :members:

src/reader/core.py

@@ -57,12 +57,15 @@
 _PostEntryAddPluginType = Callable[['Reader', EntryData[datetime.datetime]], None]
 
 
-def make_reader(url: str) -> 'Reader':
-    """Return a new :class:`Reader`.
+def make_reader(url: str, _storage: Optional[Storage] = None) -> 'Reader':
+    """Create a new :class:`Reader`.
 
     Args:
         url (str): Path to the reader database.
 
+    Returns:
+        Reader: The reader.
+
     Raises:
         StorageError
 
@@ -75,7 +78,7 @@ def make_reader(url: str) -> 'Reader':
     # See this comment for details on how it should evolve:
     # https://github.com/lemon24/reader/issues/168#issuecomment-642002049
 
-    storage = Storage(url)
+    storage = _storage or Storage(url)
 
     # For now, we're using a storage-bound search provider.
     search = Search(storage.db)

tests/test_reader_private.py

@@ -7,6 +7,8 @@
 from reader import Entry
 from reader import Feed
 from reader import FeedNotFoundError
+from reader import make_reader
+from reader._storage import Storage
 
 
 def test_update_stale(reader, call_update_method):
@@ -124,3 +126,9 @@ def second_plugin(r, e):
     assert set(e.id for e in reader.get_entries()) == {'1, 1', '1, 2'}
 
     # TODO: What is the expected behavior if a plugin raises an exception?
+
+
+def test_make_reader_storage():
+    storage = Storage(':memory:')
+    reader = make_reader('', _storage=storage)
+    assert reader._storage is storage