Run code from README in tests

README.md

@@ -89,7 +89,7 @@ from dishka import Provider, provide, Scope
 class ConnectionProvider(Provider):
     @provide(scope=Scope.REQUEST)
     def new_connection(self) -> Iterable[Connection]:
-        conn = sqlite3.connect()
+        conn = sqlite3.connect(":memory:")
         yield conn
         conn.close()
 ```

docs/quickstart.rst

@@ -58,7 +58,7 @@ To provide connection we might need to write some custom code:
     class ConnectionProvider(Provider):
         @provide(scope=Scope.REQUEST)
         def new_connection(self) -> Iterable[Connection]:
-            conn = sqlite3.connect()
+            conn = sqlite3.connect(":memory:")
             yield conn
             conn.close()
 

tests/unit/test_readme_example.py

@@ -0,0 +1,70 @@
+import sqlite3
+from collections.abc import Iterable
+from sqlite3 import Connection
+from typing import Protocol
+
+import pytest
+
+from dishka import Provider, Scope, make_container, provide
+
+
+class DAO(Protocol):
+    ...
+
+
+class Service:
+    def __init__(self, dao: DAO):
+        ...
+
+
+class DAOImpl(DAO):
+    def __init__(self, connection: Connection):
+        ...
+
+
+class SomeClient:
+    ...
+
+
+@pytest.fixture
+def service_provider():
+    provider = Provider(scope=Scope.REQUEST)
+    provider.provide(Service)
+    provider.provide(DAOImpl, provides=DAO)
+    provider.provide(SomeClient, scope=Scope.APP)
+    return provider
+
+
+@pytest.fixture
+def container(service_provider):
+    return make_container(service_provider, ConnectionProvider())
+
+
+class ConnectionProvider(Provider):
+    @provide(scope=Scope.REQUEST)
+    def new_connection(self) -> Iterable[Connection]:
+        conn = sqlite3.connect(":memory:")
+        yield conn
+        conn.close()
+
+
+def test_get_client(container):
+    client_1 = container.get(SomeClient)
+    client_2 = container.get(SomeClient)
+
+    assert isinstance(client_1, SomeClient)
+    assert client_1 is client_2
+
+
+def test_subcontainers(container):
+    with container() as request_container:
+        service_1 = request_container.get(Service)
+        service_2 = request_container.get(Service)
+
+        assert service_1 is service_2
+        assert isinstance(service_1, Service)
+
+    with container() as new_request_container:
+        service_3 = new_request_container.get(Service)
+
+        assert service_1 is not service_3