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

{eventsourcing-9.3.3.dist-info → eventsourcing-9.3.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: eventsourcing
-Version: 9.3.3
+Version: 9.3.4
 Summary: Event sourcing in Python
 Home-page: https://github.com/pyeventsourcing/eventsourcing
 License: BSD 3-Clause

eventsourcing-9.3.4.dist-info/RECORD

@@ -0,0 +1,24 @@
+eventsourcing/__init__.py,sha256=st2H3shrhTk5rqoUeZHUW8XD9iOX9tGGtQFWr2HGYmo,26
+eventsourcing/application.py,sha256=c5aTi86mBOiQicmqEUsqseAeL7CwDie3G9e0Y8kWLYM,36324
+eventsourcing/cipher.py,sha256=NJcVfZdSlCER6xryM4zVoY3cmKstF-iSSniB4jmpaKg,3200
+eventsourcing/compressor.py,sha256=IdvrJUB9B2td871oifInv4lGXmHwYL9d69MbHHCr7uI,421
+eventsourcing/dispatch.py,sha256=yYSpT-jqc6l_wTdqEnfPJJfvsZN2Ta8g2anrVPWIcqQ,1412
+eventsourcing/domain.py,sha256=rvm4Sv2MmLcha8_5wqJ13AjmqyWvuzkquYsexUaePIg,57264
+eventsourcing/interface.py,sha256=KzDWLeIkREf-TAFl5AFHtKJwJFA-IthqMKClFkUFqdc,4676
+eventsourcing/persistence.py,sha256=TJseAtsWwdC33XLvcoyHdgwTv6s6KsvQS8XLKIq472s,37672
+eventsourcing/popo.py,sha256=AApSGneHuXa8yHOWdDfsFTMVDI-9ivEpuKTX1BSOXr8,6547
+eventsourcing/postgres.py,sha256=NatfdA-YQQPB1qWsQg23Uhyy6R-hcGNOJHJ1bKmFuKQ,29772
+eventsourcing/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eventsourcing/sqlite.py,sha256=jz7SZk26Gcsjw88KL1xnr4-1tStTW16f1NR6TjMsZnQ,18466
+eventsourcing/system.py,sha256=il05rAzPtKaxragIktMBOEyWGhz16VK0F7cEBlsl4_Q,45561
+eventsourcing/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+eventsourcing/tests/application.py,sha256=wBanhWzAZvL3fYxCFe5cloN-Up7uLw6KcdRQ2dhKVAg,17586
+eventsourcing/tests/domain.py,sha256=lHSlY6jIoSeqlcPSbrrozEPUJGvJ8bgPrznlmzTxn2w,3254
+eventsourcing/tests/persistence.py,sha256=giLWEZDdViXY8_SHCJerJ0sYVbJUP3UkLKaEbel9sqs,45777
+eventsourcing/tests/postgres_utils.py,sha256=xymcGYasUXeZTBenkHz-ykD8HtrFjVM1Z7-qRrH6OQk,1364
+eventsourcing/utils.py,sha256=PIWDvoGiKCXsNbR5DirkoJ_svopg80SoH37bqxOcjkU,8247
+eventsourcing-9.3.4.dist-info/AUTHORS,sha256=8aHOM4UbNZcKlD-cHpFRcM6RWyCqtwtxRev6DeUgVRs,137
+eventsourcing-9.3.4.dist-info/LICENSE,sha256=bSE_F-T6cQPmMY5LuJC27km_pGB1XCVuUFx1uY0Nueg,1512
+eventsourcing-9.3.4.dist-info/METADATA,sha256=zGQTtZA_1u5kZOUW7wy5a86JHQoVU4j5tJR1OaIaLFo,9734
+eventsourcing-9.3.4.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+eventsourcing-9.3.4.dist-info/RECORD,,

eventsourcing/examples/aggregate1/application.py

@@ -1,27 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Any, Dict
-
-from eventsourcing.application import Application
-from eventsourcing.examples.aggregate1.domainmodel import Dog
-
-if TYPE_CHECKING:  # pragma: nocover
-    from uuid import UUID
-
-
-class DogSchool(Application):
-    is_snapshotting_enabled = True
-
-    def register_dog(self, name: str) -> UUID:
-        dog = Dog(name)
-        self.save(dog)
-        return dog.id
-
-    def add_trick(self, dog_id: UUID, trick: str) -> None:
-        dog: Dog = self.repository.get(dog_id)
-        dog.add_trick(trick)
-        self.save(dog)
-
-    def get_dog(self, dog_id: UUID) -> Dict[str, Any]:
-        dog: Dog = self.repository.get(dog_id)
-        return {"name": dog.name, "tricks": tuple(dog.tricks)}

eventsourcing/examples/aggregate1/domainmodel.py

@@ -1,16 +0,0 @@
-from __future__ import annotations
-
-from typing import List
-
-from eventsourcing.domain import Aggregate, event
-
-
-class Dog(Aggregate):
-    @event("Registered")
-    def __init__(self, name: str) -> None:
-        self.name = name
-        self.tricks: List[str] = []
-
-    @event("TrickAdded")
-    def add_trick(self, trick: str) -> None:
-        self.tricks.append(trick)

eventsourcing/examples/aggregate1/test_application.py

@@ -1,37 +0,0 @@
-from __future__ import annotations
-
-from unittest import TestCase
-
-from eventsourcing.examples.aggregate1.application import DogSchool
-
-
-class TestDogSchool(TestCase):
-    def test_dog_school(self) -> None:
-        # Construct application object.
-        school = DogSchool()
-
-        # Evolve application state.
-        dog_id = school.register_dog("Fido")
-        school.add_trick(dog_id, "roll over")
-        school.add_trick(dog_id, "play dead")
-
-        # Query application state.
-        dog = school.get_dog(dog_id)
-        assert dog["name"] == "Fido"
-        assert dog["tricks"] == ("roll over", "play dead")
-
-        # Select notifications.
-        notifications = school.notification_log.select(start=1, limit=10)
-        assert len(notifications) == 3
-
-        # Take snapshot.
-        school.take_snapshot(dog_id, version=3)
-        dog = school.get_dog(dog_id)
-        assert dog["name"] == "Fido"
-        assert dog["tricks"] == ("roll over", "play dead")
-
-        # Continue with snapshotted aggregate.
-        school.add_trick(dog_id, "fetch ball")
-        dog = school.get_dog(dog_id)
-        assert dog["name"] == "Fido"
-        assert dog["tricks"] == ("roll over", "play dead", "fetch ball")

eventsourcing/examples/aggregate2/application.py

@@ -1,27 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Any, Dict
-
-from eventsourcing.application import Application
-from eventsourcing.examples.aggregate2.domainmodel import Dog
-
-if TYPE_CHECKING:  # pragma: nocover
-    from uuid import UUID
-
-
-class DogSchool(Application):
-    is_snapshotting_enabled = True
-
-    def register_dog(self, name: str) -> UUID:
-        dog = Dog(name)
-        self.save(dog)
-        return dog.id
-
-    def add_trick(self, dog_id: UUID, trick: str) -> None:
-        dog: Dog = self.repository.get(dog_id)
-        dog.add_trick(trick)
-        self.save(dog)
-
-    def get_dog(self, dog_id: UUID) -> Dict[str, Any]:
-        dog: Dog = self.repository.get(dog_id)
-        return {"name": dog.name, "tricks": tuple(dog.tricks)}

eventsourcing/examples/aggregate2/domainmodel.py

@@ -1,22 +0,0 @@
-from __future__ import annotations
-
-from typing import List
-
-from eventsourcing.domain import Aggregate, event
-
-
-class Dog(Aggregate):
-    class Registered(Aggregate.Created):
-        name: str
-
-    class TrickAdded(Aggregate.Event):
-        trick: str
-
-    @event(Registered)
-    def __init__(self, name: str) -> None:
-        self.name = name
-        self.tricks: List[str] = []
-
-    @event(TrickAdded)
-    def add_trick(self, trick: str) -> None:
-        self.tricks.append(trick)

eventsourcing/examples/aggregate2/test_application.py

@@ -1,37 +0,0 @@
-from __future__ import annotations
-
-from unittest import TestCase
-
-from eventsourcing.examples.aggregate2.application import DogSchool
-
-
-class TestDogSchool(TestCase):
-    def test_dog_school(self) -> None:
-        # Construct application object.
-        school = DogSchool()
-
-        # Evolve application state.
-        dog_id = school.register_dog("Fido")
-        school.add_trick(dog_id, "roll over")
-        school.add_trick(dog_id, "play dead")
-
-        # Query application state.
-        dog = school.get_dog(dog_id)
-        assert dog["name"] == "Fido"
-        assert dog["tricks"] == ("roll over", "play dead")
-
-        # Select notifications.
-        notifications = school.notification_log.select(start=1, limit=10)
-        assert len(notifications) == 3
-
-        # Take snapshot.
-        school.take_snapshot(dog_id, version=3)
-        dog = school.get_dog(dog_id)
-        assert dog["name"] == "Fido"
-        assert dog["tricks"] == ("roll over", "play dead")
-
-        # Continue with snapshotted aggregate.
-        school.add_trick(dog_id, "fetch ball")
-        dog = school.get_dog(dog_id)
-        assert dog["name"] == "Fido"
-        assert dog["tricks"] == ("roll over", "play dead", "fetch ball")

eventsourcing/examples/aggregate3/application.py

@@ -1,27 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Any, Dict
-
-from eventsourcing.application import Application
-from eventsourcing.examples.aggregate3.domainmodel import Dog
-
-if TYPE_CHECKING:  # pragma: nocover
-    from uuid import UUID
-
-
-class DogSchool(Application):
-    is_snapshotting_enabled = True
-
-    def register_dog(self, name: str) -> UUID:
-        dog = Dog.register(name=name)
-        self.save(dog)
-        return dog.id
-
-    def add_trick(self, dog_id: UUID, trick: str) -> None:
-        dog: Dog = self.repository.get(dog_id)
-        dog.add_trick(trick)
-        self.save(dog)
-
-    def get_dog(self, dog_id: UUID) -> Dict[str, Any]:
-        dog: Dog = self.repository.get(dog_id)
-        return {"name": dog.name, "tricks": tuple(dog.tricks)}

eventsourcing/examples/aggregate3/domainmodel.py

@@ -1,38 +0,0 @@
-from __future__ import annotations
-
-from typing import List, cast
-
-from eventsourcing.dispatch import singledispatchmethod
-from eventsourcing.domain import Aggregate
-
-
-class Dog(Aggregate):
-    class Event(Aggregate.Event):
-        def apply(self, aggregate: Aggregate) -> None:
-            cast(Dog, aggregate).apply(self)
-
-    class Registered(Event, Aggregate.Created):
-        name: str
-
-    class TrickAdded(Event):
-        trick: str
-
-    @classmethod
-    def register(cls, name: str) -> Dog:
-        return cls._create(cls.Registered, name=name)
-
-    def add_trick(self, trick: str) -> None:
-        self.trigger_event(self.TrickAdded, trick=trick)
-
-    @singledispatchmethod
-    def apply(self, event: Event) -> None:
-        """Applies event to aggregate."""
-
-    @apply.register
-    def _(self, event: Dog.Registered) -> None:
-        self.name = event.name
-        self.tricks: List[str] = []
-
-    @apply.register
-    def _(self, event: Dog.TrickAdded) -> None:
-        self.tricks.append(event.trick)

eventsourcing/examples/aggregate3/test_application.py

@@ -1,37 +0,0 @@
-from __future__ import annotations
-
-from unittest import TestCase
-
-from eventsourcing.examples.aggregate3.application import DogSchool
-
-
-class TestDogSchool(TestCase):
-    def test_dog_school(self) -> None:
-        # Construct application object.
-        school = DogSchool()
-
-        # Evolve application state.
-        dog_id = school.register_dog("Fido")
-        school.add_trick(dog_id, "roll over")
-        school.add_trick(dog_id, "play dead")
-
-        # Query application state.
-        dog = school.get_dog(dog_id)
-        assert dog["name"] == "Fido"
-        assert dog["tricks"] == ("roll over", "play dead")
-
-        # Select notifications.
-        notifications = school.notification_log.select(start=1, limit=10)
-        assert len(notifications) == 3
-
-        # Take snapshot.
-        school.take_snapshot(dog_id, version=3)
-        dog = school.get_dog(dog_id)
-        assert dog["name"] == "Fido"
-        assert dog["tricks"] == ("roll over", "play dead")
-
-        # Continue with snapshotted aggregate.
-        school.add_trick(dog_id, "fetch ball")
-        dog = school.get_dog(dog_id)
-        assert dog["name"] == "Fido"
-        assert dog["tricks"] == ("roll over", "play dead", "fetch ball")

eventsourcing/examples/aggregate4/application.py

@@ -1,27 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Any, Dict
-
-from eventsourcing.application import Application
-from eventsourcing.examples.aggregate4.domainmodel import Dog
-
-if TYPE_CHECKING:  # pragma: nocover
-    from uuid import UUID
-
-
-class DogSchool(Application):
-    is_snapshotting_enabled = True
-
-    def register_dog(self, name: str) -> UUID:
-        dog = Dog.register(name)
-        self.save(dog)
-        return dog.id
-
-    def add_trick(self, dog_id: UUID, trick: str) -> None:
-        dog = self.repository.get(dog_id, projector_func=Dog.projector)
-        dog.add_trick(trick)
-        self.save(dog)
-
-    def get_dog(self, dog_id: UUID) -> Dict[str, Any]:
-        dog = self.repository.get(dog_id, projector_func=Dog.projector)
-        return {"name": dog.name, "tricks": tuple(dog.tricks)}

eventsourcing/examples/aggregate4/domainmodel.py

@@ -1,114 +0,0 @@
-from __future__ import annotations
-
-from dataclasses import dataclass
-from datetime import datetime, timezone
-from typing import Any, Iterable, List, Type, TypeVar, cast
-from uuid import UUID, uuid4
-
-from eventsourcing.dispatch import singledispatchmethod
-from eventsourcing.domain import Snapshot
-
-
-@dataclass(frozen=True)
-class DomainEvent:
-    originator_version: int
-    originator_id: UUID
-    timestamp: datetime
-
-    @staticmethod
-    def create_timestamp() -> datetime:
-        return datetime.now(tz=timezone.utc)
-
-
-TAggregate = TypeVar("TAggregate", bound="Aggregate")
-
-
-class Aggregate:
-    id: UUID
-    version: int
-    created_on: datetime
-    _pending_events: List[DomainEvent]
-
-    def __init__(self, event: DomainEvent):
-        self.id = event.originator_id
-        self.version = event.originator_version
-        self.created_on = event.timestamp
-
-    def trigger_event(
-        self,
-        event_class: Type[DomainEvent],
-        **kwargs: Any,
-    ) -> None:
-        kwargs = kwargs.copy()
-        kwargs.update(
-            originator_id=self.id,
-            originator_version=self.version + 1,
-            timestamp=event_class.create_timestamp(),
-        )
-        new_event = event_class(**kwargs)
-        self._apply(new_event)
-        self._pending_events.append(new_event)
-
-    @singledispatchmethod
-    def _apply(self, event: DomainEvent) -> None:
-        """Applies event to aggregate."""
-
-    def collect_events(self) -> List[DomainEvent]:
-        events, self._pending_events = self._pending_events, []
-        return events
-
-    @classmethod
-    def projector(
-        cls: Type[TAggregate],
-        _: TAggregate | None,
-        events: Iterable[DomainEvent],
-    ) -> TAggregate | None:
-        aggregate: TAggregate = object.__new__(cls)
-        aggregate._pending_events = []
-        for event in events:
-            aggregate._apply(event)
-        return aggregate
-
-
-class Dog(Aggregate):
-    @dataclass(frozen=True)
-    class Registered(DomainEvent):
-        name: str
-
-    @dataclass(frozen=True)
-    class TrickAdded(DomainEvent):
-        trick: str
-
-    @classmethod
-    def register(cls, name: str) -> Dog:
-        event = cls.Registered(
-            originator_id=uuid4(),
-            originator_version=1,
-            timestamp=DomainEvent.create_timestamp(),
-            name=name,
-        )
-        dog = cast(Dog, cls.projector(None, [event]))
-        dog._pending_events.append(event)
-        return dog
-
-    def add_trick(self, trick: str) -> None:
-        self.trigger_event(self.TrickAdded, trick=trick)
-
-    @singledispatchmethod
-    def _apply(self, event: DomainEvent) -> None:
-        """Applies event to aggregate."""
-
-    @_apply.register(Registered)
-    def _(self, event: Registered) -> None:
-        super().__init__(event)
-        self.name = event.name
-        self.tricks: List[str] = []
-
-    @_apply.register(TrickAdded)
-    def _(self, event: TrickAdded) -> None:
-        self.tricks.append(event.trick)
-        self.version = event.originator_version
-
-    @_apply.register(Snapshot)
-    def _(self, event: Snapshot) -> None:
-        self.__dict__.update(event.state)

eventsourcing/examples/aggregate4/test_application.py

@@ -1,38 +0,0 @@
-from __future__ import annotations
-
-from unittest import TestCase
-
-from eventsourcing.examples.aggregate4.application import DogSchool
-from eventsourcing.examples.aggregate4.domainmodel import Dog
-
-
-class TestDogSchool(TestCase):
-    def test_dog_school(self) -> None:
-        # Construct application object.
-        school = DogSchool()
-
-        # Evolve application state.
-        dog_id = school.register_dog("Fido")
-        school.add_trick(dog_id, "roll over")
-        school.add_trick(dog_id, "play dead")
-
-        # Query application state.
-        dog = school.get_dog(dog_id)
-        assert dog["name"] == "Fido"
-        assert dog["tricks"] == ("roll over", "play dead")
-
-        # Select notifications.
-        notifications = school.notification_log.select(start=1, limit=10)
-        assert len(notifications) == 3
-
-        # Take snapshot.
-        school.take_snapshot(dog_id, version=3, projector_func=Dog.projector)
-        dog = school.get_dog(dog_id)
-        assert dog["name"] == "Fido"
-        assert dog["tricks"] == ("roll over", "play dead")
-
-        # Continue with snapshotted aggregate.
-        school.add_trick(dog_id, "fetch ball")
-        dog = school.get_dog(dog_id)
-        assert dog["name"] == "Fido"
-        assert dog["tricks"] == ("roll over", "play dead", "fetch ball")

eventsourcing/examples/aggregate5/application.py

@@ -1,27 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Any, Dict
-
-from eventsourcing.application import Application
-from eventsourcing.examples.aggregate5.domainmodel import Dog
-
-if TYPE_CHECKING:  # pragma: nocover
-    from uuid import UUID
-
-
-class DogSchool(Application):
-    is_snapshotting_enabled = True
-
-    def register_dog(self, name: str) -> UUID:
-        dog, event = Dog.register(name)
-        self.save(event)
-        return dog.id
-
-    def add_trick(self, dog_id: UUID, trick: str) -> None:
-        dog = self.repository.get(dog_id, projector_func=Dog.projector)
-        dog, event = dog.add_trick(trick)
-        self.save(event)
-
-    def get_dog(self, dog_id: UUID) -> Dict[str, Any]:
-        dog = self.repository.get(dog_id, projector_func=Dog.projector)
-        return {"name": dog.name, "tricks": dog.tricks}

eventsourcing/examples/aggregate5/domainmodel.py

@@ -1,131 +0,0 @@
-from __future__ import annotations
-
-from dataclasses import dataclass
-from datetime import datetime, timezone
-from typing import Any, Iterable, Tuple, Type, TypeVar
-from uuid import UUID, uuid4
-
-from eventsourcing.dispatch import singledispatchmethod
-from eventsourcing.domain import Snapshot  # noqa: TCH001
-
-
-@dataclass(frozen=True)
-class DomainEvent:
-    originator_id: UUID
-    originator_version: int
-    timestamp: datetime
-
-    @staticmethod
-    def create_timestamp() -> datetime:
-        return datetime.now(tz=timezone.utc)
-
-
-TAggregate = TypeVar("TAggregate", bound="Aggregate")
-
-
-@dataclass(frozen=True)
-class Aggregate:
-    id: UUID
-    version: int
-    created_on: datetime
-    modified_on: datetime
-
-    def trigger_event(
-        self,
-        event_class: Type[DomainEvent],
-        **kwargs: Any,
-    ) -> DomainEvent:
-        kwargs = kwargs.copy()
-        kwargs.update(
-            originator_id=self.id,
-            originator_version=self.version + 1,
-            timestamp=event_class.create_timestamp(),
-        )
-        return event_class(**kwargs)
-
-    @classmethod
-    def projector(
-        cls: Type[TAggregate],
-        aggregate: TAggregate | None,
-        events: Iterable[DomainEvent],
-    ) -> TAggregate | None:
-        for event in events:
-            aggregate = cls.mutate(event, aggregate)
-        return aggregate
-
-    @singledispatchmethod
-    @staticmethod
-    def mutate(event: DomainEvent, aggregate: Any) -> Any:
-        """Mutates aggregate with event."""
-
-
-@dataclass(frozen=True)
-class Dog(Aggregate):
-    name: str
-    tricks: Tuple[str, ...]
-
-    @dataclass(frozen=True)
-    class Registered(DomainEvent):
-        name: str
-
-    @dataclass(frozen=True)
-    class TrickAdded(DomainEvent):
-        trick: str
-
-    @staticmethod
-    def register(name: str) -> Tuple[Dog, DomainEvent]:
-        event = Dog.Registered(
-            originator_id=uuid4(),
-            originator_version=1,
-            timestamp=DomainEvent.create_timestamp(),
-            name=name,
-        )
-        dog = Dog.mutate(event, None)
-        return dog, event
-
-    def add_trick(self, trick: str) -> Tuple[Dog, DomainEvent]:
-        event = self.trigger_event(Dog.TrickAdded, trick=trick)
-        dog = Dog.mutate(event, self)
-        return dog, event
-
-    @singledispatchmethod
-    @classmethod
-    def mutate(cls, event: DomainEvent, aggregate: Dog | None) -> Dog | None:
-        """Mutates aggregate with event."""
-
-    @mutate.register
-    @classmethod
-    def _(cls, event: Dog.Registered, _: Dog | None) -> Dog:
-        return Dog(
-            id=event.originator_id,
-            version=event.originator_version,
-            created_on=event.timestamp,
-            modified_on=event.timestamp,
-            name=event.name,
-            tricks=(),
-        )
-
-    @mutate.register
-    @classmethod
-    def _(cls, event: Dog.TrickAdded, aggregate: Dog | None) -> Dog:
-        assert aggregate is not None
-        return Dog(
-            id=aggregate.id,
-            version=event.originator_version,
-            created_on=aggregate.created_on,
-            modified_on=event.timestamp,
-            name=aggregate.name,
-            tricks=(*aggregate.tricks, event.trick),
-        )
-
-    @mutate.register
-    @classmethod
-    def _(cls, event: Snapshot, _: Dog | None) -> Dog:
-        return Dog(
-            id=event.state["id"],
-            version=event.state["version"],
-            created_on=event.state["created_on"],
-            modified_on=event.state["modified_on"],
-            name=event.state["name"],
-            tricks=tuple(event.state["tricks"]),  # comes back from JSON as a list
-        )