python-cqrs 4.15.0__tar.gz → 5.0.0__tar.gz

{python_cqrs-4.15.0/src/python_cqrs.egg-info → python_cqrs-5.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-cqrs
-Version: 4.15.0
+Version: 5.0.0
 Summary: Event-Driven Architecture Framework for Distributed Systems
 Author-email: Vadim Kozyrevskiy <vadikko2@mail.ru>, Dmitry Kutlubaev <kutlubaev00@mail.ru>
 Maintainer-email: Vadim Kozyrevskiy <vadikko2@mail.ru>
@@ -21,12 +21,14 @@ Requires-Dist: dataclass-wizard==0.*
 Requires-Dist: di[anyio]==0.*
 Requires-Dist: dependency-injector>=4.0
 Requires-Dist: orjson==3.*
-Requires-Dist: pydantic==2.*
-Requires-Dist: sqlalchemy[asyncio]==2.0.*
 Requires-Dist: python-dotenv==1.*
 Requires-Dist: typing-extensions>=4.0
 Provides-Extra: aiobreaker
 Requires-Dist: aiobreaker>=0.3.0; extra == "aiobreaker"
+Provides-Extra: pydantic
+Requires-Dist: pydantic==2.*; extra == "pydantic"
+Provides-Extra: sqlalchemy
+Requires-Dist: sqlalchemy[asyncio]==2.0.*; extra == "sqlalchemy"
 Provides-Extra: dev
 Requires-Dist: pycln==2.5.0; extra == "dev"
 Requires-Dist: pre-commit==3.8.0; extra == "dev"
@@ -50,6 +52,8 @@ Requires-Dist: redis>=5.0.0; extra == "dev"
 Requires-Dist: aiobreaker>=0.3.0; extra == "dev"
 Requires-Dist: dishka>=1.0; extra == "dev"
 Requires-Dist: protobuf>=4.25.8; extra == "dev"
+Requires-Dist: pydantic==2.*; extra == "dev"
+Requires-Dist: sqlalchemy[asyncio]==2.0.*; extra == "dev"
 Provides-Extra: examples
 Requires-Dist: fastapi==0.109.*; extra == "examples"
 Requires-Dist: faststream[kafka]==0.5.28; extra == "examples"
@@ -59,6 +63,8 @@ Requires-Dist: aiohttp==3.14.3; extra == "examples"
 Requires-Dist: protobuf>=4.25.8; extra == "examples"
 Requires-Dist: aiosqlite>=0.20.0; extra == "examples"
 Requires-Dist: dishka>=1.0; extra == "examples"
+Requires-Dist: pydantic==2.*; extra == "examples"
+Requires-Dist: sqlalchemy[asyncio]==2.0.*; extra == "examples"
 Provides-Extra: kafka
 Requires-Dist: aiokafka==0.10.0; extra == "kafka"
 Requires-Dist: retry-async==0.1.*; extra == "kafka"
@@ -66,8 +72,6 @@ Provides-Extra: protobuf
 Requires-Dist: protobuf>=4.25.8; extra == "protobuf"
 Provides-Extra: rabbit
 Requires-Dist: aio-pika==9.3.0; extra == "rabbit"
-Provides-Extra: sqlalchemy
-Requires-Dist: sqlalchemy[asyncio]==2.0.*; extra == "sqlalchemy"
 Provides-Extra: dishka
 Requires-Dist: dishka>=1.0; extra == "dishka"
 Dynamic: license-file
@@ -119,6 +123,7 @@ Dynamic: license-file
 - [Overview](#overview)
 - [When NOT to use python-cqrs](#when-not-to-use-python-cqrs)
 - [Installation](#installation)
+- [Version Support](#version-support)
 - [Quick Start](#quick-start)
 - [Request and Response Types](#request-and-response-types)
 - [Request Handlers](#request-handlers)
@@ -184,14 +189,52 @@ Do not add a Saga for a single `UPDATE` in one service, and do not use a Saga as
 pip install python-cqrs
 ```
 
-Optional dependencies (see [pyproject.toml](https://github.com/vadikko2/python-cqrs/blob/master/pyproject.toml) for full list):
+Optional extras (5.0+ — pydantic and SQLAlchemy are no longer core dependencies):
+
+```bash
+pip install "python-cqrs[pydantic]"     # PydanticRequest / Pydantic* events
+pip install "python-cqrs[sqlalchemy]"   # Outbox / Saga SQLAlchemy storage
+pip install "python-cqrs[kafka]"        # Kafka broker (aiokafka)
+pip install "python-cqrs[examples]"     # FastAPI, FastStream, uvicorn, etc.
+pip install "python-cqrs[aiobreaker]"   # Circuit breaker for saga fallbacks
+```
+
+Default `Request` / `Response` / `Event` / `DomainEvent` / `NotificationEvent` aliases
+are dataclass-based (`DC*`). Use `Pydantic*` types with the pydantic extra when you
+need validation.
+
+### Import paths (5.0+)
+
+| Area | Import |
+|------|--------|
+| Bootstrap | `from cqrs.bootstrap import requests, events, saga` |
+| Mediators | `from cqrs.mediators import RequestMediator, SagaMediator, …` |
+| Handlers | `from cqrs.handlers import RequestHandler, EventHandler, …` |
+| Models | `from cqrs.models import Request, Event, …` / `cqrs.models.pydantic` |
+| Maps | `from cqrs.mapping import RequestMap, EventMap, OutboxedEventMap` |
+| Mermaid | `from cqrs.mermaid import CoRMermaid, SagaMermaid` |
+| Outbox producer | `from cqrs.message_brokers.producer import EventProducer` |
+
+`SagaMediator.execute(...)` replaces the former `SagaMediator.stream(...)`
+(StreamingRequestMediator.stream is unchanged).
+
+## Version Support
+
+| Line | Git branch | What changes |
+|------|------------|--------------|
+| **4.x** | `4.x` | Bug fixes and security only (~12 months after 5.0.0) |
+| **5.x** | `master` | Features and breaking changes |
+
+Stay on 4.x until you migrate:
 
 ```bash
-pip install python-cqrs[kafka]      # Kafka broker (aiokafka)
-pip install python-cqrs[examples]    # FastAPI, FastStream, uvicorn, etc.
-pip install python-cqrs[aiobreaker]  # Circuit breaker for saga fallbacks
+pip install "python-cqrs>=4,<5"
 ```
 
+Docs: [4.x](https://mkdocs.python-cqrs.dev/4.0/) and [5.x / latest](https://mkdocs.python-cqrs.dev/latest/) (version switcher after mike deploy). See [SECURITY.md](SECURITY.md) for the support window and vulnerability reporting, and [CONTRIBUTING.md](CONTRIBUTING.md#8-maintaining--fixing-4x) for how to contribute 4.x bugfixes.
+
+A package-level EOL `DeprecationWarning` toward 5.x will be added on the **first 4.x patch after 5.0.0** — not before.
+
 ## Quick Start
 
 Define a command, a handler, bind them, and run via the mediator:
@@ -199,7 +242,7 @@ Define a command, a handler, bind them, and run via the mediator:
 ```python
 import di
 import cqrs
-from cqrs.requests import bootstrap
+from cqrs.bootstrap import requests as bootstrap
 
 class CreateOrderCommand(cqrs.Request):
     order_id: str
@@ -287,8 +330,8 @@ 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
-from cqrs.events.event import Event
+from cqrs.handlers.request import RequestHandler
+from cqrs.models.event import Event
 
 class JoinMeetingCommandHandler(RequestHandler[JoinMeetingCommand, None]):
 
@@ -315,8 +358,8 @@ the [read model](https://radekmaziarka.pl/2018/01/08/cqrs-third-step-simple-read
 > The read model can be constructed based on domain events produced by the `Command Handler`.
 
 ```python
-from cqrs.requests.request_handler import RequestHandler
-from cqrs.events.event import Event
+from cqrs.handlers.request import RequestHandler
+from cqrs.models.event import Event
 
 class ReadMeetingQueryHandler(RequestHandler[ReadMeetingQuery, ReadMeetingQueryResult]):
 
@@ -347,8 +390,8 @@ real-time progress updates.
 
 ```python
 import typing
-from cqrs.requests.request_handler import StreamingRequestHandler
-from cqrs.events.event import Event
+from cqrs.handlers.request import StreamingRequestHandler
+from cqrs.models.event import Event
 
 class ProcessFilesCommandHandler(StreamingRequestHandler[ProcessFilesCommand, FileProcessedResult]):
     def __init__(self):
@@ -384,8 +427,8 @@ when a handler successfully processes the request or when all handlers have been
 
 ```python
 import typing
-from cqrs.requests.cor_request_handler import CORRequestHandler
-from cqrs.events.event import Event
+from cqrs.handlers.cor import CORRequestHandler
+from cqrs.models.event import Event
 
 class CreditCardPaymentHandler(CORRequestHandler[ProcessPaymentCommand, PaymentResult]):
     def __init__(self, payment_service: PaymentServiceProtocol) -> None:
@@ -441,7 +484,7 @@ the [documentation](https://github.com/vadikko2/python-cqrs/blob/master/examples
 The package includes built-in support for generating Mermaid diagrams from Chain of Responsibility handler chains.
 
 ```python
-from cqrs.requests.mermaid import CoRMermaid
+from cqrs.mermaid.cor import CoRMermaid
 
 # Create Mermaid generator from handler chain
 handlers = [CreditCardHandler, PayPalHandler, DefaultHandler]
@@ -611,8 +654,8 @@ application.
 ```python
 import functools
 
-from cqrs.events import bootstrap as event_bootstrap
-from cqrs.requests import bootstrap as request_bootstrap
+from cqrs.bootstrap import events as event_bootstrap
+from cqrs.bootstrap import requests as bootstrap as request_bootstrap
 
 from app import dependencies, mapping, orm
 
@@ -668,7 +711,7 @@ import dataclasses
 import uuid
 from cqrs.saga.models import SagaContext
 from cqrs.saga.saga import Saga
-from cqrs.saga.step import SagaStepHandler
+from cqrs.handlers.saga import SagaStepHandler
 
 @dataclasses.dataclass
 class OrderContext(SagaContext):
@@ -690,7 +733,7 @@ class OrderSaga(Saga[OrderContext]):
 context = OrderContext(order_id="123", user_id="user_1", items=["item_1"], total_amount=100.0)
 saga_id = uuid.uuid4()
 
-async for step_result in mediator.stream(context, saga_id=saga_id):
+async for step_result in mediator.execute(context, saga_id=saga_id):
     print(f"Step completed: {step_result.step_type.__name__}")
     # If any step fails, compensation happens automatically
 ```
@@ -703,7 +746,7 @@ The saga pattern supports fallback steps that execute automatically when primary
 from cqrs.saga.fallback import Fallback
 from cqrs.adapters.circuit_breaker import AioBreakerAdapter
 from cqrs.response import Response
-from cqrs.saga.step import SagaStepHandler, SagaStepResult
+from cqrs.handlers.saga import SagaStepHandler, SagaStepResult
 
 class ReserveInventoryResponse(Response):
     reservation_id: str
@@ -786,7 +829,7 @@ The recovery mechanism ensures eventual consistency by:
 The package includes built-in support for generating Mermaid diagrams from Saga instances.
 
 ```python
-from cqrs.saga.mermaid import SagaMermaid
+from cqrs.mermaid.saga import SagaMermaid
 
 # Create Mermaid generator from saga class
 saga = OrderSaga()
@@ -1026,7 +1069,7 @@ This feature is especially useful when:
 **Configuration:**
 
 ```python
-from cqrs.requests import bootstrap
+from cqrs.bootstrap import requests as bootstrap
 
 mediator = bootstrap.bootstrap_streaming(
     di_container=container,
@@ -1143,7 +1186,7 @@ This allows you to stream results to clients in real-time as they are processed.
 ```python
 import fastapi
 import json
-from cqrs.requests import bootstrap
+from cqrs.bootstrap import requests as bootstrap
 
 def streaming_mediator_factory() -> cqrs.StreamingRequestMediator:
     return bootstrap.bootstrap_streaming(

{python_cqrs-4.15.0 → python_cqrs-5.0.0}/README.md

@@ -45,6 +45,7 @@
 - [Overview](#overview)
 - [When NOT to use python-cqrs](#when-not-to-use-python-cqrs)
 - [Installation](#installation)
+- [Version Support](#version-support)
 - [Quick Start](#quick-start)
 - [Request and Response Types](#request-and-response-types)
 - [Request Handlers](#request-handlers)
@@ -110,14 +111,52 @@ Do not add a Saga for a single `UPDATE` in one service, and do not use a Saga as
 pip install python-cqrs
 ```
 
-Optional dependencies (see [pyproject.toml](https://github.com/vadikko2/python-cqrs/blob/master/pyproject.toml) for full list):
+Optional extras (5.0+ — pydantic and SQLAlchemy are no longer core dependencies):
 
 ```bash
-pip install python-cqrs[kafka]      # Kafka broker (aiokafka)
-pip install python-cqrs[examples]    # FastAPI, FastStream, uvicorn, etc.
-pip install python-cqrs[aiobreaker]  # Circuit breaker for saga fallbacks
+pip install "python-cqrs[pydantic]"     # PydanticRequest / Pydantic* events
+pip install "python-cqrs[sqlalchemy]"   # Outbox / Saga SQLAlchemy storage
+pip install "python-cqrs[kafka]"        # Kafka broker (aiokafka)
+pip install "python-cqrs[examples]"     # FastAPI, FastStream, uvicorn, etc.
+pip install "python-cqrs[aiobreaker]"   # Circuit breaker for saga fallbacks
 ```
 
+Default `Request` / `Response` / `Event` / `DomainEvent` / `NotificationEvent` aliases
+are dataclass-based (`DC*`). Use `Pydantic*` types with the pydantic extra when you
+need validation.
+
+### Import paths (5.0+)
+
+| Area | Import |
+|------|--------|
+| Bootstrap | `from cqrs.bootstrap import requests, events, saga` |
+| Mediators | `from cqrs.mediators import RequestMediator, SagaMediator, …` |
+| Handlers | `from cqrs.handlers import RequestHandler, EventHandler, …` |
+| Models | `from cqrs.models import Request, Event, …` / `cqrs.models.pydantic` |
+| Maps | `from cqrs.mapping import RequestMap, EventMap, OutboxedEventMap` |
+| Mermaid | `from cqrs.mermaid import CoRMermaid, SagaMermaid` |
+| Outbox producer | `from cqrs.message_brokers.producer import EventProducer` |
+
+`SagaMediator.execute(...)` replaces the former `SagaMediator.stream(...)`
+(StreamingRequestMediator.stream is unchanged).
+
+## Version Support
+
+| Line | Git branch | What changes |
+|------|------------|--------------|
+| **4.x** | `4.x` | Bug fixes and security only (~12 months after 5.0.0) |
+| **5.x** | `master` | Features and breaking changes |
+
+Stay on 4.x until you migrate:
+
+```bash
+pip install "python-cqrs>=4,<5"
+```
+
+Docs: [4.x](https://mkdocs.python-cqrs.dev/4.0/) and [5.x / latest](https://mkdocs.python-cqrs.dev/latest/) (version switcher after mike deploy). See [SECURITY.md](SECURITY.md) for the support window and vulnerability reporting, and [CONTRIBUTING.md](CONTRIBUTING.md#8-maintaining--fixing-4x) for how to contribute 4.x bugfixes.
+
+A package-level EOL `DeprecationWarning` toward 5.x will be added on the **first 4.x patch after 5.0.0** — not before.
+
 ## Quick Start
 
 Define a command, a handler, bind them, and run via the mediator:
@@ -125,7 +164,7 @@ Define a command, a handler, bind them, and run via the mediator:
 ```python
 import di
 import cqrs
-from cqrs.requests import bootstrap
+from cqrs.bootstrap import requests as bootstrap
 
 class CreateOrderCommand(cqrs.Request):
     order_id: str
@@ -213,8 +252,8 @@ 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
-from cqrs.events.event import Event
+from cqrs.handlers.request import RequestHandler
+from cqrs.models.event import Event
 
 class JoinMeetingCommandHandler(RequestHandler[JoinMeetingCommand, None]):
 
@@ -241,8 +280,8 @@ the [read model](https://radekmaziarka.pl/2018/01/08/cqrs-third-step-simple-read
 > The read model can be constructed based on domain events produced by the `Command Handler`.
 
 ```python
-from cqrs.requests.request_handler import RequestHandler
-from cqrs.events.event import Event
+from cqrs.handlers.request import RequestHandler
+from cqrs.models.event import Event
 
 class ReadMeetingQueryHandler(RequestHandler[ReadMeetingQuery, ReadMeetingQueryResult]):
 
@@ -273,8 +312,8 @@ real-time progress updates.
 
 ```python
 import typing
-from cqrs.requests.request_handler import StreamingRequestHandler
-from cqrs.events.event import Event
+from cqrs.handlers.request import StreamingRequestHandler
+from cqrs.models.event import Event
 
 class ProcessFilesCommandHandler(StreamingRequestHandler[ProcessFilesCommand, FileProcessedResult]):
     def __init__(self):
@@ -310,8 +349,8 @@ when a handler successfully processes the request or when all handlers have been
 
 ```python
 import typing
-from cqrs.requests.cor_request_handler import CORRequestHandler
-from cqrs.events.event import Event
+from cqrs.handlers.cor import CORRequestHandler
+from cqrs.models.event import Event
 
 class CreditCardPaymentHandler(CORRequestHandler[ProcessPaymentCommand, PaymentResult]):
     def __init__(self, payment_service: PaymentServiceProtocol) -> None:
@@ -367,7 +406,7 @@ the [documentation](https://github.com/vadikko2/python-cqrs/blob/master/examples
 The package includes built-in support for generating Mermaid diagrams from Chain of Responsibility handler chains.
 
 ```python
-from cqrs.requests.mermaid import CoRMermaid
+from cqrs.mermaid.cor import CoRMermaid
 
 # Create Mermaid generator from handler chain
 handlers = [CreditCardHandler, PayPalHandler, DefaultHandler]
@@ -537,8 +576,8 @@ application.
 ```python
 import functools
 
-from cqrs.events import bootstrap as event_bootstrap
-from cqrs.requests import bootstrap as request_bootstrap
+from cqrs.bootstrap import events as event_bootstrap
+from cqrs.bootstrap import requests as bootstrap as request_bootstrap
 
 from app import dependencies, mapping, orm
 
@@ -594,7 +633,7 @@ import dataclasses
 import uuid
 from cqrs.saga.models import SagaContext
 from cqrs.saga.saga import Saga
-from cqrs.saga.step import SagaStepHandler
+from cqrs.handlers.saga import SagaStepHandler
 
 @dataclasses.dataclass
 class OrderContext(SagaContext):
@@ -616,7 +655,7 @@ class OrderSaga(Saga[OrderContext]):
 context = OrderContext(order_id="123", user_id="user_1", items=["item_1"], total_amount=100.0)
 saga_id = uuid.uuid4()
 
-async for step_result in mediator.stream(context, saga_id=saga_id):
+async for step_result in mediator.execute(context, saga_id=saga_id):
     print(f"Step completed: {step_result.step_type.__name__}")
     # If any step fails, compensation happens automatically
 ```
@@ -629,7 +668,7 @@ The saga pattern supports fallback steps that execute automatically when primary
 from cqrs.saga.fallback import Fallback
 from cqrs.adapters.circuit_breaker import AioBreakerAdapter
 from cqrs.response import Response
-from cqrs.saga.step import SagaStepHandler, SagaStepResult
+from cqrs.handlers.saga import SagaStepHandler, SagaStepResult
 
 class ReserveInventoryResponse(Response):
     reservation_id: str
@@ -712,7 +751,7 @@ The recovery mechanism ensures eventual consistency by:
 The package includes built-in support for generating Mermaid diagrams from Saga instances.
 
 ```python
-from cqrs.saga.mermaid import SagaMermaid
+from cqrs.mermaid.saga import SagaMermaid
 
 # Create Mermaid generator from saga class
 saga = OrderSaga()
@@ -952,7 +991,7 @@ This feature is especially useful when:
 **Configuration:**
 
 ```python
-from cqrs.requests import bootstrap
+from cqrs.bootstrap import requests as bootstrap
 
 mediator = bootstrap.bootstrap_streaming(
     di_container=container,
@@ -1069,7 +1108,7 @@ This allows you to stream results to clients in real-time as they are processed.
 ```python
 import fastapi
 import json
-from cqrs.requests import bootstrap
+from cqrs.bootstrap import requests as bootstrap
 
 def streaming_mediator_factory() -> cqrs.StreamingRequestMediator:
     return bootstrap.bootstrap_streaming(

{python_cqrs-4.15.0 → python_cqrs-5.0.0}/pyproject.toml

@@ -21,8 +21,6 @@ dependencies = [
   "di[anyio]==0.*",
   "dependency-injector>=4.0",
   "orjson==3.*",
-  "pydantic==2.*",
-  "sqlalchemy[asyncio]==2.0.*",
   "python-dotenv==1.*",
   "typing-extensions>=4.0",
 ]
@@ -31,10 +29,12 @@ maintainers = [{ name = "Vadim Kozyrevskiy", email = "vadikko2@mail.ru" }]
 name = "python-cqrs"
 readme = "README.md"
 requires-python = ">=3.10"
-version = "4.15.0"
+version = "5.0.0"
 
 [project.optional-dependencies]
 aiobreaker = ["aiobreaker>=0.3.0"]
+pydantic = ["pydantic==2.*"]
+sqlalchemy = ["sqlalchemy[asyncio]==2.0.*"]
 dev = [
   # Develope tools
   "pycln==2.5.0",
@@ -61,6 +61,9 @@ dev = [
   "aiobreaker>=0.3.0", # from aiobreaker
   "dishka>=1.0",  # scoped-deps dishka adapter tests / examples
   "protobuf>=4.25.8",  # protobuf codec / deserializer unit tests
+  # Full suite extras
+  "pydantic==2.*",
+  "sqlalchemy[asyncio]==2.0.*",
 ]
 examples = [
   "fastapi==0.109.*",
@@ -71,11 +74,12 @@ examples = [
   "protobuf>=4.25.8",
   "aiosqlite>=0.20.0",
   "dishka>=1.0",
+  "pydantic==2.*",
+  "sqlalchemy[asyncio]==2.0.*",
 ]
 kafka = ["aiokafka==0.10.0", "retry-async==0.1.*"]
 protobuf = ["protobuf>=4.25.8"]
 rabbit = ["aio-pika==9.3.0"]
-sqlalchemy = ["sqlalchemy[asyncio]==2.0.*"]
 dishka = ["dishka>=1.0"]
 
 [project.urls]
@@ -88,6 +92,10 @@ addopts = "--junit-xml=report.xml"
 asyncio_mode = "auto"
 junit_family = "xunit1"
 testpaths = ["tests"]
+markers = [
+  "pydantic: tests that require the pydantic optional extra",
+  "sqlalchemy: tests that require the sqlalchemy optional extra",
+]
 
 [tool.setuptools.packages.find]
 where = ["src"]

python_cqrs-5.0.0/src/cqrs/__init__.py

@@ -0,0 +1,204 @@
+import typing
+
+if typing.TYPE_CHECKING:
+    from cqrs.models.pydantic import (
+        PydanticDomainEvent,
+        PydanticEvent,
+        PydanticNotificationEvent,
+    )
+    from cqrs.models.pydantic import PydanticRequest
+    from cqrs.models.pydantic import PydanticResponse
+    from cqrs.outbox.sqlalchemy import (
+        SqlAlchemyOutboxedEventRepository,
+        rebind_outbox_model,
+    )
+    from cqrs.sqlalchemy_types import (
+        Binary16,
+        DialectAwareType,
+        DialectTypeHandler,
+        JSONType,
+        PayloadBinary,
+        UUIDBinary,
+    )
+
+
+from cqrs.compressors import Compressor, ZlibCompressor
+from cqrs.container.di import DIContainer
+from cqrs.container.protocol import Container, SupportsScope
+from cqrs.container.scope import (
+    ScopeAwareContainer,
+    ScopeStrategy,
+    bind_scope,
+    current_container,
+    enter_scope,
+)
+from cqrs.circuit_breaker import ICircuitBreaker
+from cqrs.events import EventMap
+from cqrs.events.fallback import EventHandlerFallback
+from cqrs.models.event import (
+    DCEvent,
+    DCDomainEvent,
+    DCNotificationEvent,
+    DomainEvent,
+    Event,
+    IDomainEvent,
+    IEvent,
+    INotificationEvent,
+    NotificationEvent,
+)
+from cqrs.events.event_emitter import EventEmitter
+from cqrs.handlers.event import EventHandler
+from cqrs.mediators import (
+    EventMediator,
+    RequestMediator,
+    SagaMediator,
+    StreamingRequestMediator,
+)
+from cqrs.mapping.outbox import OutboxedEventMap
+from cqrs.outbox.repository import (
+    EventStatus,
+    OutboxedEvent,
+    OutboxedEventRepository,
+)
+from cqrs.message_brokers.producer import EventProducer
+from cqrs.deserializers import DeserializeProtobufError, ProtobufDeserializer
+from cqrs.serializers import (
+    EventCodec,
+    EventSerializer,
+    JsonEventSerializer,
+    ProtobufEventSerializer,
+)
+from cqrs.requests.fallback import RequestHandlerFallback
+from cqrs.mapping.requests import RequestMap, SagaMap
+from cqrs.mermaid.cor import CoRMermaid
+from cqrs.models.request import DCRequest, IRequest, Request
+from cqrs.handlers.request import (
+    RequestHandler,
+    StreamingRequestHandler,
+)
+from cqrs.models.response import DCResponse, IResponse, Response
+from cqrs.mermaid.saga import SagaMermaid
+from cqrs.saga.models import ContextT
+from cqrs.saga.saga import Saga
+from cqrs.handlers.saga import (
+    Resp,
+    SagaStepHandler,
+    SagaStepResult,
+)
+
+
+from cqrs._dataclass_utils import pydantic_extra_error
+
+__all__ = (
+    "ICircuitBreaker",
+    "EventHandlerFallback",
+    "RequestHandlerFallback",
+    "RequestMediator",
+    "SagaMediator",
+    "StreamingRequestMediator",
+    "EventMediator",
+    "DomainEvent",
+    "IDomainEvent",
+    "DCDomainEvent",
+    "PydanticDomainEvent",
+    "NotificationEvent",
+    "INotificationEvent",
+    "DCNotificationEvent",
+    "PydanticNotificationEvent",
+    "Event",
+    "IEvent",
+    "DCEvent",
+    "PydanticEvent",
+    "EventEmitter",
+    "EventHandler",
+    "EventMap",
+    "OutboxedEventMap",
+    "EventStatus",
+    "OutboxedEvent",
+    "Request",
+    "IRequest",
+    "DCRequest",
+    "PydanticRequest",
+    "RequestHandler",
+    "StreamingRequestHandler",
+    "RequestMap",
+    "SagaMap",
+    "Response",
+    "IResponse",
+    "DCResponse",
+    "PydanticResponse",
+    "OutboxedEventRepository",
+    "SqlAlchemyOutboxedEventRepository",
+    "EventProducer",
+    "EventSerializer",
+    "EventCodec",
+    "JsonEventSerializer",
+    "ProtobufEventSerializer",
+    "ProtobufDeserializer",
+    "DeserializeProtobufError",
+    "Container",
+    "SupportsScope",
+    "DIContainer",
+    "ScopeAwareContainer",
+    "ScopeStrategy",
+    "bind_scope",
+    "current_container",
+    "enter_scope",
+    "Compressor",
+    "ZlibCompressor",
+    "rebind_outbox_model",
+    "Saga",
+    "SagaStepHandler",
+    "SagaStepResult",
+    "Resp",
+    "ContextT",
+    "SagaMermaid",
+    "CoRMermaid",
+    "DialectAwareType",
+    "DialectTypeHandler",
+    "UUIDBinary",
+    "Binary16",
+    "JSONType",
+    "PayloadBinary",
+)
+
+_LAZY_PYDANTIC = {
+    "PydanticEvent": ("cqrs.models.pydantic", "PydanticEvent"),
+    "PydanticDomainEvent": ("cqrs.models.pydantic", "PydanticDomainEvent"),
+    "PydanticNotificationEvent": (
+        "cqrs.models.pydantic",
+        "PydanticNotificationEvent",
+    ),
+    "PydanticRequest": ("cqrs.models.pydantic", "PydanticRequest"),
+    "PydanticResponse": ("cqrs.models.pydantic", "PydanticResponse"),
+}
+
+_LAZY_SQLALCHEMY = {
+    "SqlAlchemyOutboxedEventRepository": (
+        "cqrs.outbox.sqlalchemy",
+        "SqlAlchemyOutboxedEventRepository",
+    ),
+    "rebind_outbox_model": ("cqrs.outbox.sqlalchemy", "rebind_outbox_model"),
+    "DialectAwareType": ("cqrs.sqlalchemy_types", "DialectAwareType"),
+    "DialectTypeHandler": ("cqrs.sqlalchemy_types", "DialectTypeHandler"),
+    "UUIDBinary": ("cqrs.sqlalchemy_types", "UUIDBinary"),
+    "Binary16": ("cqrs.sqlalchemy_types", "Binary16"),
+    "JSONType": ("cqrs.sqlalchemy_types", "JSONType"),
+    "PayloadBinary": ("cqrs.sqlalchemy_types", "PayloadBinary"),
+}
+
+
+def __getattr__(name: str) -> typing.Any:
+    if name in _LAZY_PYDANTIC:
+        module_name, attr = _LAZY_PYDANTIC[name]
+        try:
+            module = __import__(module_name, fromlist=[attr])
+        except ImportError as exc:
+            raise pydantic_extra_error(name) from exc
+        return getattr(module, attr)
+    if name in _LAZY_SQLALCHEMY:
+        module_name, attr = _LAZY_SQLALCHEMY[name]
+        # ImportError message is raised by the sqlalchemy modules themselves.
+        module = __import__(module_name, fromlist=[attr])
+        return getattr(module, attr)
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")