Skip to content

src/dazzle_back/events/framework.py

Generated: 2026-03-30T04:38:46.072116+00:00

Commit: 615f1354a103

Language: python

Scope: dazzle_back

Purpose

Event Framework for Dazzle Runtime.

The EventFramework is the central orchestration point for all event-related functionality in a Dazzle application. It coordinates:

  • Event bus (via tier system)
  • Outbox publisher (for transactional event delivery)
  • Consumer management (for event handlers)
  • Li...

Key Exports

  • EventFrameworkConfig
  • FrameworkStats
  • EventFramework
  • get_bus
  • bus
  • outbox
  • inbox
  • is_running
  • start
  • stop
  • on
  • register_handler
  • emit_event
  • get_connection
  • drain_outbox
  • get_status
  • health_check
  • get_outbox_stats
  • get_recent_outbox_entries
  • decorator

Dependencies

Imports

  • __future__.annotations
  • logging
  • collections.abc.Awaitable
  • collections.abc.Callable
  • dataclasses.dataclass
  • dataclasses.field
  • datetime.UTC
  • datetime.datetime
  • typing.TYPE_CHECKING
  • typing.Any
  • dazzle_back.events.bus.EventBus
  • dazzle_back.events.bus.EventHandler
  • dazzle_back.events.consumer.ConsumerConfig
  • dazzle_back.events.consumer.IdempotentConsumer
  • dazzle_back.events.envelope.EventEnvelope
  • dazzle_back.events.inbox.EventInbox
  • dazzle_back.events.outbox.EventOutbox
  • dazzle_back.events.publisher.OutboxPublisher
  • dazzle_back.events.publisher.PublisherConfig
  • psycopg

Event Interactions

None detected.

Invariants and Assumptions

  • Validates: database_url is required for event system

  • Create idempotent consumer

Tests

  • tests/unit/test_framework_pg.py
  • tests/unit/test_events.py
  • tests/unit/test_events_api.py

Notes

This page was automatically generated by tools/gen_reference_docs.py.