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

eventsourcing/application.py

@@ -599,18 +599,6 @@ class ProcessingEvent:
         self.collect_events(*aggregates, **kwargs)
 
 
-class RecordingEvent:
-    def __init__(
-        self,
-        application_name: str,
-        recordings: List[Recording],
-        previous_max_notification_id: int | None,
-    ):
-        self.application_name = application_name
-        self.recordings = recordings
-        self.previous_max_notification_id = previous_max_notification_id
-
-
 class Application:
     """
     Base class for event-sourced applications.
@@ -659,9 +647,6 @@ class Application:
         self._repository = self.construct_repository()
         self._notification_log = self.construct_notification_log()
         self.closing = Event()
-        self.previous_max_notification_id: int | None = (
-            self.recorder.max_notification_id()
-        )
 
     @property
     def repository(self) -> Repository:

eventsourcing/system.py

@@ -30,11 +30,10 @@ from eventsourcing.application import (
     Application,
     NotificationLog,
     ProcessingEvent,
-    RecordingEvent,
     Section,
     TApplication,
 )
-from eventsourcing.domain import DomainEventProtocol
+from eventsourcing.domain import DomainEventProtocol, MutableOrImmutableAggregate
 from eventsourcing.persistence import (
     IntegrityError,
     Mapper,
@@ -46,6 +45,20 @@ from eventsourcing.persistence import (
 from eventsourcing.utils import EnvType, get_topic, resolve_topic
 
 ProcessingJob = Tuple[DomainEventProtocol, Tracking]
+
+
+class RecordingEvent:
+    def __init__(
+        self,
+        application_name: str,
+        recordings: List[Recording],
+        previous_max_notification_id: int | None,
+    ):
+        self.application_name = application_name
+        self.recordings = recordings
+        self.previous_max_notification_id = previous_max_notification_id
+
+
 ConvertingJob = Optional[Union[RecordingEvent, List[Notification]]]
 
 
@@ -230,6 +243,7 @@ class Leader(Application):
 
     def __init__(self, env: EnvType | None = None) -> None:
         super().__init__(env)
+        self.previous_max_notification_id: int | None = None
         self.followers: List[RecordingEventReceiver] = []
 
     def lead(self, follower: RecordingEventReceiver) -> None:
@@ -238,6 +252,15 @@ class Leader(Application):
         """
         self.followers.append(follower)
 
+    def save(
+        self,
+        *objs: MutableOrImmutableAggregate | DomainEventProtocol | None,
+        **kwargs: Any,
+    ) -> List[Recording]:
+        if self.previous_max_notification_id is None:
+            self.previous_max_notification_id = self.recorder.max_notification_id()
+        return super().save(*objs, **kwargs)
+
     def _notify(self, recordings: List[Recording]) -> None:
         """
         Calls :func:`receive_recording_event` on each follower

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

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

eventsourcing-9.3.5.dist-info/RECORD

@@ -0,0 +1,24 @@
+eventsourcing/__init__.py,sha256=st2H3shrhTk5rqoUeZHUW8XD9iOX9tGGtQFWr2HGYmo,26
+eventsourcing/application.py,sha256=AwTpzqByZT4b6tS6HIFQkH3m9Xx2tchBN-j7jAq63wc,35868
+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=tRn-KpSxcrpJ3x8BtpD9hxYSvk8IHBIPSfTMKPLVT60,46307
+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.5.dist-info/AUTHORS,sha256=8aHOM4UbNZcKlD-cHpFRcM6RWyCqtwtxRev6DeUgVRs,137
+eventsourcing-9.3.5.dist-info/LICENSE,sha256=bSE_F-T6cQPmMY5LuJC27km_pGB1XCVuUFx1uY0Nueg,1512
+eventsourcing-9.3.5.dist-info/METADATA,sha256=yLNXm5rtENkOWB7kK63T2ohN1w7FuraebWFlk-Nxfho,9734
+eventsourcing-9.3.5.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+eventsourcing-9.3.5.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}