# python-cqrs

> Документация по библиотеке python-cqrs. Паттерны CQRS, Saga, Mediator и Event Driven на Python.

python-cqrs is a Python framework for CQRS, Saga, Mediator, and event-driven
architectures. Use these docs for bootstrap, request/event handlers, transaction
outbox, streaming, FastAPI/FastStream integrations, and distributed sagas.


## Getting started

- [Home](https://mkdocs.python-cqrs.dev/index.md): Overview of python-cqrs and core features
- [Overview](https://mkdocs.python-cqrs.dev/bootstrap/index.md): Bootstrap mediators, brokers, middlewares, and DI
- [Dependency Injection](https://mkdocs.python-cqrs.dev/di/index.md): Dependency injection with di and dependency-injector

## Core patterns

- [Overview](https://mkdocs.python-cqrs.dev/request_handler/index.md): Commands, queries, and request handlers
- [Fallback](https://mkdocs.python-cqrs.dev/request_handler/fallback/index.md): Commands, queries, and request handlers
- [Overview](https://mkdocs.python-cqrs.dev/request_response_types/index.md): Request/response type implementations
- [Attrs](https://mkdocs.python-cqrs.dev/request_response_types/attrs/index.md): Request/response type implementations
- [Best Practices](https://mkdocs.python-cqrs.dev/request_response_types/best_practices/index.md): Request/response type implementations
- [Dataclasses](https://mkdocs.python-cqrs.dev/request_response_types/dataclasses/index.md): Request/response type implementations
- [Mixed Usage](https://mkdocs.python-cqrs.dev/request_response_types/mixed_usage/index.md): Request/response type implementations
- [Msgspec](https://mkdocs.python-cqrs.dev/request_response_types/msgspec/index.md): Request/response type implementations
- [NamedTuple](https://mkdocs.python-cqrs.dev/request_response_types/namedtuple/index.md): Request/response type implementations
- [Pydantic](https://mkdocs.python-cqrs.dev/request_response_types/pydantic/index.md): Request/response type implementations
- [Standard Classes](https://mkdocs.python-cqrs.dev/request_response_types/standard_classes/index.md): Request/response type implementations
- [TypedDict](https://mkdocs.python-cqrs.dev/request_response_types/typeddict/index.md): Request/response type implementations
- [Overview](https://mkdocs.python-cqrs.dev/event_handler/index.md): Domain and notification event handling
- [Best Practices](https://mkdocs.python-cqrs.dev/event_handler/best_practices/index.md): Domain and notification event handling
- [Event Flow](https://mkdocs.python-cqrs.dev/event_handler/event_flow/index.md): Domain and notification event handling
- [Event Types](https://mkdocs.python-cqrs.dev/event_handler/event_types/index.md): Domain and notification event handling
- [Examples](https://mkdocs.python-cqrs.dev/event_handler/examples/index.md): Domain and notification event handling
- [Fallback](https://mkdocs.python-cqrs.dev/event_handler/fallback/index.md): Domain and notification event handling
- [Parallel Processing](https://mkdocs.python-cqrs.dev/event_handler/parallel_processing/index.md): Domain and notification event handling
- [Runtime Processing](https://mkdocs.python-cqrs.dev/event_handler/runtime_processing/index.md): Domain and notification event handling
- [Overview](https://mkdocs.python-cqrs.dev/saga/index.md): Orchestrated Saga, storage, recovery, and compensation
- [Compensation Strategy](https://mkdocs.python-cqrs.dev/saga/compensation/index.md): Orchestrated Saga, storage, recovery, and compensation
- [Examples](https://mkdocs.python-cqrs.dev/saga/examples/index.md): Orchestrated Saga, storage, recovery, and compensation
- [Flow Diagrams](https://mkdocs.python-cqrs.dev/saga/flow/index.md): Orchestrated Saga, storage, recovery, and compensation
- [Recovery & Eventual Consistency](https://mkdocs.python-cqrs.dev/saga/recovery/index.md): Orchestrated Saga, storage, recovery, and compensation
- [Storage](https://mkdocs.python-cqrs.dev/saga/storage/index.md): Orchestrated Saga, storage, recovery, and compensation
- [Overview](https://mkdocs.python-cqrs.dev/saga/fallback/index.md): Saga fallback and circuit breaker
- [Circuit Breaker](https://mkdocs.python-cqrs.dev/saga/fallback/circuit_breaker/index.md): Saga fallback and circuit breaker
- [Examples](https://mkdocs.python-cqrs.dev/saga/fallback/examples/index.md): Saga fallback and circuit breaker
- [Mechanics](https://mkdocs.python-cqrs.dev/saga/fallback/mechanics/index.md): Saga fallback and circuit breaker
- [Overview](https://mkdocs.python-cqrs.dev/outbox/index.md): Transactional outbox for reliable event publishing
- [Best Practices](https://mkdocs.python-cqrs.dev/outbox/best_practices/index.md): Transactional outbox for reliable event publishing
- [Database Support](https://mkdocs.python-cqrs.dev/outbox/databases/index.md): Transactional outbox for reliable event publishing
- [Examples](https://mkdocs.python-cqrs.dev/outbox/examples/index.md): Transactional outbox for reliable event publishing
- [Implementation](https://mkdocs.python-cqrs.dev/outbox/implementation/index.md): Transactional outbox for reliable event publishing
- [Usage](https://mkdocs.python-cqrs.dev/outbox/usage/index.md): Transactional outbox for reliable event publishing
- [Overview](https://mkdocs.python-cqrs.dev/chain_of_responsibility/index.md): Sequential handler chains
- [Advanced](https://mkdocs.python-cqrs.dev/chain_of_responsibility/advanced/index.md): Sequential handler chains
- [Examples](https://mkdocs.python-cqrs.dev/chain_of_responsibility/examples/index.md): Sequential handler chains
- [Fallback](https://mkdocs.python-cqrs.dev/chain_of_responsibility/fallback/index.md): Sequential handler chains
- [Overview](https://mkdocs.python-cqrs.dev/stream_handling/index.md): Streaming requests and SSE
- [Configuration](https://mkdocs.python-cqrs.dev/stream_handling/configuration/index.md): Streaming requests and SSE
- [Fallback](https://mkdocs.python-cqrs.dev/stream_handling/fallback/index.md): Streaming requests and SSE
- [FastAPI Integration](https://mkdocs.python-cqrs.dev/stream_handling/fastapi_integration/index.md): Streaming requests and SSE
- [Reference](https://mkdocs.python-cqrs.dev/stream_handling/reference/index.md): Streaming requests and SSE
- [Overview](https://mkdocs.python-cqrs.dev/mermaid/index.md): Mermaid diagram generation
- [Chain of Responsibility](https://mkdocs.python-cqrs.dev/mermaid/chain_of_responsibility/index.md): Mermaid diagram generation
- [Saga Pattern](https://mkdocs.python-cqrs.dev/mermaid/saga/index.md): Mermaid diagram generation
- [Overview](https://mkdocs.python-cqrs.dev/scoped_dependencies/index.md): Request-scoped DI, ScopeStrategy, enter_scope
- [Advanced](https://mkdocs.python-cqrs.dev/scoped_dependencies/advanced/index.md): Request-scoped DI, ScopeStrategy, enter_scope
- [Containers](https://mkdocs.python-cqrs.dev/scoped_dependencies/containers/index.md): Request-scoped DI, ScopeStrategy, enter_scope
- [Custom Container](https://mkdocs.python-cqrs.dev/scoped_dependencies/custom_container/index.md): Request-scoped DI, ScopeStrategy, enter_scope
- [Strategies](https://mkdocs.python-cqrs.dev/scoped_dependencies/strategies/index.md): Request-scoped DI, ScopeStrategy, enter_scope
- [Troubleshooting](https://mkdocs.python-cqrs.dev/scoped_dependencies/troubleshooting/index.md): Request-scoped DI, ScopeStrategy, enter_scope
- [Tutorial](https://mkdocs.python-cqrs.dev/scoped_dependencies/tutorial/index.md): Request-scoped DI, ScopeStrategy, enter_scope
- [Why](https://mkdocs.python-cqrs.dev/scoped_dependencies/why/index.md): Request-scoped DI, ScopeStrategy, enter_scope

## Integrations

- [FastAPI Integration](https://mkdocs.python-cqrs.dev/fastapi/index.md): FastAPI HTTP integration
- [FastStream Integration](https://mkdocs.python-cqrs.dev/faststream/index.md): Kafka and RabbitMQ with FastStream
- [Event Producing](https://mkdocs.python-cqrs.dev/event_producing/index.md): Publishing events to message brokers
- [Protobuf Integration](https://mkdocs.python-cqrs.dev/protobuf/index.md): Protobuf serialization for events