eventsourcing 9.3.3__py3-none-any.whl → 9.3.5__py3-none-any.whl

eventsourcing/examples/test_parking_lot.py

@@ -1,206 +0,0 @@
-"""
-After Ed Blackburn's https://github.com/edblackburn/parking-lot/.
-"""
-
-from __future__ import annotations
-
-import re
-from dataclasses import dataclass
-from datetime import datetime, timedelta
-from typing import List, Type, cast
-from unittest import TestCase
-from uuid import NAMESPACE_URL, UUID, uuid5
-
-from eventsourcing.application import AggregateNotFoundError, Application
-from eventsourcing.domain import Aggregate, triggers
-from eventsourcing.system import NotificationLogReader
-
-
-@dataclass
-class LicencePlate:
-    number: str
-    regex = re.compile("^[0-9]{3}-[0-9]{3}$")
-
-    def __post_init__(self) -> None:
-        if not bool(self.regex.match(self.number)):
-            raise ValueError
-
-
-@dataclass
-class Booking:
-    start: datetime
-    finish: datetime
-
-
-class Product:
-    delta = timedelta()
-
-    @classmethod
-    def calc_finish(cls, start: datetime) -> datetime:
-        return start + cls.delta
-
-
-class EndOfDay(Product):
-    delta = timedelta(days=1, seconds=-1)
-
-
-class EndOfWeek(Product):
-    delta = timedelta(days=7, seconds=-1)
-
-
-class Vehicle(Aggregate):
-    class Event(Aggregate.Event):
-        pass
-
-    class Registered(Event, Aggregate.Created):
-        licence_plate_number: str
-
-    class Booked(Event):
-        start: datetime
-        finish: datetime
-
-    class Unbooked(Event):
-        when: datetime
-
-    @triggers(Registered)
-    def __init__(self, licence_plate_number: str):
-        self.licence_plate_number = licence_plate_number
-        self.bookings: List[Booking] = []
-        self.inspection_failures: List[datetime] = []
-
-    @triggers(Booked)
-    def book(self, start: datetime, finish: datetime) -> None:
-        self.bookings.append(Booking(start, finish))
-
-    @triggers(Unbooked)
-    def fail_inspection(self, when: datetime) -> None:
-        self.inspection_failures.append(when)
-
-    @property
-    def licence_plate(self) -> LicencePlate:
-        return LicencePlate(self.licence_plate_number)
-
-    def inspect(self, when: datetime) -> None:
-        for booking in self.bookings:
-            if booking.start < when < booking.finish:
-                break
-        else:
-            self.fail_inspection(when)
-
-    @staticmethod
-    def create_id(licence_plate_number: str) -> UUID:
-        return uuid5(NAMESPACE_URL, f"/licence_plate_numbers/{licence_plate_number}")
-
-
-class ParkingLot(Application):
-    def book(self, licence_plate: LicencePlate, product: Type[Product]) -> None:
-        try:
-            vehicle = self.get_vehicle(licence_plate)
-        except AggregateNotFoundError:
-            vehicle = Vehicle(licence_plate.number)
-        start = Vehicle.Event.create_timestamp()
-        finish = product.calc_finish(start)
-        vehicle.book(start=start, finish=finish)
-        self.save(vehicle)
-
-    def inspect(self, licence_plate: LicencePlate, when: datetime) -> None:
-        vehicle = self.get_vehicle(licence_plate)
-        vehicle.inspect(when)
-        self.save(vehicle)
-
-    def get_vehicle(self, licence_plate: LicencePlate) -> Vehicle:
-        return cast(
-            Vehicle, self.repository.get(Vehicle.create_id(licence_plate.number))
-        )
-
-
-class TestParkingLot(TestCase):
-    def test_licence_plate(self) -> None:
-        # Valid.
-        licence_plate = LicencePlate("123-123")
-        self.assertIsInstance(licence_plate, LicencePlate)
-        self.assertEqual(licence_plate.number, "123-123")
-
-        # Invalid.
-        with self.assertRaises(ValueError):
-            LicencePlate("abcdef")
-
-    def test_parking_lot(self) -> None:
-        # Construct the application object to use an SQLite database.
-        app = ParkingLot(
-            env={
-                "PERSISTENCE_MODULE": "eventsourcing.sqlite",
-                "SQLITE_DBNAME": ":memory:",
-            }
-        )
-
-        # Create a valid licence plate.
-        licence_plate = LicencePlate("123-123")
-
-        # Book unregistered vehicle.
-        app.book(licence_plate, EndOfDay)
-
-        # Check vehicle state.
-        vehicle = app.get_vehicle(licence_plate)
-        self.assertEqual(vehicle.licence_plate, licence_plate)
-        self.assertEqual(len(vehicle.bookings), 1)
-        self.assertEqual(len(vehicle.inspection_failures), 0)
-        booking1 = vehicle.bookings[-1]
-
-        # Book registered vehicle.
-        app.book(licence_plate, EndOfWeek)
-
-        # Check vehicle state.
-        vehicle = app.get_vehicle(licence_plate)
-        self.assertEqual(len(vehicle.bookings), 2)
-        self.assertEqual(len(vehicle.inspection_failures), 0)
-        booking2 = vehicle.bookings[-1]
-
-        # Inspect whilst has booking.
-        app.inspect(licence_plate, Vehicle.Event.create_timestamp())
-
-        # Check vehicle state.
-        vehicle = app.get_vehicle(licence_plate)
-        self.assertEqual(len(vehicle.bookings), 2)
-        self.assertEqual(len(vehicle.inspection_failures), 0)
-
-        # Inspect after bookings expired.
-        inspected_on = Vehicle.Event.create_timestamp() + timedelta(days=10)
-        app.inspect(licence_plate, inspected_on)
-
-        # Check vehicle state.
-        vehicle = app.get_vehicle(licence_plate)
-        self.assertEqual(len(vehicle.bookings), 2)
-        self.assertEqual(len(vehicle.inspection_failures), 1)
-
-        # Check all domain events in bounded context.
-        notifications = NotificationLogReader(app.notification_log).read(start=1)
-        domain_events = [app.mapper.to_domain_event(n) for n in notifications]
-        self.assertEqual(len(domain_events), 4)
-
-        vehicle1_id = Vehicle.create_id("123-123")
-        event0 = domain_events[0]
-        assert isinstance(event0, Vehicle.Registered)
-        self.assertEqual(event0.originator_id, vehicle1_id)
-        self.assertEqual(event0.originator_version, 1)
-        self.assertEqual(event0.licence_plate_number, "123-123")
-
-        event1 = domain_events[1]
-        assert isinstance(event1, Vehicle.Booked)
-        self.assertEqual(event1.originator_id, vehicle1_id)
-        self.assertEqual(event1.originator_version, 2)
-        self.assertEqual(event1.start, booking1.start)
-        self.assertEqual(event1.finish, booking1.finish)
-
-        event2 = domain_events[2]
-        assert isinstance(event2, Vehicle.Booked)
-        self.assertEqual(event2.originator_id, vehicle1_id)
-        self.assertEqual(event2.originator_version, 3)
-        self.assertEqual(event2.start, booking2.start)
-        self.assertEqual(event2.finish, booking2.finish)
-
-        event3 = domain_events[3]
-        assert isinstance(event3, Vehicle.Unbooked)
-        self.assertEqual(event3.originator_id, vehicle1_id)
-        self.assertEqual(event3.originator_version, 4)
-        self.assertEqual(event3.when, inspected_on)

eventsourcing/tests/application_tests/test_application_with_automatic_snapshotting.py

@@ -1,55 +0,0 @@
-from __future__ import annotations
-
-from decimal import Decimal
-from typing import ClassVar, Dict, Type
-from unittest import TestCase
-
-from eventsourcing.domain import Aggregate, MutableOrImmutableAggregate
-from eventsourcing.tests.application import BankAccounts
-from eventsourcing.tests.domain import BankAccount
-
-
-class BankAccountsWithAutomaticSnapshotting(BankAccounts):
-    is_snapshotting_enabled = False
-    snapshotting_intervals: ClassVar[
-        Dict[Type[MutableOrImmutableAggregate], int] | None
-    ] = {BankAccount: 5}
-
-
-class TestApplicationWithAutomaticSnapshotting(TestCase):
-    def test(self):
-        app = BankAccountsWithAutomaticSnapshotting()
-
-        # Check snapshotting is enabled by setting snapshotting_intervals only.
-        self.assertTrue(app.snapshots)
-
-        # Open an account.
-        account_id = app.open_account("Alice", "alice@example.com")
-
-        # Check there are no snapshots.
-        snapshots = list(app.snapshots.get(account_id))
-        self.assertEqual(len(snapshots), 0)
-
-        # Trigger twelve more events.
-        for _ in range(12):
-            app.credit_account(account_id, Decimal("10.00"))
-
-        # Check the account is at version 13.
-        account = app.get_account(account_id)
-        self.assertEqual(account.version, 13)
-
-        # Check snapshots have been taken at regular intervals.
-        snapshots = list(app.snapshots.get(account_id))
-        self.assertEqual(len(snapshots), 2)
-        self.assertEqual(snapshots[0].originator_version, 5)
-        self.assertEqual(snapshots[1].originator_version, 10)
-
-        # Check another type of aggregate is not snapshotted.
-        aggregate = Aggregate()
-        for _ in range(10):
-            aggregate.trigger_event(Aggregate.Event)
-        app.save(aggregate)
-
-        # Check snapshots have not been taken at regular intervals.
-        snapshots = list(app.snapshots.get(aggregate.id))
-        self.assertEqual(len(snapshots), 0)

eventsourcing/tests/application_tests/test_application_with_popo.py

@@ -1,22 +0,0 @@
-from eventsourcing.tests.application import (
-    TIMEIT_FACTOR,
-    ApplicationTestCase,
-    ExampleApplicationTestCase,
-)
-
-
-class TestApplicationWithPOPO(ApplicationTestCase):
-    def test_application_fastforward_skipping_during_contention(self):
-        self.skipTest("POPO is too fast for this test to work")
-
-    def test_application_fastforward_blocking_during_contention(self):
-        self.skipTest("POPO is too fast for this test to make sense")
-
-
-class TestExampleApplicationWithPOPO(ExampleApplicationTestCase):
-    timeit_number = 100 * TIMEIT_FACTOR
-    expected_factory_topic = "eventsourcing.popo:Factory"
-
-
-del ApplicationTestCase
-del ExampleApplicationTestCase

eventsourcing/tests/application_tests/test_application_with_postgres.py

@@ -1,75 +0,0 @@
-import os
-from unittest import TestCase
-
-from eventsourcing.postgres import PostgresDatastore
-from eventsourcing.tests.application import (
-    TIMEIT_FACTOR,
-    ApplicationTestCase,
-    ExampleApplicationTestCase,
-)
-from eventsourcing.tests.postgres_utils import drop_postgres_table
-
-
-class WithPostgres(TestCase):
-    timeit_number = 5 * TIMEIT_FACTOR
-    expected_factory_topic = "eventsourcing.postgres:Factory"
-
-    def setUp(self) -> None:
-        super().setUp()
-
-        os.environ["PERSISTENCE_MODULE"] = "eventsourcing.postgres"
-        os.environ["CREATE_TABLE"] = "y"
-        os.environ["POSTGRES_DBNAME"] = "eventsourcing"
-        os.environ["POSTGRES_HOST"] = "127.0.0.1"
-        os.environ["POSTGRES_PORT"] = "5432"
-        os.environ["POSTGRES_USER"] = "eventsourcing"
-        os.environ["POSTGRES_PASSWORD"] = "eventsourcing"  # noqa: S105
-        os.environ["POSTGRES_SCHEMA"] = "public"
-
-        db = PostgresDatastore(
-            os.getenv("POSTGRES_DBNAME"),
-            os.getenv("POSTGRES_HOST"),
-            os.getenv("POSTGRES_PORT"),
-            os.getenv("POSTGRES_USER"),
-            os.getenv("POSTGRES_PASSWORD"),
-        )
-        drop_postgres_table(db, "public.bankaccounts_events")
-        drop_postgres_table(db, "public.bankaccounts_snapshots")
-        db.close()
-
-    def tearDown(self) -> None:
-        db = PostgresDatastore(
-            os.getenv("POSTGRES_DBNAME"),
-            os.getenv("POSTGRES_HOST"),
-            os.getenv("POSTGRES_PORT"),
-            os.getenv("POSTGRES_USER"),
-            os.getenv("POSTGRES_PASSWORD"),
-        )
-        drop_postgres_table(db, "public.bankaccounts_events")
-        drop_postgres_table(db, "public.bankaccounts_snapshots")
-
-        del os.environ["PERSISTENCE_MODULE"]
-        del os.environ["CREATE_TABLE"]
-        del os.environ["POSTGRES_DBNAME"]
-        del os.environ["POSTGRES_HOST"]
-        del os.environ["POSTGRES_PORT"]
-        del os.environ["POSTGRES_USER"]
-        del os.environ["POSTGRES_PASSWORD"]
-        del os.environ["POSTGRES_SCHEMA"]
-        db.close()
-
-        super().tearDown()
-
-
-class TestApplicationWithPostgres(ApplicationTestCase, WithPostgres):
-    pass
-
-
-class TestExampleApplicationWithPostgres(ExampleApplicationTestCase, WithPostgres):
-    timeit_number = 5 * TIMEIT_FACTOR
-    expected_factory_topic = "eventsourcing.postgres:Factory"
-
-
-del ApplicationTestCase
-del ExampleApplicationTestCase
-del WithPostgres

eventsourcing/tests/application_tests/test_application_with_sqlite.py

@@ -1,72 +0,0 @@
-import os
-from unittest import TestCase
-
-from eventsourcing.tests.application import (
-    TIMEIT_FACTOR,
-    ApplicationTestCase,
-    ExampleApplicationTestCase,
-)
-from eventsourcing.tests.persistence import tmpfile_uris
-
-
-class WithSQLiteFile(TestCase):
-    timeit_number = 30 * TIMEIT_FACTOR
-    expected_factory_topic = "eventsourcing.sqlite:Factory"
-
-    def setUp(self) -> None:
-        super().setUp()
-        self.uris = tmpfile_uris()
-        # self.db_uri = next(self.uris)
-
-        os.environ["PERSISTENCE_MODULE"] = "eventsourcing.sqlite"
-        os.environ["CREATE_TABLE"] = "y"
-        os.environ["SQLITE_DBNAME"] = next(self.uris)
-
-    def tearDown(self) -> None:
-        del os.environ["PERSISTENCE_MODULE"]
-        del os.environ["CREATE_TABLE"]
-        del os.environ["SQLITE_DBNAME"]
-        super().tearDown()
-
-
-class WithSQLiteInMemory(TestCase):
-    timeit_number = 30 * TIMEIT_FACTOR
-    expected_factory_topic = "eventsourcing.sqlite:Factory"
-
-    def setUp(self) -> None:
-        super().setUp()
-        os.environ["PERSISTENCE_MODULE"] = "eventsourcing.sqlite"
-        os.environ["CREATE_TABLE"] = "y"
-        os.environ["SQLITE_DBNAME"] = "file:memory:?mode=memory&cache=shared"
-
-    def tearDown(self) -> None:
-        del os.environ["PERSISTENCE_MODULE"]
-        del os.environ["CREATE_TABLE"]
-        del os.environ["SQLITE_DBNAME"]
-        super().tearDown()
-
-
-class TestApplicationWithSQLiteFile(ApplicationTestCase, WithSQLiteFile):
-    pass
-
-
-# class TestApplicationWithSQLiteInMemory(TestApplication, WithSQLiteInMemory):
-#     pass
-
-
-class TestExampleApplicationWithSQLiteFile(ExampleApplicationTestCase, WithSQLiteFile):
-    timeit_number = 30 * TIMEIT_FACTOR
-    expected_factory_topic = "eventsourcing.sqlite:Factory"
-
-
-class TestExampleApplicationWithSQLiteInMemory(
-    ExampleApplicationTestCase, WithSQLiteInMemory
-):
-    timeit_number = 30 * TIMEIT_FACTOR
-    expected_factory_topic = "eventsourcing.sqlite:Factory"
-
-
-del ApplicationTestCase
-del ExampleApplicationTestCase
-del WithSQLiteFile
-del WithSQLiteInMemory

eventsourcing/tests/application_tests/test_cache.py

@@ -1,134 +0,0 @@
-from unittest import TestCase
-
-from eventsourcing.application import Cache, LRUCache
-
-
-class TestCache(TestCase):
-    def test_put_get(self):
-        cache = Cache()
-
-        with self.assertRaises(KeyError):
-            cache.get(1)
-
-        cache.put(1, 1)
-        self.assertEqual(cache.get(1), 1)
-
-        cache.put(2, 2)
-        self.assertEqual(1, cache.get(1))
-        self.assertEqual(2, cache.get(2))
-
-        cache.put(3, 3)
-        self.assertEqual(3, cache.get(3))
-        self.assertEqual(2, cache.get(2))
-        self.assertEqual(1, cache.get(1))
-
-        cache.put(1, 2)
-        self.assertEqual(2, cache.get(1))
-        cache.put(1, 3)
-        self.assertEqual(3, cache.get(1))
-
-        cache.get(1, evict=True)
-        with self.assertRaises(KeyError):
-            cache.get(1)
-
-        cache.put(1, None)
-        with self.assertRaises(KeyError):
-            cache.get(1)
-
-
-class TestLRUCache(TestCase):
-    def test_put_get(self):
-        cache = LRUCache(maxsize=2)
-
-        with self.assertRaises(KeyError):
-            cache.get(1)
-
-        evicted = cache.put(1, 1)
-        self.assertEqual(evicted, (None, None))
-        self.assertEqual(cache.get(1), 1)
-
-        evicted = cache.put(2, 2)
-        self.assertEqual(evicted, (None, None))
-        self.assertEqual(1, cache.get(1))
-        self.assertEqual(2, cache.get(2))
-
-        evicted = cache.put(3, 3)
-        self.assertEqual(evicted, (1, 1))
-
-        self.assertEqual(3, cache.get(3))
-        self.assertEqual(2, cache.get(2))
-
-        cache.put(1, 1)
-        self.assertEqual(1, cache.get(1))
-        cache.put(1, 2)
-        self.assertEqual(2, cache.get(1))
-        cache.put(1, 3)
-        self.assertEqual(3, cache.get(1))
-
-    def test_put_get_evict_recent(self):
-        cache = LRUCache(maxsize=3)
-
-        cache.put(1, 1)
-        self.assertEqual(1, cache.get(1))
-        self.assertEqual(1, cache.get(1))
-        self.assertEqual(1, cache.get(1, evict=True))
-
-        with self.assertRaises(KeyError):
-            self.assertEqual(1, cache.get(1))
-
-        cache.put(1, 1)
-        cache.put(2, 2)
-        cache.put(3, 3)
-        evicted = cache.put(4, 4)
-        self.assertEqual(evicted, (1, 1))
-
-        self.assertEqual(3, cache.get(3, evict=True))
-
-        evicted = cache.put(5, 5)
-        self.assertEqual(evicted, (None, None))
-
-        evicted = cache.put(6, 6)
-        self.assertEqual(evicted, (2, 2))
-
-        evicted = cache.put(7, 7)
-        self.assertEqual(evicted, (4, 4))
-
-    def test_put_get_evict_oldest(self):
-        cache = LRUCache(maxsize=3)
-
-        cache.put(1, 1)
-        cache.put(2, 2)
-        cache.put(3, 3)
-        self.assertEqual(1, cache.get(1, evict=True))
-
-        evicted = cache.put(4, 4)
-        self.assertEqual(evicted, (None, None))
-
-        evicted = cache.put(5, 5)
-        self.assertEqual(evicted, (2, 2))
-
-        evicted = cache.put(6, 6)
-        self.assertEqual(evicted, (3, 3))
-
-        evicted = cache.put(7, 7)
-        self.assertEqual(evicted, (4, 4))
-
-    def test_put_get_evict_newest(self):
-        cache = LRUCache(maxsize=3)
-
-        cache.put(1, 1)
-        cache.put(2, 2)
-        cache.put(3, 3)
-        self.assertEqual(3, cache.get(3, evict=True))
-
-        evicted = cache.put(4, 4)
-        self.assertEqual(evicted, (None, None))
-
-        evicted = cache.put(5, 5)
-        self.assertEqual(evicted, (1, 1))
-
-        evicted = cache.put(6, 6)
-        self.assertEqual(evicted, (2, 2))
-
-        evicted = cache.put(7, 7)
-        self.assertEqual(evicted, (4, 4))