How codeonym-oss/mediary works
Mediary is a typed Python mediator/CQRS runtime. Applications mark messages and handlers, scan or register them, then send requests, publish notifications, or consume streams; mediator dispatch applies matching behaviors and resolves handler dependencies. The graph also preserves the documented CQRS, DI integrations, built-in behaviors, and testing helpers. Edges are limited to README statements and source-index references; unsampled integration internals are not inferred.
Main entry points: _mediator.py Mediator · _behaviors.py Behavior Pipeline · _handlers.py Handler Binding · kinds.py Message Kinds
Components 23
Dispatch Runtime
- Mediator
src/mediary/_mediator.py - Package Scan
src/mediary/_scan.py - Handler Binding
src/mediary/_handlers.py - Dependency Resolver
src/mediary/_resolving.py - Behavior Pipeline
src/mediary/_behaviors.py
Message Capabilities
- Message Markers
src/mediary/_markers.py - Message Kinds
src/mediary/kinds.py - CQRS Types
src/mediary/cqrs.py - Stream Runtime
src/mediary/_streaming.py - Notification Publishing
src/mediary/_publishing.py
Integrations
- Dishka Adapter
src/mediary/ext/dishka.py - FastAPI Adapter
src/mediary/ext/fastapi.py - OpenTelemetry Adapter
src/mediary/ext/otel.py
Runtime Support
- Async Concurrency
src/mediary/_concurrency.py - Retry Markers
src/mediary/_retryable.py - Runtime Errors
src/mediary/_errors.py - Deprecation Support
src/mediary/_deprecation.py - Built-in Behaviors
src/mediary/behaviors.py - Testing Helpers
src/mediary/testing.py
Other components
- Application
- DI Container
- FastAPI App
- Telemetry Backend
Connections 32
- Application → Mediator: sends messages
README.md - Application → Package Scan: scans package
README.md - Mediator → Package Scan: scans handlers
src/mediary/_mediator.py - Mediator → Handler Binding: dispatches to
src/mediary/_mediator.py - Mediator → Behavior Pipeline: wraps dispatch
src/mediary/_mediator.py - Mediator → Notification Publishing: publishes through
src/mediary/_mediator.py - Mediator → Stream Runtime: creates streams
src/mediary/_mediator.py - Mediator → Dependency Resolver: configures
src/mediary/_mediator.py - Package Scan → Message Markers: finds marked handlers
src/mediary/_scan.py - Handler Binding → Dependency Resolver: resolves dependencies
src/mediary/_handlers.py - Handler Binding → Async Concurrency: runs sync handlers
src/mediary/_handlers.py - Handler Binding → Runtime Errors: raises binding errors
src/mediary/_handlers.py - Behavior Pipeline → Dependency Resolver: resolves behaviors
src/mediary/_behaviors.py - Behavior Pipeline → Message Markers: matches message kinds
src/mediary/_behaviors.py - Behavior Pipeline → Runtime Errors: raises behavior errors
src/mediary/_behaviors.py - Notification Publishing → Async Concurrency: runs concurrent handlers
src/mediary/_publishing.py - CQRS Types → Message Kinds: defines CQRS kinds
src/mediary/cqrs.py - CQRS Types → Handler Binding: provides handler decorators
src/mediary/cqrs.py - CQRS Types → Stream Runtime: supports stream queries
src/mediary/cqrs.py - Message Kinds → Message Markers: defines kind markers
src/mediary/kinds.py - Message Kinds → Behavior Pipeline: targets behavior kinds
src/mediary/kinds.py - Built-in Behaviors → Behavior Pipeline: implements behaviors
src/mediary/behaviors.py - Built-in Behaviors → Retry Markers: checks retry markers
src/mediary/behaviors.py - Built-in Behaviors → Async Concurrency: uses async utilities
src/mediary/behaviors.py - Testing Helpers → Mediator: extends mediator
src/mediary/testing.py - Dishka Adapter → Mediator: adapts mediator
src/mediary/ext/dishka.py - Dishka Adapter → DI Container: integrates container
README.md - FastAPI Adapter → Mediator: integrates mediator
src/mediary/ext/fastapi.py - FastAPI Adapter → FastAPI App: integrates with
README.md - OpenTelemetry Adapter → Message Kinds: uses message kinds
src/mediary/ext/otel.py - OpenTelemetry Adapter → Telemetry Backend: exports tracing
README.md - Runtime Errors → Deprecation Support: uses compatibility aliases
src/mediary/_errors.py