eventsourcing 9.4.0a3__py3-none-any.whl → 9.4.0a5__py3-none-any.whl

eventsourcing/persistence.py

@@ -486,7 +486,9 @@ class ApplicationRecorder(AggregateRecorder):
         """
 
     @abstractmethod
-    def subscribe(self, gt: int | None = None) -> Subscription[ApplicationRecorder]:
+    def subscribe(
+        self, gt: int | None = None, topics: Sequence[str] = ()
+    ) -> Subscription[ApplicationRecorder]:
         """
         Returns an iterator of Notification objects representing events from an
         application sequence.
@@ -1311,10 +1313,14 @@ TApplicationRecorder_co = TypeVar(
 
 class Subscription(Iterator[Notification], Generic[TApplicationRecorder_co]):
     def __init__(
-        self, recorder: TApplicationRecorder_co, gt: int | None = None
+        self,
+        recorder: TApplicationRecorder_co,
+        gt: int | None = None,
+        topics: Sequence[str] = (),
     ) -> None:
         self._recorder = recorder
         self._last_notification_id = gt
+        self._topics = topics
         self._has_been_entered = False
         self._has_been_stopped = False
 
@@ -1349,9 +1355,12 @@ class Subscription(Iterator[Notification], Generic[TApplicationRecorder_co]):
 
 class ListenNotifySubscription(Subscription[TApplicationRecorder_co]):
     def __init__(
-        self, recorder: TApplicationRecorder_co, gt: int | None = None
+        self,
+        recorder: TApplicationRecorder_co,
+        gt: int | None = None,
+        topics: Sequence[str] = (),
     ) -> None:
-        super().__init__(recorder=recorder, gt=gt)
+        super().__init__(recorder=recorder, gt=gt, topics=topics)
         self._select_limit = 500
         self._notifications: List[Notification] = []
         self._notifications_index: int = 0
@@ -1410,6 +1419,7 @@ class ListenNotifySubscription(Subscription[TApplicationRecorder_co]):
             notifications = self._recorder.select_notifications(
                 start=self._last_notification_id or 0,
                 limit=self._select_limit,
+                topics=self._topics,
                 inclusive_of_start=False,
             )
             if len(notifications) > 0:

eventsourcing/popo.py

@@ -14,6 +14,7 @@ from eventsourcing.persistence import (
     Notification,
     ProcessRecorder,
     StoredEvent,
+    Subscription,
     Tracking,
     TrackingRecorder,
 )
@@ -155,8 +156,10 @@ class POPOApplicationRecorder(POPOAggregateRecorder, ApplicationRecorder):
         with self._database_lock:
             return len(self._stored_events) or None
 
-    def subscribe(self, gt: int | None = None) -> POPOSubscription:
-        return POPOSubscription(self, gt)
+    def subscribe(
+        self, gt: int | None = None, topics: Sequence[str] = ()
+    ) -> Subscription[ApplicationRecorder]:
+        return POPOSubscription(recorder=self, gt=gt, topics=topics)
 
     def listen(self, event: Event) -> None:
         self._listeners.add(event)
@@ -172,10 +175,13 @@ class POPOApplicationRecorder(POPOAggregateRecorder, ApplicationRecorder):
 
 class POPOSubscription(ListenNotifySubscription[POPOApplicationRecorder]):
     def __init__(
-        self, recorder: POPOApplicationRecorder, gt: int | None = None
+        self,
+        recorder: POPOApplicationRecorder,
+        gt: int | None = None,
+        topics: Sequence[str] = (),
     ) -> None:
         assert isinstance(recorder, POPOApplicationRecorder)
-        super().__init__(recorder=recorder, gt=gt)
+        super().__init__(recorder=recorder, gt=gt, topics=topics)
         self._recorder.listen(self._has_been_notified)
 
     def stop(self) -> None:

eventsourcing/postgres.py

@@ -30,6 +30,7 @@ from eventsourcing.persistence import (
     ProcessRecorder,
     ProgrammingError,
     StoredEvent,
+    Subscription,
     Tracking,
     TrackingRecorder,
 )
@@ -524,16 +525,21 @@ class PostgresApplicationRecorder(PostgresAggregateRecorder, ApplicationRecorder
                 raise ProgrammingError(msg)
         return notification_ids
 
-    def subscribe(self, gt: int | None = None) -> PostgresSubscription:
-        return PostgresSubscription(self, gt)
+    def subscribe(
+        self, gt: int | None = None, topics: Sequence[str] = ()
+    ) -> Subscription[ApplicationRecorder]:
+        return PostgresSubscription(recorder=self, gt=gt, topics=topics)
 
 
 class PostgresSubscription(ListenNotifySubscription[PostgresApplicationRecorder]):
     def __init__(
-        self, recorder: PostgresApplicationRecorder, gt: int | None = None
+        self,
+        recorder: PostgresApplicationRecorder,
+        gt: int | None = None,
+        topics: Sequence[str] = (),
     ) -> None:
         assert isinstance(recorder, PostgresApplicationRecorder)
-        super().__init__(recorder=recorder, gt=gt)
+        super().__init__(recorder=recorder, gt=gt, topics=topics)
         self._listen_thread = Thread(target=self._listen)
         self._listen_thread.start()
 

eventsourcing/projection.py

@@ -5,7 +5,17 @@ import weakref
 from abc import ABC, abstractmethod
 from threading import Event, Thread
 from traceback import format_exc
-from typing import TYPE_CHECKING, Any, Dict, Generic, Iterator, Tuple, Type, TypeVar
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Dict,
+    Generic,
+    Iterator,
+    Sequence,
+    Tuple,
+    Type,
+    TypeVar,
+)
 from warnings import warn
 
 from eventsourcing.application import Application
@@ -37,11 +47,12 @@ class ApplicationSubscription(Iterator[Tuple[DomainEventProtocol, Tracking]]):
         self,
         app: Application,
         gt: int | None = None,
+        topics: Sequence[str] = (),
     ):
         self.name = app.name
         self.recorder = app.recorder
         self.mapper = app.mapper
-        self.subscription = self.recorder.subscribe(gt=gt)
+        self.subscription = self.recorder.subscribe(gt=gt, topics=topics)
 
     def __enter__(self) -> Self:
         self.subscription.__enter__()
@@ -68,6 +79,9 @@ class ApplicationSubscription(Iterator[Tuple[DomainEventProtocol, Tracking]]):
 
 class Projection(ABC, Generic[TTrackingRecorder]):
     name: str = ""
+    """Name of projection, used to pick prefixed environment variables."""
+    topics: Sequence[str] = ()
+    """Event topics, used to filter events in database."""
 
     def __init__(
         self,
@@ -112,21 +126,22 @@ class ProjectionRunner(Generic[TApplication, TTrackingRecorder]):
             self.projection_factory.tracking_recorder(tracking_recorder_class)
         )
 
+        self.projection = projection_class(
+            tracking_recorder=self.tracking_recorder,
+        )
         self.subscription = ApplicationSubscription(
             app=self.app,
             gt=self.tracking_recorder.max_tracking_id(self.app.name),
+            topics=self.projection.topics,
         )
-        self.projection = projection_class(
-            tracking_recorder=self.tracking_recorder,
-        )
-        self._has_error = Event()
+        self._is_stopping = Event()
         self.thread_error: BaseException | None = None
         self.processing_thread = Thread(
             target=self._process_events_loop,
             kwargs={
                 "subscription": self.subscription,
                 "projection": self.projection,
-                "has_error": self._has_error,
+                "is_stopping": self._is_stopping,
                 "runner": weakref.ref(self),
             },
         )
@@ -143,13 +158,14 @@ class ProjectionRunner(Generic[TApplication, TTrackingRecorder]):
         return Environment(name, _env)
 
     def stop(self) -> None:
+        self._is_stopping.set()
         self.subscription.stop()
 
     @staticmethod
     def _process_events_loop(
         subscription: ApplicationSubscription,
         projection: Projection[TrackingRecorder],
-        has_error: Event,
+        is_stopping: Event,
         runner: weakref.ReferenceType[ProjectionRunner[Application, TrackingRecorder]],
     ) -> None:
         try:
@@ -169,12 +185,11 @@ class ProjectionRunner(Generic[TApplication, TTrackingRecorder]):
                     stacklevel=2,
                 )
 
-            has_error.set()
+            is_stopping.set()
             subscription.subscription.stop()
 
     def run_forever(self, timeout: float | None = None) -> None:
-        if self._has_error.wait(timeout=timeout):
-            assert self.thread_error is not None  # for mypy
+        if self._is_stopping.wait(timeout=timeout) and self.thread_error is not None:
             raise self.thread_error
 
     def wait(self, notification_id: int, timeout: float = 1.0) -> None:
@@ -183,11 +198,11 @@ class ProjectionRunner(Generic[TApplication, TTrackingRecorder]):
                 application_name=self.subscription.name,
                 notification_id=notification_id,
                 timeout=timeout,
-                interrupt=self._has_error,
+                interrupt=self._is_stopping,
             )
         except WaitInterruptedError:
-            assert self.thread_error is not None  # for mypy
-            raise self.thread_error from None
+            if self.thread_error is not None:
+                raise self.thread_error from None
 
     def __enter__(self) -> Self:
         return self

eventsourcing/sqlite.py

@@ -471,7 +471,9 @@ class SQLiteApplicationRecorder(
         c.execute(self.select_max_notification_id_statement)
         return c.fetchone()[0]
 
-    def subscribe(self, gt: int | None = None) -> Subscription[ApplicationRecorder]:
+    def subscribe(
+        self, gt: int | None = None, topics: Sequence[str] = ()
+    ) -> Subscription[ApplicationRecorder]:
         msg = f"The {type(self).__qualname__} recorder does not support subscriptions"
         raise NotImplementedError(msg)
 

eventsourcing/tests/persistence.py

@@ -734,6 +734,18 @@ class ApplicationRecorderTestCase(TestCase, ABC):
                 # Shouldn't get here...
                 self.fail("Got here")
 
+        # Start a subscription with topics.
+        subscription = recorder.subscribe(gt=None, topics=["topic3"])
+        with subscription:
+            for notification in subscription:
+                self.assertEqual(notification.topic, "topic3")
+                if (
+                    notification.originator_id == stored_event3.originator_id
+                    and notification.originator_version
+                    == stored_event3.originator_version
+                ):
+                    break
+
     def close_db_connection(self, *args: Any) -> None:
         """"""
 

{eventsourcing-9.4.0a3.dist-info → eventsourcing-9.4.0a5.dist-info}/METADATA

@@ -1,8 +1,7 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: eventsourcing
-Version: 9.4.0a3
+Version: 9.4.0a5
 Summary: Event sourcing in Python
-Home-page: https://github.com/pyeventsourcing/eventsourcing
 License: BSD 3-Clause
 Keywords: event sourcing,event store,domain driven design,domain-driven design,ddd,cqrs,cqs
 Author: John Bywater
@@ -32,6 +31,7 @@ Requires-Dist: cryptography (>=44.0,<44.1) ; extra == "cryptography"
 Requires-Dist: psycopg[pool] (<=3.2.99999) ; extra == "postgres"
 Requires-Dist: pycryptodome (>=3.22,<3.23) ; extra == "crypto"
 Requires-Dist: typing_extensions
+Project-URL: Homepage, https://github.com/pyeventsourcing/eventsourcing
 Project-URL: Repository, https://github.com/pyeventsourcing/eventsourcing
 Description-Content-Type: text/markdown
 

{eventsourcing-9.4.0a3.dist-info → eventsourcing-9.4.0a5.dist-info}/RECORD

@@ -6,21 +6,21 @@ eventsourcing/cryptography.py,sha256=ZsQFyeyMZysADqKy38ECV71j6EMMSbo3VQO7oRnC1h0
 eventsourcing/dispatch.py,sha256=yYSpT-jqc6l_wTdqEnfPJJfvsZN2Ta8g2anrVPWIcqQ,1412
 eventsourcing/domain.py,sha256=pNetJA4uKf1chgfNFKWv1Fke3_V5g0ygRv63WT7nsUc,58208
 eventsourcing/interface.py,sha256=LIFI9AZhoVWUAq4YjKosGCpinf51jmVLqw1Ii4npSHo,5079
-eventsourcing/persistence.py,sha256=h5laiUP4mc6Ur1PoDnNBLXRcl8V-2-ife_hYktlCmmM,45732
-eventsourcing/popo.py,sha256=4q4-l8iuEueqvYzGMzyFEiZaT8dm_PJNosmGwzRt1oo,9393
-eventsourcing/postgres.py,sha256=h4ETgjzZtj9a-otJkMfzHZSxD_hOUWyVTIVuESVI7y0,36138
-eventsourcing/projection.py,sha256=6UNNF_iVYR3nmOfoysgvhtjwYnEBTvsHkQM2gzXPTbQ,6489
+eventsourcing/persistence.py,sha256=sfGq8BV1cnmrTy1OLoWXIObArgUD9wPHcEeM0KwZ5p8,45962
+eventsourcing/popo.py,sha256=wBXoSVg53nVOsZVzKkrCOrXxzWe2HH1mC4aEV97rDdk,9565
+eventsourcing/postgres.py,sha256=wu5b3Kvr4NO9yegCLAkIMDrjpkTVNisCXlFmCb74tAE,36306
+eventsourcing/projection.py,sha256=7wRXY4w8gLNgeFKdlJxo3Q6i7SaBBacbUIEhGda3das,6807
 eventsourcing/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-eventsourcing/sqlite.py,sha256=3bezfl3H9I366NnIwLpn4cz_L3fk0pHNiOSO_Hrq6Xw,21909
+eventsourcing/sqlite.py,sha256=_zY-08IosW1idOnPPRg9rh0C3AyHT6yqwAv4WCOw-dg,21951
 eventsourcing/system.py,sha256=7cM3FBdvr64ZK_xItks1MW2yg1o0OZ1vtKtznFFB_4g,47114
 eventsourcing/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 eventsourcing/tests/application.py,sha256=Q_NFgRSRWovMcyQOZ8U1AoiIsnEHf_zCpHcP0ADaYvs,17369
 eventsourcing/tests/domain.py,sha256=lHSlY6jIoSeqlcPSbrrozEPUJGvJ8bgPrznlmzTxn2w,3254
-eventsourcing/tests/persistence.py,sha256=5y2675k-e-A3JjPVw4EVNSF-Oem96CVWMOMft_1NK-c,56601
+eventsourcing/tests/persistence.py,sha256=M1EZPs8DhAOW8N_GSnALPcmz-pNVCJDx73pHaEJa138,57108
 eventsourcing/tests/postgres_utils.py,sha256=xymcGYasUXeZTBenkHz-ykD8HtrFjVM1Z7-qRrH6OQk,1364
 eventsourcing/utils.py,sha256=QPlHhltgEcL80RWcPJ_PTygzDwhfIowUS3Z5taw0_cA,8228
-eventsourcing-9.4.0a3.dist-info/AUTHORS,sha256=8aHOM4UbNZcKlD-cHpFRcM6RWyCqtwtxRev6DeUgVRs,137
-eventsourcing-9.4.0a3.dist-info/LICENSE,sha256=CQEQzcZO8AWXL5i3hIo4yVKrYjh2FBz6hCM7kpXWpw4,1512
-eventsourcing-9.4.0a3.dist-info/METADATA,sha256=a4kiNuw1ATJbhUMa-UbYnd5lDI6IH_qBtKuhCeAM7E0,9885
-eventsourcing-9.4.0a3.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-eventsourcing-9.4.0a3.dist-info/RECORD,,
+eventsourcing-9.4.0a5.dist-info/AUTHORS,sha256=8aHOM4UbNZcKlD-cHpFRcM6RWyCqtwtxRev6DeUgVRs,137
+eventsourcing-9.4.0a5.dist-info/LICENSE,sha256=CQEQzcZO8AWXL5i3hIo4yVKrYjh2FBz6hCM7kpXWpw4,1512
+eventsourcing-9.4.0a5.dist-info/METADATA,sha256=QDNOXf3BTCZYHc2QrlEEg1cUJYZ9DIsCsuNfTeczIaE,9897
+eventsourcing-9.4.0a5.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+eventsourcing-9.4.0a5.dist-info/RECORD,,

{eventsourcing-9.4.0a3.dist-info → eventsourcing-9.4.0a5.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.9.0
+Generator: poetry-core 2.1.2
 Root-Is-Purelib: true
 Tag: py3-none-any