eventsourcing 9.2.21__py3-none-any.whl → 9.3.0__py3-none-any.whl

eventsourcing/tests/persistence_tests/test_postgres.py

@@ -0,0 +1,1119 @@
+from __future__ import annotations
+
+import sys
+from threading import Event, Thread
+from time import sleep
+from typing import List
+from unittest import TestCase, skipIf
+from uuid import uuid4
+
+import psycopg
+from psycopg import Connection
+from psycopg_pool import ConnectionPool
+
+from eventsourcing.persistence import (
+    DatabaseError,
+    DataError,
+    InfrastructureFactory,
+    IntegrityError,
+    InterfaceError,
+    InternalError,
+    NotSupportedError,
+    OperationalError,
+    PersistenceError,
+    ProgrammingError,
+    StoredEvent,
+    Tracking,
+)
+from eventsourcing.postgres import (
+    Factory,
+    PostgresAggregateRecorder,
+    PostgresApplicationRecorder,
+    PostgresDatastore,
+    PostgresProcessRecorder,
+)
+from eventsourcing.tests.persistence import (
+    AggregateRecorderTestCase,
+    ApplicationRecorderTestCase,
+    InfrastructureFactoryTestCase,
+    ProcessRecorderTestCase,
+)
+from eventsourcing.tests.persistence_tests.test_connection_pool import (
+    TestConnectionPool,
+)
+from eventsourcing.tests.postgres_utils import (
+    drop_postgres_table,
+    pg_close_all_connections,
+)
+from eventsourcing.utils import Environment, get_topic
+
+
+class TestPostgresDatastore(TestCase):
+    def test_is_pipeline_supported(self):
+        self.assertTrue(psycopg.Pipeline.is_supported())
+
+    def test_has_connection_pool(self):
+        with PostgresDatastore(
+            dbname="eventsourcing",
+            host="127.0.0.1",
+            port="5432",
+            user="eventsourcing",
+            password="eventsourcing",  # noqa: S106
+        ) as datastore:
+            self.assertIsInstance(datastore.pool, ConnectionPool)
+
+    def test_get_connection(self):
+        with PostgresDatastore(
+            dbname="eventsourcing",
+            host="127.0.0.1",
+            port="5432",
+            user="eventsourcing",
+            password="eventsourcing",  # noqa: S106
+        ) as datastore:
+            conn: Connection
+            with datastore.get_connection() as conn:
+                self.assertIsInstance(conn, Connection)
+
+    def test_context_manager_converts_exceptions_and_conditionally_calls_close(self):
+        cases = [
+            (InterfaceError, psycopg.InterfaceError(), True),
+            (DataError, psycopg.DataError(), False),
+            (OperationalError, psycopg.OperationalError(), True),
+            (IntegrityError, psycopg.IntegrityError(), False),
+            (InternalError, psycopg.InternalError(), False),
+            (ProgrammingError, psycopg.ProgrammingError(), False),
+            (NotSupportedError, psycopg.NotSupportedError(), False),
+            (DatabaseError, psycopg.DatabaseError(), False),
+            (PersistenceError, psycopg.Error(), True),
+            (TypeError, TypeError(), True),
+            (TypeError, TypeError, True),
+        ]
+        with PostgresDatastore(
+            dbname="eventsourcing",
+            host="127.0.0.1",
+            port="5432",
+            user="eventsourcing",
+            password="eventsourcing",  # noqa: S106
+        ) as datastore:
+            for expected_exc_type, raised_exc, expect_conn_closed in cases:
+                with self.assertRaises(expected_exc_type):
+                    conn: Connection
+                    with datastore.get_connection() as conn:
+                        self.assertFalse(conn.closed)
+                        raise raised_exc
+                    self.assertTrue(conn.closed is expect_conn_closed, raised_exc)
+
+    def test_transaction_from_datastore(self):
+        with PostgresDatastore(
+            dbname="eventsourcing",
+            host="127.0.0.1",
+            port="5432",
+            user="eventsourcing",
+            password="eventsourcing",  # noqa: S106
+        ) as datastore, datastore.transaction(commit=False) as curs:
+            # As a convenience, we can use the transaction() method.
+            curs.execute("SELECT 1")
+            self.assertEqual(curs.fetchall(), [{"?column?": 1}])
+
+    def test_connect_failure_raises_operational_error(self):
+        datastore = PostgresDatastore(
+            dbname="eventsourcing",
+            host="127.0.0.1",
+            port="4321",  # wrong port
+            user="eventsourcing",
+            password="eventsourcing",  # noqa: S106
+            pool_open_timeout=2,
+        )
+        with self.assertRaises(OperationalError), datastore.get_connection():
+            pass
+
+        with PostgresDatastore(
+            dbname="eventsourcing",
+            host="127.0.0.1",
+            port="987654321",  # bad value
+            user="eventsourcing",
+            password="eventsourcing",  # noqa: S106
+            pool_open_timeout=2,
+        ) as datastore, self.assertRaises(OperationalError), datastore.get_connection():
+            pass
+
+    @skipIf(
+        sys.version_info[:2] < (3, 8),
+        "The 'check' argument and the check_connection() method aren't supported.",
+    )
+    def test_pre_ping(self):
+        # Define method to open and close a connection, and then execute a statement.
+        def open_close_execute(*, pre_ping: bool):
+            with PostgresDatastore(
+                dbname="eventsourcing",
+                host="127.0.0.1",
+                port="5432",
+                user="eventsourcing",
+                password="eventsourcing",  # noqa: S106
+                pool_size=1,
+                pre_ping=pre_ping,
+            ) as datastore:
+
+                # Create a connection.
+                conn: Connection
+                with datastore.get_connection() as conn, conn.cursor() as curs:
+                    curs.execute("SELECT 1")
+                    self.assertEqual(curs.fetchall(), [{"?column?": 1}])
+
+                # Close all connections via separate connection.
+                pg_close_all_connections()
+
+                # Check the connection doesn't think it's closed.
+                self.assertTrue(datastore.pool._pool)
+                self.assertFalse(datastore.pool._pool[0].closed)
+
+                # Get a closed connection.
+                conn: Connection
+                with datastore.get_connection() as conn:
+                    self.assertFalse(conn.closed)
+
+                    with conn.cursor() as curs:
+                        curs.execute("SELECT 1")
+
+        # Check using the closed connection gives an error.
+        with self.assertRaises(OperationalError):
+            open_close_execute(pre_ping=False)
+
+        # Now try that again with pre-ping enabled.
+        open_close_execute(pre_ping=True)
+
+    def test_idle_in_transaction_session_timeout(self):
+        with PostgresDatastore(
+            dbname="eventsourcing",
+            host="127.0.0.1",
+            port="5432",
+            user="eventsourcing",
+            password="eventsourcing",  # noqa: S106
+            idle_in_transaction_session_timeout=1,
+        ) as datastore:
+
+            # Error on commit is raised.
+            with self.assertRaises(
+                OperationalError
+            ), datastore.get_connection() as curs:
+                curs.execute("BEGIN")
+                curs.execute("SELECT 1")
+                self.assertFalse(curs.closed)
+                sleep(2)
+
+            # Error on commit is raised.
+            with self.assertRaises(OperationalError), datastore.transaction(
+                commit=True
+            ) as curs:
+                # curs.execute("BEGIN")
+                curs.execute("SELECT 1")
+                self.assertFalse(curs.closed)
+                sleep(2)
+
+            # Force rollback. Error is ignored.
+            with datastore.transaction(commit=False) as curs:
+                # curs.execute("BEGIN")
+                curs.execute("SELECT 1")
+                self.assertFalse(curs.closed)
+                sleep(2)
+
+            # Autocommit mode - transaction is commited in time.
+            with datastore.get_connection() as curs:
+                curs.execute("SELECT 1")
+                self.assertFalse(curs.closed)
+                sleep(2)
+
+    def test_get_password_func(self):
+        # Check correct password is required, wrong password causes operational error.
+        with PostgresDatastore(
+            dbname="eventsourcing",
+            host="127.0.0.1",
+            port="5432",
+            user="eventsourcing",
+            password="wrong",  # noqa: S106
+            pool_size=1,
+        ) as datastore:
+
+            conn: Connection
+            with self.assertRaises(
+                OperationalError
+            ), datastore.get_connection() as conn, conn.cursor() as curs:
+                curs.execute("SELECT 1")
+
+        # Define a "get password" function, with a generator that returns
+        # wrong password a few times first.
+        def password_token_generator():
+            yield "wrong"
+            yield "wrong"
+            yield "eventsourcing"
+
+        password_generator = password_token_generator()
+
+        def get_password_func():
+            return next(password_generator)
+
+        # Construct datastore with "get password" function.
+        with PostgresDatastore(
+            dbname="eventsourcing",
+            host="127.0.0.1",
+            port="5432",
+            user="eventsourcing",
+            password="",
+            pool_size=1,
+            get_password_func=get_password_func,
+            connect_timeout=10,
+        ) as datastore, datastore.get_connection() as conn, conn.cursor() as curs:
+            # Create a connection, and check it works (this test depends on psycopg
+            # retrying attempt to connect, should call "get password" twice).
+            curs.execute("SELECT 1")
+            self.assertEqual(curs.fetchall(), [{"?column?": 1}])
+
+
+# Use maximally long identifier for table name.
+EVENTS_TABLE_NAME = "s" * 50 + "stored_events"
+
+MAX_IDENTIFIER_LEN = 63
+
+
+def _check_identifier_is_max_len(identifier):
+    if len(identifier) != MAX_IDENTIFIER_LEN:
+        msg = "Expected length of name string to be max identifier length"
+        raise ValueError(msg)
+
+
+_check_identifier_is_max_len(EVENTS_TABLE_NAME)
+
+
+class SetupPostgresDatastore(TestCase):
+    schema = ""
+
+    def setUp(self) -> None:
+        super().setUp()
+        self.datastore = PostgresDatastore(
+            "eventsourcing",
+            "127.0.0.1",
+            "5432",
+            "eventsourcing",
+            "eventsourcing",
+            schema=self.schema,
+        )
+        self.drop_tables()
+
+    def tearDown(self) -> None:
+        super().tearDown()
+        self.drop_tables()
+        self.datastore.close()
+
+    def drop_tables(self):
+        events_table_name = EVENTS_TABLE_NAME
+        if self.datastore.schema:
+            events_table_name = f"{self.datastore.schema}.{events_table_name}"
+        drop_postgres_table(self.datastore, events_table_name)
+
+
+class WithSchema(SetupPostgresDatastore):
+    schema = "myschema"
+
+    def test_datastore_has_schema(self):
+        self.assertEqual(self.datastore.schema, self.schema)
+
+
+class TestPostgresAggregateRecorder(SetupPostgresDatastore, AggregateRecorderTestCase):
+    def create_recorder(
+        self, table_name=EVENTS_TABLE_NAME
+    ) -> PostgresAggregateRecorder:
+        if self.datastore.schema:
+            table_name = f"{self.datastore.schema}.{table_name}"
+        recorder = PostgresAggregateRecorder(
+            datastore=self.datastore, events_table_name=table_name
+        )
+        recorder.create_table()
+        return recorder
+
+    def drop_tables(self):
+        super().drop_tables()
+        drop_postgres_table(self.datastore, "stored_events")
+
+    def test_create_table(self):
+        recorder = PostgresAggregateRecorder(
+            datastore=self.datastore, events_table_name="stored_events"
+        )
+        recorder.create_table()
+
+    def test_insert_and_select(self):
+        super().test_insert_and_select()
+
+    def test_performance(self):
+        super().test_performance()
+
+    def test_retry_insert_events_after_closing_connection(self):
+        # This checks connection is recreated after connections are closed.
+        self.datastore.pool.pool_size = 1
+
+        # Construct the recorder.
+        recorder = self.create_recorder()
+
+        # Check we have open connections.
+        self.assertTrue(self.datastore.pool._pool)
+
+        # Close connections.
+        pg_close_all_connections()
+        self.assertFalse(self.datastore.pool._pool[0].closed)
+
+        # Write a stored event.
+        stored_event1 = StoredEvent(
+            originator_id=uuid4(),
+            originator_version=0,
+            topic="topic1",
+            state=b"state1",
+        )
+        recorder.insert_events([stored_event1])
+
+
+class TestPostgresAggregateRecorderWithSchema(
+    WithSchema, TestPostgresAggregateRecorder
+):
+    pass
+
+
+class TestPostgresAggregateRecorderErrors(SetupPostgresDatastore, TestCase):
+    def create_recorder(self, table_name=EVENTS_TABLE_NAME):
+        return PostgresAggregateRecorder(
+            datastore=self.datastore, events_table_name=table_name
+        )
+
+    def test_excessively_long_table_name_raises_error(self):
+        # Add one more character to the table name.
+        long_table_name = "s" + EVENTS_TABLE_NAME
+        self.assertEqual(len(long_table_name), 64)
+        with self.assertRaises(ProgrammingError):
+            self.create_recorder(long_table_name)
+
+    def test_create_table_raises_programming_error_when_sql_is_broken(self):
+        recorder = self.create_recorder()
+
+        # Mess up the statement.
+        recorder.create_table_statements = ["BLAH"]
+        with self.assertRaises(ProgrammingError):
+            recorder.create_table()
+
+    def test_insert_events_raises_programming_error_when_table_not_created(self):
+        # Construct the recorder.
+        recorder = self.create_recorder()
+
+        # Write a stored event without creating the table.
+        stored_event1 = StoredEvent(
+            originator_id=uuid4(),
+            originator_version=0,
+            topic="topic1",
+            state=b"state1",
+        )
+        with self.assertRaises(ProgrammingError):
+            recorder.insert_events([stored_event1])
+
+    def test_insert_events_raises_programming_error_when_sql_is_broken(self):
+        # Construct the recorder.
+        recorder = self.create_recorder()
+
+        # Create the table.
+        recorder.create_table()
+
+        # Write a stored event with broken statement.
+        recorder.insert_events_statement = "BLAH"
+        stored_event1 = StoredEvent(
+            originator_id=uuid4(),
+            originator_version=0,
+            topic="topic1",
+            state=b"state1",
+        )
+        with self.assertRaises(ProgrammingError):
+            recorder.insert_events([stored_event1])
+
+    def test_select_events_raises_programming_error_when_table_not_created(self):
+        # Construct the recorder.
+        recorder = self.create_recorder()
+
+        # Select events without creating the table.
+        originator_id = uuid4()
+        with self.assertRaises(ProgrammingError):
+            recorder.select_events(originator_id=originator_id)
+
+    def test_select_events_raises_programming_error_when_sql_is_broken(self):
+        # Construct the recorder.
+        recorder = self.create_recorder()
+
+        # Create the table.
+        recorder.create_table()
+
+        # Select events with broken statement.
+        recorder.select_events_statement = "BLAH"
+        originator_id = uuid4()
+        with self.assertRaises(ProgrammingError):
+            recorder.select_events(originator_id=originator_id)
+
+
+class TestPostgresApplicationRecorder(
+    SetupPostgresDatastore, ApplicationRecorderTestCase
+):
+    def create_recorder(
+        self, table_name=EVENTS_TABLE_NAME
+    ) -> PostgresApplicationRecorder:
+        if self.datastore.schema:
+            table_name = f"{self.datastore.schema}.{table_name}"
+        recorder = PostgresApplicationRecorder(
+            self.datastore, events_table_name=table_name
+        )
+        recorder.create_table()
+        return recorder
+
+    def test_insert_select(self) -> None:
+        super().test_insert_select()
+
+    def test_concurrent_no_conflicts(self):
+        super().test_concurrent_no_conflicts()
+
+    def test_concurrent_throughput(self):
+        self.datastore.pool.pool_size = 4
+        super().test_concurrent_throughput()
+
+    def test_retry_select_notifications_after_closing_connection(self):
+        # This checks connection is recreated after InterfaceError.
+
+        # Construct the recorder.
+        recorder = self.create_recorder()
+        self.datastore.pool.pool_size = 1
+
+        # Write a stored event.
+        originator_id = uuid4()
+        stored_event1 = StoredEvent(
+            originator_id=originator_id,
+            originator_version=0,
+            topic="topic1",
+            state=b"state1",
+        )
+        recorder.insert_events([stored_event1])
+
+        # Close connections.
+        pg_close_all_connections()
+        self.assertFalse(self.datastore.pool._pool[0].closed)
+
+        # Select events.
+        recorder.select_notifications(start=1, limit=1)
+
+    def test_retry_max_notification_id_after_closing_connection(self):
+        # This checks connection is recreated after InterfaceError.
+
+        # Construct the recorder.
+        recorder = self.create_recorder()
+        self.datastore.pool.pool_size = 1
+
+        # Write a stored event.
+        originator_id = uuid4()
+        stored_event1 = StoredEvent(
+            originator_id=originator_id,
+            originator_version=0,
+            topic="topic1",
+            state=b"state1",
+        )
+        recorder.insert_events([stored_event1])
+
+        # Close connections.
+        pg_close_all_connections()
+        self.assertFalse(self.datastore.pool._pool[0].closed)
+
+        # Get max notification ID.
+        recorder.max_notification_id()
+
+    def test_insert_lock_timeout_actually_works(self):
+        self.datastore.lock_timeout = 1
+        recorder: PostgresApplicationRecorder = self.create_recorder()
+
+        stored_event1 = StoredEvent(
+            originator_id=uuid4(),
+            originator_version=1,
+            topic="topic1",
+            state=b"state1",
+        )
+        stored_event2 = StoredEvent(
+            originator_id=uuid4(),
+            originator_version=1,
+            topic="topic1",
+            state=b"state1",
+        )
+
+        table_lock_acquired = Event()
+        test_ended = Event()
+        table_lock_timed_out = Event()
+
+        def insert1():
+            conn = self.datastore.get_connection()
+            with conn as conn, conn.transaction(), conn.cursor() as curs:
+                # Lock table.
+                recorder._insert_stored_events(curs, [stored_event1])
+                table_lock_acquired.set()
+                # Wait for other thread to timeout.
+                test_ended.wait(timeout=5)  # keep the lock
+
+        def insert2():
+            try:
+                conn: Connection
+                with self.datastore.get_connection() as conn:
+                    # Wait for other thread to lock table.
+                    table_lock_acquired.wait(timeout=5)
+                    # Expect to timeout.
+                    with conn.transaction(), conn.cursor() as curs:
+                        recorder._insert_stored_events(curs, [stored_event2])
+            except OperationalError as e:
+                if "lock timeout" in e.args[0]:
+                    table_lock_timed_out.set()
+
+        thread1 = Thread(target=insert1, daemon=True)
+        thread1.start()
+        thread2 = Thread(target=insert2, daemon=True)
+        thread2.start()
+
+        table_lock_timed_out.wait(timeout=4)
+        test_ended.set()
+
+        thread1.join(timeout=10)
+        thread2.join(timeout=10)
+
+        self.assertTrue(table_lock_timed_out.is_set())
+
+
+class TestPostgresApplicationRecorderWithSchema(
+    WithSchema, TestPostgresApplicationRecorder
+):
+    pass
+
+
+class TestPostgresApplicationRecorderErrors(SetupPostgresDatastore, TestCase):
+    def create_recorder(self, table_name=EVENTS_TABLE_NAME):
+        return PostgresApplicationRecorder(self.datastore, events_table_name=table_name)
+
+    def test_excessively_long_table_name_raises_error(self):
+        # Add one more character to the table name.
+        long_table_name = "s" + EVENTS_TABLE_NAME
+        self.assertEqual(len(long_table_name), 64)
+        with self.assertRaises(ProgrammingError):
+            self.create_recorder(long_table_name)
+
+    def test_select_notification_raises_programming_error_when_table_not_created(self):
+        # Construct the recorder.
+        recorder = self.create_recorder()
+
+        # Select notifications without creating table.
+        with self.assertRaises(ProgrammingError):
+            recorder.select_notifications(start=1, limit=1)
+
+    def test_max_notification_id_raises_programming_error_when_table_not_created(self):
+        # Construct the recorder.
+        recorder = PostgresApplicationRecorder(
+            datastore=self.datastore, events_table_name=EVENTS_TABLE_NAME
+        )
+
+        # Select notifications without creating table.
+        with self.assertRaises(ProgrammingError):
+            recorder.max_notification_id()
+
+    def test_fetch_ids_after_insert_events(self):
+        def make_events() -> List[StoredEvent]:
+            return [
+                StoredEvent(
+                    originator_id=uuid4(),
+                    originator_version=1,
+                    state=b"",
+                    topic="",
+                )
+            ]
+
+        #
+        # Check it actually works.
+        recorder = PostgresApplicationRecorder(
+            datastore=self.datastore, events_table_name=EVENTS_TABLE_NAME
+        )
+        recorder.create_table()
+        max_notification_id = recorder.max_notification_id()
+        notification_ids = recorder.insert_events(make_events())
+        self.assertEqual(len(notification_ids), 1)
+        self.assertEqual(max_notification_id + 1, notification_ids[0])
+
+        # Events but no lock table statements.
+        with self.assertRaises(ProgrammingError):
+            recorder = PostgresApplicationRecorder(
+                datastore=self.datastore, events_table_name=EVENTS_TABLE_NAME
+            )
+            recorder.create_table()
+            recorder.lock_table_statements = []
+            recorder.insert_events(make_events())
+
+
+TRACKING_TABLE_NAME = "n" * 42 + "notification_tracking"
+_check_identifier_is_max_len(TRACKING_TABLE_NAME)
+
+
+class TestPostgresProcessRecorder(SetupPostgresDatastore, ProcessRecorderTestCase):
+    def drop_tables(self):
+        super().drop_tables()
+        tracking_table_name = TRACKING_TABLE_NAME
+        if self.datastore.schema:
+            tracking_table_name = f"{self.datastore.schema}.{tracking_table_name}"
+        drop_postgres_table(self.datastore, tracking_table_name)
+
+    def create_recorder(self):
+        events_table_name = EVENTS_TABLE_NAME
+        tracking_table_name = TRACKING_TABLE_NAME
+        if self.datastore.schema:
+            events_table_name = f"{self.datastore.schema}.{events_table_name}"
+        if self.datastore.schema:
+            tracking_table_name = f"{self.datastore.schema}.{tracking_table_name}"
+        recorder = PostgresProcessRecorder(
+            datastore=self.datastore,
+            events_table_name=events_table_name,
+            tracking_table_name=tracking_table_name,
+        )
+        recorder.create_table()
+        return recorder
+
+    def test_insert_select(self):
+        super().test_insert_select()
+
+    def test_performance(self):
+        super().test_performance()
+
+    def test_excessively_long_table_names_raise_error(self):
+        with self.assertRaises(ProgrammingError):
+            PostgresProcessRecorder(
+                datastore=self.datastore,
+                events_table_name="e" + EVENTS_TABLE_NAME,
+                tracking_table_name=TRACKING_TABLE_NAME,
+            )
+
+        with self.assertRaises(ProgrammingError):
+            PostgresProcessRecorder(
+                datastore=self.datastore,
+                events_table_name=EVENTS_TABLE_NAME,
+                tracking_table_name="n" + TRACKING_TABLE_NAME,
+            )
+
+    def test_retry_max_tracking_id_after_closing_connection(self):
+        # This checks connection is recreated after InterfaceError.
+
+        # Construct the recorder.
+        recorder = self.create_recorder()
+        self.datastore.pool.pool_size = 1
+
+        # Write a tracking record.
+        originator_id = uuid4()
+        stored_event1 = StoredEvent(
+            originator_id=originator_id,
+            originator_version=0,
+            topic="topic1",
+            state=b"state1",
+        )
+        recorder.insert_events([stored_event1], tracking=Tracking("upstream", 1))
+
+        # Close connections.
+        pg_close_all_connections()
+        self.assertFalse(self.datastore.pool._pool[0].closed)
+
+        # Get max tracking ID.
+        notification_id = recorder.max_tracking_id("upstream")
+        self.assertEqual(notification_id, 1)
+
+
+class TestPostgresProcessRecorderWithSchema(WithSchema, TestPostgresProcessRecorder):
+    pass
+
+
+class TestPostgresProcessRecorderErrors(SetupPostgresDatastore, TestCase):
+    def drop_tables(self):
+        super().drop_tables()
+        drop_postgres_table(self.datastore, TRACKING_TABLE_NAME)
+
+    def create_recorder(self):
+        return PostgresProcessRecorder(
+            datastore=self.datastore,
+            events_table_name=EVENTS_TABLE_NAME,
+            tracking_table_name=TRACKING_TABLE_NAME,
+        )
+
+    def test_max_tracking_id_raises_programming_error_when_table_not_created(self):
+        # Construct the recorder.
+        recorder = self.create_recorder()
+
+        # Get max tracking ID without creating table.
+        with self.assertRaises(ProgrammingError):
+            recorder.max_tracking_id("upstream")
+
+
+class TestPostgresInfrastructureFactory(InfrastructureFactoryTestCase):
+    def test_create_application_recorder(self):
+        super().test_create_application_recorder()
+
+    def expected_factory_class(self):
+        return Factory
+
+    def expected_aggregate_recorder_class(self):
+        return PostgresAggregateRecorder
+
+    def expected_application_recorder_class(self):
+        return PostgresApplicationRecorder
+
+    def expected_process_recorder_class(self):
+        return PostgresProcessRecorder
+
+    def setUp(self) -> None:
+        self.env = Environment("TestCase")
+        self.env[InfrastructureFactory.PERSISTENCE_MODULE] = Factory.__module__
+        self.env[Factory.POSTGRES_DBNAME] = "eventsourcing"
+        self.env[Factory.POSTGRES_HOST] = "127.0.0.1"
+        self.env[Factory.POSTGRES_PORT] = "5432"
+        self.env[Factory.POSTGRES_USER] = "eventsourcing"
+        self.env[Factory.POSTGRES_PASSWORD] = "eventsourcing"
+        self.drop_tables()
+        super().setUp()
+
+    def tearDown(self) -> None:
+        self.drop_tables()
+        super().tearDown()
+
+    def drop_tables(self):
+        with PostgresDatastore(
+            "eventsourcing",
+            "127.0.0.1",
+            "5432",
+            "eventsourcing",
+            "eventsourcing",
+        ) as datastore:
+            drop_postgres_table(datastore, "testcase_events")
+            drop_postgres_table(datastore, "testcase_tracking")
+
+    def test_close(self):
+        factory = Factory(self.env)
+        conn: Connection
+        with factory.datastore.get_connection() as conn:
+            conn.execute("SELECT 1")
+        self.assertFalse(factory.datastore.pool.closed)
+        factory.close()
+        self.assertTrue(factory.datastore.pool.closed)
+
+    def test_conn_max_age_is_set_to_float(self):
+        self.env[Factory.POSTGRES_CONN_MAX_AGE] = ""
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pool.max_lifetime, 60 * 60.0)
+
+    def test_conn_max_age_is_set_to_number(self):
+        self.env[Factory.POSTGRES_CONN_MAX_AGE] = "0"
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pool.max_lifetime, 0)
+
+    def test_pool_size_is_five_by_default(self):
+        self.assertTrue(Factory.POSTGRES_POOL_SIZE not in self.env)
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pool.min_size, 5)
+
+        self.env[Factory.POSTGRES_POOL_SIZE] = ""
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pool.min_size, 5)
+
+    def test_max_overflow_is_ten_by_default(self):
+        self.assertTrue(Factory.POSTGRES_MAX_OVERFLOW not in self.env)
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pool.max_size, 15)
+
+        self.env[Factory.POSTGRES_MAX_OVERFLOW] = ""
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pool.max_size, 15)
+
+    def test_max_overflow_is_set(self):
+        self.env[Factory.POSTGRES_MAX_OVERFLOW] = "7"
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pool.max_size, 12)
+
+    def test_pool_size_is_set(self):
+        self.env[Factory.POSTGRES_POOL_SIZE] = "6"
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pool.min_size, 6)
+
+    def test_connect_timeout_is_thirty_by_default(self):
+        self.assertTrue(Factory.POSTGRES_CONNECT_TIMEOUT not in self.env)
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pool.timeout, 30)
+
+        self.env[Factory.POSTGRES_CONNECT_TIMEOUT] = ""
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pool.timeout, 30)
+
+    def test_connect_timeout_is_set(self):
+        self.env[Factory.POSTGRES_CONNECT_TIMEOUT] = "8"
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pool.timeout, 8)
+
+    def test_max_waiting_is_0_by_default(self):
+        self.assertTrue(Factory.POSTGRES_MAX_WAITING not in self.env)
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pool.max_waiting, 0)
+
+        self.env[Factory.POSTGRES_MAX_WAITING] = ""
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pool.max_waiting, 0)
+
+    def test_max_waiting_is_set(self):
+        self.env[Factory.POSTGRES_MAX_WAITING] = "8"
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pool.max_waiting, 8)
+
+    def test_lock_timeout_is_zero_by_default(self):
+        self.assertTrue(Factory.POSTGRES_LOCK_TIMEOUT not in self.env)
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.lock_timeout, 0)
+
+        self.env[Factory.POSTGRES_LOCK_TIMEOUT] = ""
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.lock_timeout, 0)
+
+    def test_lock_timeout_is_set(self):
+        self.env[Factory.POSTGRES_LOCK_TIMEOUT] = "1"
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.lock_timeout, 1)
+
+    def test_idle_in_transaction_session_timeout_is_5_by_default(self):
+        self.assertTrue(
+            Factory.POSTGRES_IDLE_IN_TRANSACTION_SESSION_TIMEOUT not in self.env
+        )
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.idle_in_transaction_session_timeout, 5)
+        self.factory.close()
+
+        self.env[Factory.POSTGRES_IDLE_IN_TRANSACTION_SESSION_TIMEOUT] = ""
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.idle_in_transaction_session_timeout, 5)
+
+    def test_idle_in_transaction_session_timeout_is_set(self):
+        self.env[Factory.POSTGRES_IDLE_IN_TRANSACTION_SESSION_TIMEOUT] = "10"
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.idle_in_transaction_session_timeout, 10)
+
+    def test_pre_ping_off_by_default(self):
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pre_ping, False)
+
+    def test_pre_ping_off(self):
+        self.env[Factory.POSTGRES_PRE_PING] = "off"
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pre_ping, False)
+
+    def test_pre_ping_on(self):
+        self.env[Factory.POSTGRES_PRE_PING] = "on"
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.pre_ping, True)
+
+    def test_get_password_topic_not_set(self):
+        self.factory = Factory(self.env)
+        self.assertIsNone(self.factory.datastore.pool.get_password_func, None)
+
+    def test_get_password_topic_set(self):
+        def get_password_func():
+            return "eventsourcing"
+
+        self.env[Factory.POSTGRES_GET_PASSWORD_TOPIC] = get_topic(get_password_func)
+        self.factory = Factory(self.env)
+        self.assertEqual(
+            self.factory.datastore.pool.get_password_func, get_password_func
+        )
+
+    def test_environment_error_raised_when_conn_max_age_not_a_float(self):
+        self.env[Factory.POSTGRES_CONN_MAX_AGE] = "abc"
+        with self.assertRaises(EnvironmentError) as cm:
+            Factory(self.env)
+        self.assertEqual(
+            cm.exception.args[0],
+            "Postgres environment value for key 'POSTGRES_CONN_MAX_AGE' "
+            "is invalid. If set, a float or empty string is expected: 'abc'",
+        )
+
+    def test_environment_error_raised_when_connect_timeout_not_an_integer(self):
+        self.env[Factory.POSTGRES_CONNECT_TIMEOUT] = "abc"
+        with self.assertRaises(EnvironmentError) as cm:
+            Factory(self.env)
+        self.assertEqual(
+            cm.exception.args[0],
+            "Postgres environment value for key 'POSTGRES_CONNECT_TIMEOUT' "
+            "is invalid. If set, an integer or empty string is expected: 'abc'",
+        )
+
+    def test_environment_error_raised_when_max_waiting_not_an_integer(self):
+        self.env[Factory.POSTGRES_MAX_WAITING] = "abc"
+        with self.assertRaises(EnvironmentError) as cm:
+            Factory(self.env)
+        self.assertEqual(
+            cm.exception.args[0],
+            "Postgres environment value for key 'POSTGRES_MAX_WAITING' "
+            "is invalid. If set, an integer or empty string is expected: 'abc'",
+        )
+
+    def test_environment_error_raised_when_lock_timeout_not_an_integer(self):
+        self.env[Factory.POSTGRES_LOCK_TIMEOUT] = "abc"
+        with self.assertRaises(EnvironmentError) as cm:
+            Factory(self.env)
+        self.assertEqual(
+            cm.exception.args[0],
+            "Postgres environment value for key 'POSTGRES_LOCK_TIMEOUT' "
+            "is invalid. If set, an integer or empty string is expected: 'abc'",
+        )
+
+    def test_environment_error_raised_when_min_conn_not_an_integer(self):
+        self.env[Factory.POSTGRES_POOL_SIZE] = "abc"
+        with self.assertRaises(EnvironmentError) as cm:
+            Factory(self.env)
+        self.assertEqual(
+            cm.exception.args[0],
+            "Postgres environment value for key 'POSTGRES_POOL_SIZE' "
+            "is invalid. If set, an integer or empty string is expected: 'abc'",
+        )
+
+    def test_environment_error_raised_when_max_conn_not_an_integer(self):
+        self.env[Factory.POSTGRES_MAX_OVERFLOW] = "abc"
+        with self.assertRaises(EnvironmentError) as cm:
+            Factory(self.env)
+        self.assertEqual(
+            cm.exception.args[0],
+            "Postgres environment value for key 'POSTGRES_MAX_OVERFLOW' "
+            "is invalid. If set, an integer or empty string is expected: 'abc'",
+        )
+
+    def test_environment_error_raised_when_idle_in_transaction_session_timeout_not_int(
+        self,
+    ):
+        self.env[Factory.POSTGRES_IDLE_IN_TRANSACTION_SESSION_TIMEOUT] = "abc"
+        with self.assertRaises(EnvironmentError) as cm:
+            Factory(self.env)
+        self.assertEqual(
+            cm.exception.args[0],
+            "Postgres environment value for key "
+            "'POSTGRES_IDLE_IN_TRANSACTION_SESSION_TIMEOUT' "
+            "is invalid. If set, an integer or empty string is expected: 'abc'",
+        )
+
+    def test_environment_error_raised_when_dbname_missing(self):
+        del self.env[Factory.POSTGRES_DBNAME]
+        with self.assertRaises(EnvironmentError) as cm:
+            InfrastructureFactory.construct(self.env)
+        self.assertEqual(
+            cm.exception.args[0],
+            "Postgres database name not found in environment "
+            "with key 'POSTGRES_DBNAME'",
+        )
+
+    def test_environment_error_raised_when_dbhost_missing(self):
+        del self.env[Factory.POSTGRES_HOST]
+        with self.assertRaises(EnvironmentError) as cm:
+            InfrastructureFactory.construct(self.env)
+        self.assertEqual(
+            cm.exception.args[0],
+            "Postgres host not found in environment with key 'POSTGRES_HOST'",
+        )
+
+    def test_environment_error_raised_when_user_missing(self):
+        del self.env[Factory.POSTGRES_USER]
+        with self.assertRaises(EnvironmentError) as cm:
+            InfrastructureFactory.construct(self.env)
+        self.assertEqual(
+            cm.exception.args[0],
+            "Postgres user not found in environment with key 'POSTGRES_USER'",
+        )
+
+    def test_environment_error_raised_when_password_missing(self):
+        del self.env[Factory.POSTGRES_PASSWORD]
+        with self.assertRaises(EnvironmentError) as cm:
+            InfrastructureFactory.construct(self.env)
+        self.assertEqual(
+            cm.exception.args[0],
+            "Postgres password not found in environment with key 'POSTGRES_PASSWORD'",
+        )
+
+    def test_schema_set_to_empty_string(self):
+        self.env[Factory.POSTGRES_SCHEMA] = ""
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.schema, "")
+
+    def test_schema_set_to_whitespace(self):
+        self.env[Factory.POSTGRES_SCHEMA] = " "
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.schema, "")
+
+    def test_scheme_adjusts_table_names_on_aggregate_recorder(self):
+        self.factory = Factory(self.env)
+
+        # Check by default the table name is not qualified.
+        recorder = self.factory.aggregate_recorder("events")
+        assert isinstance(recorder, PostgresAggregateRecorder)
+        self.assertEqual(recorder.events_table_name, "testcase_events")
+
+        # Check by default the table name is not qualified.
+        recorder = self.factory.aggregate_recorder("snapshots")
+        assert isinstance(recorder, PostgresAggregateRecorder)
+        self.assertEqual(recorder.events_table_name, "testcase_snapshots")
+
+        # Set schema in environment.
+        self.env[Factory.POSTGRES_SCHEMA] = "public"
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.schema, "public")
+
+        # Check by default the table name is qualified.
+        recorder = self.factory.aggregate_recorder("events")
+        assert isinstance(recorder, PostgresAggregateRecorder)
+        self.assertEqual(recorder.events_table_name, "public.testcase_events")
+
+        # Check by default the table name is qualified.
+        recorder = self.factory.aggregate_recorder("snapshots")
+        assert isinstance(recorder, PostgresAggregateRecorder)
+        self.assertEqual(recorder.events_table_name, "public.testcase_snapshots")
+
+    def test_scheme_adjusts_table_name_on_application_recorder(self):
+        self.factory = Factory(self.env)
+
+        # Check by default the table name is not qualified.
+        recorder = self.factory.application_recorder()
+        assert isinstance(recorder, PostgresApplicationRecorder)
+        self.assertEqual(recorder.events_table_name, "testcase_events")
+
+        # Set schema in environment.
+        self.env[Factory.POSTGRES_SCHEMA] = "public"
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.schema, "public")
+
+        # Check by default the table name is qualified.
+        recorder = self.factory.application_recorder()
+        assert isinstance(recorder, PostgresApplicationRecorder)
+        self.assertEqual(recorder.events_table_name, "public.testcase_events")
+
+    def test_scheme_adjusts_table_names_on_process_recorder(self):
+        self.factory = Factory(self.env)
+
+        # Check by default the table name is not qualified.
+        recorder = self.factory.process_recorder()
+        assert isinstance(recorder, PostgresProcessRecorder)
+        self.assertEqual(recorder.events_table_name, "testcase_events")
+        self.assertEqual(recorder.tracking_table_name, "testcase_tracking")
+
+        # Set schema in environment.
+        self.env[Factory.POSTGRES_SCHEMA] = "public"
+        self.factory = Factory(self.env)
+        self.assertEqual(self.factory.datastore.schema, "public")
+
+        # Check by default the table name is qualified.
+        recorder = self.factory.process_recorder()
+        assert isinstance(recorder, PostgresProcessRecorder)
+        self.assertEqual(recorder.events_table_name, "public.testcase_events")
+        self.assertEqual(recorder.tracking_table_name, "public.testcase_tracking")
+
+
+del AggregateRecorderTestCase
+del ApplicationRecorderTestCase
+del ProcessRecorderTestCase
+del InfrastructureFactoryTestCase
+del SetupPostgresDatastore
+del WithSchema
+del TestConnectionPool