python-cqrs 4.3.1__tar.gz → 4.4.2__tar.gz

{python_cqrs-4.3.1 → python_cqrs-4.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-cqrs
-Version: 4.3.1
+Version: 4.4.2
 Summary: Python CQRS pattern implementation
 Author-email: Vadim Kozyrevskiy <vadikko2@mail.ru>, Dmitry Kutlubaev <kutlubaev00@mail.ru>
 Maintainer-email: Vadim Kozyrevskiy <vadikko2@mail.ru>
@@ -49,7 +49,33 @@ Provides-Extra: rabbit
 Requires-Dist: aio-pika==9.3.0; extra == "rabbit"
 Dynamic: license-file
 
-# Python CQRS pattern implementation with Transaction Outbox supporting
+<div align="center">
+  <h1>Python CQRS</h1>
+  <p>Event-Driven Architecture Framework for Distributed Systems</p>
+
+  <p>
+    <a href="https://pypi.org/project/python-cqrs/">
+      <img src="https://img.shields.io/pypi/v/python-cqrs?label=pypi&logo=pypi" alt="PyPI version">
+    </a>
+    <a href="https://pypi.org/project/python-cqrs/">
+      <img src="https://img.shields.io/pypi/dm/python-cqrs?label=downloads&logo=pypi" alt="PyPI downloads">
+    </a>
+    <a href="https://vadikko2.github.io/python-cqrs-mkdocs/">
+      <img src="https://img.shields.io/badge/docs-mkdocs-blue?logo=readthedocs" alt="Documentation">
+    </a>
+    <a href="https://deepwiki.com/vadikko2/python-cqrs">
+      <img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki">
+    </a>
+  </p>
+</div>
+
+<div align="center">
+  <img
+    src="https://raw.githubusercontent.com/vadikko2/python-cqrs-mkdocs/master/docs/img.png"
+    alt="Python CQRS"
+    style="max-width: 80%; width: 800px; border-radius: 16px; box-shadow: 0 8px 32px rgba(0, 102, 204, 0.2); display: block; margin: 2rem auto;"
+  >
+</div>
 
 ## Overview
 
@@ -72,7 +98,9 @@ project ([documentation](https://akhundmurad.github.io/diator/)) with several en
 9. [Protobuf](https://protobuf.dev/) events supporting;
 10. `StreamingRequestMediator` and `StreamingRequestHandler` for handling streaming requests with real-time progress updates;
 11. Parallel event processing with configurable concurrency limits;
-12. Chain of Responsibility pattern support with `CORRequestHandler` for processing requests through multiple handlers in sequence.
+12. Chain of Responsibility pattern support with `CORRequestHandler` for processing requests through multiple handlers in sequence;
+13. Choreographic Saga pattern support for managing distributed transactions with automatic compensation and recovery mechanisms;
+14. Built-in Mermaid diagram generation, enabling automatic generation of Sequence and Class diagrams for documentation and visualization.
 
 ## Request Handlers
 
@@ -87,7 +115,7 @@ As a result of executing the command, an event may be produced to the broker.
 > By default, the command handler does not return any result, but it is not mandatory.
 
 ```python
-from cqrs.requests.request_handler import RequestHandler, SyncRequestHandler
+from cqrs.requests.request_handler import RequestHandler
 from cqrs.events.event import Event
 
 class JoinMeetingCommandHandler(RequestHandler[JoinMeetingCommand, None]):
@@ -102,21 +130,6 @@ class JoinMeetingCommandHandler(RequestHandler[JoinMeetingCommand, None]):
 
       async def handle(self, request: JoinMeetingCommand) -> None:
           await self._meetings_api.join_user(request.user_id, request.meeting_id)
-
-
-class SyncJoinMeetingCommandHandler(SyncRequestHandler[JoinMeetingCommand, None]):
-
-      def __init__(self, meetings_api: MeetingAPIProtocol) -> None:
-          self._meetings_api = meetings_api
-          self.events: list[Event] = []
-
-      @property
-      def events(self) -> typing.List[events.Event]:
-          return self._events
-
-      def handle(self, request: JoinMeetingCommand) -> None:
-          # do some sync logic
-          ...
 ```
 
 A complete example can be found in
@@ -251,6 +264,155 @@ def payment_mapper(mapper: cqrs.RequestMap) -> None:
 A complete example can be found in
 the [documentation](https://github.com/vadikko2/cqrs/blob/master/examples/cor_request_handler.py)
 
+#### Mermaid Diagram Generation
+
+The package includes built-in support for generating Mermaid diagrams from Chain of Responsibility handler chains.
+
+```python
+from cqrs.requests.mermaid import CoRMermaid
+
+# Create Mermaid generator from handler chain
+handlers = [CreditCardHandler, PayPalHandler, DefaultHandler]
+generator = CoRMermaid(handlers)
+
+# Generate Sequence diagram showing execution flow
+sequence_diagram = generator.sequence()
+
+# Generate Class diagram showing type structure
+class_diagram = generator.class_diagram()
+```
+
+Complete example: [CoR Mermaid Diagrams](https://github.com/vadikko2/cqrs/blob/master/examples/cor_mermaid.py)
+
+## Saga Pattern
+
+The package implements the Choreographic Saga pattern for managing distributed transactions across multiple services or operations.
+Sagas enable eventual consistency by executing a series of steps where each step can be compensated if a subsequent step fails.
+
+### Key Features
+
+- **SagaStorage**: Persists saga state and execution history, enabling recovery of interrupted sagas
+- **SagaLog**: Tracks all step executions (act/compensate) with status and timestamps
+- **Recovery Mechanism**: Automatically recovers interrupted sagas from storage, ensuring eventual consistency
+- **Automatic Compensation**: If any step fails, all previously completed steps are automatically compensated in reverse order
+- **Mermaid Diagram Generation**: Generate Sequence and Class diagrams for documentation and visualization
+
+### Example
+
+```python
+from cqrs.saga.saga import Saga
+from cqrs.saga.step import SagaStepHandler, SagaStepResult
+from cqrs.saga.storage.memory import MemorySagaStorage
+from cqrs.saga.models import SagaContext
+from cqrs.response import Response
+import uuid
+
+class OrderContext(SagaContext):
+    order_id: str
+    user_id: str
+    items: list[str]
+    total_amount: float
+    inventory_reservation_id: str | None = None
+    payment_id: str | None = None
+
+class ReserveInventoryResponse(Response):
+    reservation_id: str
+
+class ProcessPaymentResponse(Response):
+    payment_id: str
+
+class ReserveInventoryStep(SagaStepHandler[OrderContext, ReserveInventoryResponse]):
+    def __init__(self, inventory_service):
+        self._inventory_service = inventory_service
+
+    async def act(self, context: OrderContext) -> SagaStepResult[OrderContext, ReserveInventoryResponse]:
+        # Reserve inventory
+        reservation_id = await self._inventory_service.reserve_items(context.order_id, context.items)
+        context.inventory_reservation_id = reservation_id
+        return self._generate_step_result(ReserveInventoryResponse(reservation_id=reservation_id))
+
+    async def compensate(self, context: OrderContext) -> None:
+        # Release inventory if saga fails
+        if context.inventory_reservation_id:
+            await self._inventory_service.release_items(context.inventory_reservation_id)
+
+class ProcessPaymentStep(SagaStepHandler[OrderContext, ProcessPaymentResponse]):
+    def __init__(self, payment_service):
+        self._payment_service = payment_service
+
+    async def act(self, context: OrderContext) -> SagaStepResult[OrderContext, ProcessPaymentResponse]:
+        # Process payment
+        payment_id = await self._payment_service.charge(context.order_id, context.total_amount)
+        context.payment_id = payment_id
+        return self._generate_step_result(ProcessPaymentResponse(payment_id=payment_id))
+
+    async def compensate(self, context: OrderContext) -> None:
+        # Refund payment if saga fails
+        if context.payment_id:
+            await self._payment_service.refund(context.payment_id)
+
+# Create saga with storage
+storage = MemorySagaStorage()
+saga = Saga(
+    steps=[ReserveInventoryStep, ProcessPaymentStep],
+    container=container,  # DI container
+    storage=storage,
+)
+
+# Execute saga
+saga_id = uuid.uuid4()
+context = OrderContext(order_id="123", user_id="user_1", items=["item_1"], total_amount=100.0)
+
+async with saga.transaction(context=context, saga_id=saga_id) as transaction:
+    async for step_result in transaction:
+        print(f"Step completed: {step_result.step_type.__name__}")
+        # If any step fails, compensation happens automatically
+```
+
+The saga state and step history are persisted to `SagaStorage`. The `SagaLog` maintains a complete audit trail
+of all step executions (both `act` and `compensate` operations) with timestamps and status information.
+This enables the recovery mechanism to restore saga state and ensure eventual consistency even after system failures.
+
+If a saga is interrupted (e.g., due to a crash), you can recover it using the recovery mechanism:
+
+```python
+from cqrs.saga.recovery import recover_saga
+
+# Recover interrupted saga - will resume from last completed step
+# or continue compensation if saga was in compensating state
+await recover_saga(saga, saga_id, OrderContext)
+
+# Access execution history (SagaLog) for monitoring and debugging
+history = await storage.get_step_history(saga_id)
+for entry in history:
+    print(f"{entry.timestamp}: {entry.step_name} - {entry.action} - {entry.status}")
+```
+
+The recovery mechanism ensures eventual consistency by:
+- Loading the last known saga state from `SagaStorage`
+- Checking the `SagaLog` to determine which steps were completed
+- Resuming execution from the last completed step, or continuing compensation if the saga was in a compensating state
+- Preventing duplicate execution of already completed steps
+
+#### Mermaid Diagram Generation
+
+The package includes built-in support for generating Mermaid diagrams from Saga instances.
+
+```python
+from cqrs.saga.mermaid import SagaMermaid
+
+# Create Mermaid generator from saga
+generator = SagaMermaid(saga)
+
+# Generate Sequence diagram showing execution flow
+sequence_diagram = generator.sequence()
+
+# Generate Class diagram showing type structure
+class_diagram = generator.class_diagram()
+```
+
+Complete example: [Saga Mermaid Diagrams](https://github.com/vadikko2/cqrs/blob/master/examples/saga_mermaid.py)
+
 ## Event Handlers
 
 Event handlers are designed to process `Notification` and `ECST` events that are consumed from the broker.

{python_cqrs-4.3.1 → python_cqrs-4.4.2}/README.md

@@ -1,4 +1,30 @@
-# Python CQRS pattern implementation with Transaction Outbox supporting
+<div align="center">
+  <h1>Python CQRS</h1>
+  <p>Event-Driven Architecture Framework for Distributed Systems</p>
+
+  <p>
+    <a href="https://pypi.org/project/python-cqrs/">
+      <img src="https://img.shields.io/pypi/v/python-cqrs?label=pypi&logo=pypi" alt="PyPI version">
+    </a>
+    <a href="https://pypi.org/project/python-cqrs/">
+      <img src="https://img.shields.io/pypi/dm/python-cqrs?label=downloads&logo=pypi" alt="PyPI downloads">
+    </a>
+    <a href="https://vadikko2.github.io/python-cqrs-mkdocs/">
+      <img src="https://img.shields.io/badge/docs-mkdocs-blue?logo=readthedocs" alt="Documentation">
+    </a>
+    <a href="https://deepwiki.com/vadikko2/python-cqrs">
+      <img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki">
+    </a>
+  </p>
+</div>
+
+<div align="center">
+  <img
+    src="https://raw.githubusercontent.com/vadikko2/python-cqrs-mkdocs/master/docs/img.png"
+    alt="Python CQRS"
+    style="max-width: 80%; width: 800px; border-radius: 16px; box-shadow: 0 8px 32px rgba(0, 102, 204, 0.2); display: block; margin: 2rem auto;"
+  >
+</div>
 
 ## Overview
 
@@ -21,7 +47,9 @@ project ([documentation](https://akhundmurad.github.io/diator/)) with several en
 9. [Protobuf](https://protobuf.dev/) events supporting;
 10. `StreamingRequestMediator` and `StreamingRequestHandler` for handling streaming requests with real-time progress updates;
 11. Parallel event processing with configurable concurrency limits;
-12. Chain of Responsibility pattern support with `CORRequestHandler` for processing requests through multiple handlers in sequence.
+12. Chain of Responsibility pattern support with `CORRequestHandler` for processing requests through multiple handlers in sequence;
+13. Choreographic Saga pattern support for managing distributed transactions with automatic compensation and recovery mechanisms;
+14. Built-in Mermaid diagram generation, enabling automatic generation of Sequence and Class diagrams for documentation and visualization.
 
 ## Request Handlers
 
@@ -36,7 +64,7 @@ As a result of executing the command, an event may be produced to the broker.
 > By default, the command handler does not return any result, but it is not mandatory.
 
 ```python
-from cqrs.requests.request_handler import RequestHandler, SyncRequestHandler
+from cqrs.requests.request_handler import RequestHandler
 from cqrs.events.event import Event
 
 class JoinMeetingCommandHandler(RequestHandler[JoinMeetingCommand, None]):
@@ -51,21 +79,6 @@ class JoinMeetingCommandHandler(RequestHandler[JoinMeetingCommand, None]):
 
       async def handle(self, request: JoinMeetingCommand) -> None:
           await self._meetings_api.join_user(request.user_id, request.meeting_id)
-
-
-class SyncJoinMeetingCommandHandler(SyncRequestHandler[JoinMeetingCommand, None]):
-
-      def __init__(self, meetings_api: MeetingAPIProtocol) -> None:
-          self._meetings_api = meetings_api
-          self.events: list[Event] = []
-
-      @property
-      def events(self) -> typing.List[events.Event]:
-          return self._events
-
-      def handle(self, request: JoinMeetingCommand) -> None:
-          # do some sync logic
-          ...
 ```
 
 A complete example can be found in
@@ -200,6 +213,155 @@ def payment_mapper(mapper: cqrs.RequestMap) -> None:
 A complete example can be found in
 the [documentation](https://github.com/vadikko2/cqrs/blob/master/examples/cor_request_handler.py)
 
+#### Mermaid Diagram Generation
+
+The package includes built-in support for generating Mermaid diagrams from Chain of Responsibility handler chains.
+
+```python
+from cqrs.requests.mermaid import CoRMermaid
+
+# Create Mermaid generator from handler chain
+handlers = [CreditCardHandler, PayPalHandler, DefaultHandler]
+generator = CoRMermaid(handlers)
+
+# Generate Sequence diagram showing execution flow
+sequence_diagram = generator.sequence()
+
+# Generate Class diagram showing type structure
+class_diagram = generator.class_diagram()
+```
+
+Complete example: [CoR Mermaid Diagrams](https://github.com/vadikko2/cqrs/blob/master/examples/cor_mermaid.py)
+
+## Saga Pattern
+
+The package implements the Choreographic Saga pattern for managing distributed transactions across multiple services or operations.
+Sagas enable eventual consistency by executing a series of steps where each step can be compensated if a subsequent step fails.
+
+### Key Features
+
+- **SagaStorage**: Persists saga state and execution history, enabling recovery of interrupted sagas
+- **SagaLog**: Tracks all step executions (act/compensate) with status and timestamps
+- **Recovery Mechanism**: Automatically recovers interrupted sagas from storage, ensuring eventual consistency
+- **Automatic Compensation**: If any step fails, all previously completed steps are automatically compensated in reverse order
+- **Mermaid Diagram Generation**: Generate Sequence and Class diagrams for documentation and visualization
+
+### Example
+
+```python
+from cqrs.saga.saga import Saga
+from cqrs.saga.step import SagaStepHandler, SagaStepResult
+from cqrs.saga.storage.memory import MemorySagaStorage
+from cqrs.saga.models import SagaContext
+from cqrs.response import Response
+import uuid
+
+class OrderContext(SagaContext):
+    order_id: str
+    user_id: str
+    items: list[str]
+    total_amount: float
+    inventory_reservation_id: str | None = None
+    payment_id: str | None = None
+
+class ReserveInventoryResponse(Response):
+    reservation_id: str
+
+class ProcessPaymentResponse(Response):
+    payment_id: str
+
+class ReserveInventoryStep(SagaStepHandler[OrderContext, ReserveInventoryResponse]):
+    def __init__(self, inventory_service):
+        self._inventory_service = inventory_service
+
+    async def act(self, context: OrderContext) -> SagaStepResult[OrderContext, ReserveInventoryResponse]:
+        # Reserve inventory
+        reservation_id = await self._inventory_service.reserve_items(context.order_id, context.items)
+        context.inventory_reservation_id = reservation_id
+        return self._generate_step_result(ReserveInventoryResponse(reservation_id=reservation_id))
+
+    async def compensate(self, context: OrderContext) -> None:
+        # Release inventory if saga fails
+        if context.inventory_reservation_id:
+            await self._inventory_service.release_items(context.inventory_reservation_id)
+
+class ProcessPaymentStep(SagaStepHandler[OrderContext, ProcessPaymentResponse]):
+    def __init__(self, payment_service):
+        self._payment_service = payment_service
+
+    async def act(self, context: OrderContext) -> SagaStepResult[OrderContext, ProcessPaymentResponse]:
+        # Process payment
+        payment_id = await self._payment_service.charge(context.order_id, context.total_amount)
+        context.payment_id = payment_id
+        return self._generate_step_result(ProcessPaymentResponse(payment_id=payment_id))
+
+    async def compensate(self, context: OrderContext) -> None:
+        # Refund payment if saga fails
+        if context.payment_id:
+            await self._payment_service.refund(context.payment_id)
+
+# Create saga with storage
+storage = MemorySagaStorage()
+saga = Saga(
+    steps=[ReserveInventoryStep, ProcessPaymentStep],
+    container=container,  # DI container
+    storage=storage,
+)
+
+# Execute saga
+saga_id = uuid.uuid4()
+context = OrderContext(order_id="123", user_id="user_1", items=["item_1"], total_amount=100.0)
+
+async with saga.transaction(context=context, saga_id=saga_id) as transaction:
+    async for step_result in transaction:
+        print(f"Step completed: {step_result.step_type.__name__}")
+        # If any step fails, compensation happens automatically
+```
+
+The saga state and step history are persisted to `SagaStorage`. The `SagaLog` maintains a complete audit trail
+of all step executions (both `act` and `compensate` operations) with timestamps and status information.
+This enables the recovery mechanism to restore saga state and ensure eventual consistency even after system failures.
+
+If a saga is interrupted (e.g., due to a crash), you can recover it using the recovery mechanism:
+
+```python
+from cqrs.saga.recovery import recover_saga
+
+# Recover interrupted saga - will resume from last completed step
+# or continue compensation if saga was in compensating state
+await recover_saga(saga, saga_id, OrderContext)
+
+# Access execution history (SagaLog) for monitoring and debugging
+history = await storage.get_step_history(saga_id)
+for entry in history:
+    print(f"{entry.timestamp}: {entry.step_name} - {entry.action} - {entry.status}")
+```
+
+The recovery mechanism ensures eventual consistency by:
+- Loading the last known saga state from `SagaStorage`
+- Checking the `SagaLog` to determine which steps were completed
+- Resuming execution from the last completed step, or continuing compensation if the saga was in a compensating state
+- Preventing duplicate execution of already completed steps
+
+#### Mermaid Diagram Generation
+
+The package includes built-in support for generating Mermaid diagrams from Saga instances.
+
+```python
+from cqrs.saga.mermaid import SagaMermaid
+
+# Create Mermaid generator from saga
+generator = SagaMermaid(saga)
+
+# Generate Sequence diagram showing execution flow
+sequence_diagram = generator.sequence()
+
+# Generate Class diagram showing type structure
+class_diagram = generator.class_diagram()
+```
+
+Complete example: [Saga Mermaid Diagrams](https://github.com/vadikko2/cqrs/blob/master/examples/saga_mermaid.py)
+
 ## Event Handlers
 
 Event handlers are designed to process `Notification` and `ECST` events that are consumed from the broker.

{python_cqrs-4.3.1 → python_cqrs-4.4.2}/pyproject.toml

@@ -29,7 +29,7 @@ maintainers = [{name = "Vadim Kozyrevskiy", email = "vadikko2@mail.ru"}]
 name = "python-cqrs"
 readme = "README.md"
 requires-python = ">=3.10"
-version = "4.3.1"
+version = "4.4.2"
 
 [project.optional-dependencies]
 dev = [

{python_cqrs-4.3.1 → python_cqrs-4.4.2}/src/cqrs/__init__.py

@@ -4,7 +4,7 @@ from cqrs.container.protocol import Container
 from cqrs.events import EventMap
 from cqrs.events.event import DomainEvent, Event, NotificationEvent
 from cqrs.events.event_emitter import EventEmitter
-from cqrs.events.event_handler import EventHandler, SyncEventHandler
+from cqrs.events.event_handler import EventHandler
 from cqrs.mediator import (
     EventMediator,
     RequestMediator,
@@ -17,15 +17,18 @@ from cqrs.outbox.sqlalchemy import (
     SqlAlchemyOutboxedEventRepository,
 )
 from cqrs.producer import EventProducer
-from cqrs.requests import RequestMap
+from cqrs.requests.map import RequestMap
 from cqrs.requests.request import Request
 from cqrs.requests.request_handler import (
     RequestHandler,
     StreamingRequestHandler,
-    SyncRequestHandler,
-    SyncStreamingRequestHandler,
 )
 from cqrs.response import Response
+from cqrs.requests.mermaid import CoRMermaid
+from cqrs.saga.mermaid import SagaMermaid
+from cqrs.saga.models import ContextT, SagaResult
+from cqrs.saga.saga import Saga
+from cqrs.saga.step import SagaStepHandler
 
 __all__ = (
     "RequestMediator",
@@ -38,13 +41,10 @@ __all__ = (
     "EventHandler",
     "EventMap",
     "OutboxedEventMap",
-    "SyncEventHandler",
     "Request",
     "RequestHandler",
     "StreamingRequestHandler",
     "RequestMap",
-    "SyncRequestHandler",
-    "SyncStreamingRequestHandler",
     "Response",
     "OutboxedEventRepository",
     "SqlAlchemyOutboxedEventRepository",
@@ -54,4 +54,10 @@ __all__ = (
     "Compressor",
     "ZlibCompressor",
     "rebind_outbox_model",
+    "Saga",
+    "SagaStepHandler",
+    "SagaResult",
+    "ContextT",
+    "SagaMermaid",
+    "CoRMermaid",
 )

python_cqrs-4.4.2/src/cqrs/deserializers/__init__.py

@@ -0,0 +1,13 @@
+from cqrs.deserializers.exceptions import (
+    DeserializeJsonError,
+    DeserializeProtobufError,
+)
+from cqrs.deserializers.json import JsonDeserializer
+from cqrs.deserializers.protobuf import ProtobufValueDeserializer
+
+__all__ = (
+    "JsonDeserializer",
+    "DeserializeJsonError",
+    "ProtobufValueDeserializer",
+    "DeserializeProtobufError",
+)

python_cqrs-4.4.2/src/cqrs/deserializers/exceptions.py

@@ -0,0 +1,15 @@
+import typing
+
+import pydantic
+
+
+class DeserializeJsonError(pydantic.BaseModel):
+    error_message: str
+    error_type: typing.Type[Exception]
+    message_data: str | bytes | None
+
+
+class DeserializeProtobufError(pydantic.BaseModel):
+    error_message: str
+    error_type: typing.Type[Exception]
+    message_data: bytes

{python_cqrs-4.3.1 → python_cqrs-4.4.2}/src/cqrs/deserializers/json.py

@@ -3,17 +3,13 @@ import typing
 
 import pydantic
 
+from cqrs.deserializers.exceptions import DeserializeJsonError
+
 _T = typing.TypeVar("_T", bound=pydantic.BaseModel)
 
 logger = logging.getLogger("cqrs")
 
 
-class DeserializeJsonError(pydantic.BaseModel):
-    error_message: str
-    error_type: typing.Type[Exception]
-    message_data: str | bytes | None
-
-
 class JsonDeserializer(typing.Generic[_T]):
     def __init__(self, model: typing.Type[_T]):
         self._model: typing.Type[_T] = model

{python_cqrs-4.3.1 → python_cqrs-4.4.2}/src/cqrs/deserializers/protobuf.py

@@ -6,13 +6,9 @@ import pydantic
 from confluent_kafka.schema_registry import protobuf
 from google.protobuf.message import Message
 
-logger = logging.getLogger("cqrs")
-
+from cqrs.deserializers.exceptions import DeserializeProtobufError
 
-class DeserializeProtobufError(pydantic.BaseModel):
-    error_message: str
-    error_type: typing.Type[Exception]
-    message_data: bytes
+logger = logging.getLogger("cqrs")
 
 
 class ProtobufValueDeserializer:

python_cqrs-4.4.2/src/cqrs/dispatcher/__init__.py

@@ -0,0 +1,11 @@
+from cqrs.dispatcher.event import EventDispatcher
+from cqrs.dispatcher.models import RequestDispatchResult
+from cqrs.dispatcher.request import RequestDispatcher
+from cqrs.dispatcher.streaming import StreamingRequestDispatcher
+
+__all__ = (
+    "RequestDispatchResult",
+    "RequestDispatcher",
+    "StreamingRequestDispatcher",
+    "EventDispatcher",
+)

python_cqrs-4.4.2/src/cqrs/dispatcher/event.py

@@ -0,0 +1,42 @@
+import logging
+import typing
+
+from cqrs.container.protocol import Container
+from cqrs.events.event import Event
+from cqrs.events.event_handler import EventHandler
+from cqrs.events.map import EventMap
+from cqrs.middlewares.base import MiddlewareChain
+
+_EventHandler: typing.TypeAlias = EventHandler
+
+logger = logging.getLogger("cqrs")
+
+
+class EventDispatcher:
+    def __init__(
+        self,
+        event_map: EventMap,
+        container: Container,
+        middleware_chain: MiddlewareChain | None = None,
+    ) -> None:
+        self._event_map = event_map
+        self._container = container
+        self._middleware_chain = middleware_chain or MiddlewareChain()
+
+    async def _handle_event(
+        self,
+        event: Event,
+        handle_type: typing.Type[_EventHandler],
+    ):
+        handler: _EventHandler = await self._container.resolve(handle_type)
+        await handler.handle(event)
+
+    async def dispatch(self, event: Event) -> None:
+        handler_types = self._event_map.get(type(event), [])
+        if not handler_types:
+            logger.warning(
+                "Handlers for event %s not found",
+                type(event).__name__,
+            )
+        for h_type in handler_types:
+            await self._handle_event(event, h_type)

python_cqrs-4.4.2/src/cqrs/dispatcher/exceptions.py

@@ -0,0 +1,6 @@
+class RequestHandlerDoesNotExist(Exception):
+    pass
+
+
+class RequestHandlerTypeError(Exception):
+    pass

python_cqrs-4.4.2/src/cqrs/dispatcher/models.py

@@ -0,0 +1,16 @@
+import logging
+import typing
+
+import pydantic
+
+from cqrs.events.event import Event
+from cqrs.response import Response
+
+logger = logging.getLogger("cqrs")
+
+_ResponseT = typing.TypeVar("_ResponseT", Response, None, covariant=True)
+
+
+class RequestDispatchResult(pydantic.BaseModel, typing.Generic[_ResponseT]):
+    response: _ResponseT = pydantic.Field(default=None)
+    events: typing.List[Event] = pydantic.Field(default_factory=list)