eventsourcing 9.3.2__tar.gz → 9.3.4__tar.gz

{eventsourcing-9.3.2 → eventsourcing-9.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: eventsourcing
-Version: 9.3.2
+Version: 9.3.4
 Summary: Event sourcing in Python
 Home-page: https://github.com/pyeventsourcing/eventsourcing
 License: BSD 3-Clause
@@ -25,15 +25,10 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Provides-Extra: crypto
-Provides-Extra: docs
 Provides-Extra: postgres
-Requires-Dist: Sphinx ; extra == "docs"
 Requires-Dist: backports.zoneinfo ; python_version < "3.9"
-Requires-Dist: orjson ; extra == "docs"
-Requires-Dist: psycopg[c,pool] (<=3.2.1) ; (python_full_version <= "3.12.999999") and (extra == "postgres")
-Requires-Dist: pycryptodome (>=3.20,<3.21) ; extra == "crypto"
-Requires-Dist: pydantic ; extra == "docs"
-Requires-Dist: sphinx_rtd_theme ; extra == "docs"
+Requires-Dist: psycopg[c,pool] (<=3.2.99999) ; extra == "postgres"
+Requires-Dist: pycryptodome (>=3.21,<3.22) ; extra == "crypto"
 Requires-Dist: typing_extensions
 Project-URL: Repository, https://github.com/pyeventsourcing/eventsourcing
 Description-Content-Type: text/markdown

{eventsourcing-9.3.2 → eventsourcing-9.3.4}/eventsourcing/postgres.py

@@ -9,7 +9,6 @@ import psycopg.errors
 import psycopg_pool
 from psycopg import Connection, Cursor
 from psycopg.rows import DictRow, dict_row
-from typing_extensions import Self
 
 from eventsourcing.persistence import (
     AggregateRecorder,
@@ -34,6 +33,8 @@ from eventsourcing.utils import Environment, resolve_topic, retry, strtobool
 if TYPE_CHECKING:  # pragma: nocover
     from uuid import UUID
 
+    from typing_extensions import Self
+
 logging.getLogger("psycopg.pool").setLevel(logging.CRITICAL)
 logging.getLogger("psycopg").setLevel(logging.CRITICAL)
 

{eventsourcing-9.3.2 → eventsourcing-9.3.4}/eventsourcing/system.py

@@ -8,6 +8,7 @@ from queue import Full, Queue
 from threading import Event, Lock, RLock, Thread
 from types import FrameType, ModuleType
 from typing import (
+    TYPE_CHECKING,
     Any,
     ClassVar,
     Dict,
@@ -22,7 +23,8 @@ from typing import (
     cast,
 )
 
-from typing_extensions import Self
+if TYPE_CHECKING:  # pragma: nocover
+    from typing_extensions import Self
 
 from eventsourcing.application import (
     Application,

{eventsourcing-9.3.2 → eventsourcing-9.3.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "eventsourcing"
-version = "9.3.2"
+version = "9.3.4"
 
 description = "Event sourcing in Python"
 authors = [
@@ -30,10 +30,6 @@ readme = "README.md"
 homepage = "https://github.com/pyeventsourcing/eventsourcing"
 repository = "https://github.com/pyeventsourcing/eventsourcing"
 include = ["eventsourcing/py.typed"]
-packages = [
-    { include = "eventsourcing" },
-    { include = "eventsourcing/tests" },
-]
 keywords=[
     "event sourcing",
     "event store",
@@ -48,48 +44,27 @@ keywords=[
 python = ">=3.8,<4.0"
 typing_extensions = "*"
 "backports.zoneinfo" = { version = "*", python =  "<3.9" }
-pycryptodome = { version = "~3.20", optional = true }
-
-psycopg = { version = "<=3.2.1", optional = true, extras = ["c", "pool"], python = "<=3.12.999999" }
-
-Sphinx = { version = "*", optional = true }
-sphinx_rtd_theme = { version = "*", optional = true }
-pydantic = { version = "*", optional = true }
-orjson = { version = "*", optional = true }
+pycryptodome = { version = "~3.21", optional = true }
+psycopg = { version = "<=3.2.99999", optional = true, extras=["c,pool"]}
 
 [tool.poetry.extras]
 crypto = ["pycryptodome"]
 postgres = ["psycopg"]
-docs = ["Sphinx", "sphinx_rtd_theme", "pydantic", "orjson"]
 
 [tool.poetry.group.dev.dependencies]
 black = { version = "*", allow-prereleases = true }
 coverage = "^7.2.7"
-flake8 = "*"
-flake8-broken-line = "*"
-flake8-bugbear = "*"
-flake8-coding = "*"
-flake8-isort = "*"
-flake8-tidy-imports = "*"
 isort = "*"
 mypy = "*"
-python-coveralls = "*"
-psycopg = [
-    { version = "<=3.2.1", python = "<=3.12.999999" },
-    { git = "https://github.com/psycopg/psycopg", branch="master", subdirectory = "psycopg", python = ">3.12.999999" }
-]
-psycopg-binary = [
-    { version = "<=3.2.1", python = "<=3.12.999999" },
-]
-psycopg-c = [
-    { git = "https://github.com/psycopg/psycopg", branch="master", subdirectory = "psycopg_c", python = ">3.12.999999" }
-]
-psycopg-pool = [
-    { version = "<=3.2.2", python = "<=3.12.999999" },
-    { git = "https://github.com/psycopg/psycopg", branch="master", subdirectory = "psycopg_pool", python = ">3.12.999999" }
-]
+psycopg = { version = "<=3.2.99999", extras = ["binary", "pool"] }
 ruff = "^0.1.14"
 
+[tool.poetry.group.docs.dependencies]
+Sphinx = { version = "*"}
+sphinx_rtd_theme = { version = "*"}
+pydantic = { version = "~2.9"}
+orjson = { version = "~3.10.11"}
+
 
 [build-system]
 requires = ["poetry-core>=1.0.0"]
@@ -118,9 +93,7 @@ exclude = '''
 
 [tool.coverage.run]
 branch = true
-omit = [
-    "esdbclient/protos/*"
-]
+omit = []
 
 [tool.coverage.report]
 exclude_lines = [
@@ -218,6 +191,9 @@ unfixable = []
 # Allow unused variables when underscore-prefixed.
 dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"
 
+[tool.ruff.lint.flake8-type-checking]
+runtime-evaluated-base-classes = ["pydantic.BaseModel"]
+
 [tool.ruff.format]
 # Like Black, use double quotes for strings.
 quote-style = "double"

eventsourcing-9.3.2/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-9.3.2/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-9.3.2/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-9.3.2/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-9.3.2/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-9.3.2/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-9.3.2/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-9.3.2/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-9.3.2/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-9.3.2/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-9.3.2/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-9.3.2/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-9.3.2/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}