2026-07-05 15:39:33 +08:00
|
|
|
"""Small in-process event bus for ImageStudio services."""
|
|
|
|
|
|
|
|
|
|
from __future__ import annotations
|
|
|
|
|
|
|
|
|
|
from collections import defaultdict, deque
|
|
|
|
|
from dataclasses import dataclass, field
|
|
|
|
|
from datetime import datetime, timezone
|
|
|
|
|
from typing import Any, Callable, DefaultDict
|
|
|
|
|
from uuid import uuid4
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
EventHandler = Callable[["Event"], None]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
|
|
|
class Event:
|
|
|
|
|
event_type: str
|
|
|
|
|
payload: dict[str, Any] = field(default_factory=dict)
|
|
|
|
|
event_id: str = field(default_factory=lambda: f"evt_{uuid4().hex}")
|
|
|
|
|
created_at: str = field(default_factory=lambda: datetime.now(timezone.utc).isoformat())
|
|
|
|
|
|
|
|
|
|
def to_dict(self) -> dict[str, Any]:
|
|
|
|
|
return {
|
|
|
|
|
"event_id": self.event_id,
|
|
|
|
|
"event_type": self.event_type,
|
|
|
|
|
"payload": self.payload,
|
|
|
|
|
"created_at": self.created_at,
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class EventBus:
|
|
|
|
|
def __init__(self, *, history_limit: int = 200):
|
|
|
|
|
self._handlers: DefaultDict[str, list[EventHandler]] = defaultdict(list)
|
|
|
|
|
self._history: deque[Event] = deque(maxlen=max(int(history_limit), 1))
|
|
|
|
|
|
|
|
|
|
def subscribe(self, event_type: str, handler: EventHandler) -> None:
|
|
|
|
|
normalized = _normalize_event_type(event_type)
|
|
|
|
|
if handler not in self._handlers[normalized]:
|
|
|
|
|
self._handlers[normalized].append(handler)
|
|
|
|
|
|
|
|
|
|
def unsubscribe(self, event_type: str, handler: EventHandler) -> None:
|
|
|
|
|
normalized = _normalize_event_type(event_type)
|
|
|
|
|
self._handlers[normalized] = [item for item in self._handlers[normalized] if item is not handler]
|
|
|
|
|
|
|
|
|
|
def publish(self, event_type: str, payload: dict[str, Any] | None = None) -> Event:
|
|
|
|
|
event = Event(event_type=_normalize_event_type(event_type), payload=dict(payload or {}))
|
|
|
|
|
self._history.append(event)
|
|
|
|
|
for handler in [*self._handlers.get(event.event_type, []), *self._handlers.get("*", [])]:
|
|
|
|
|
handler(event)
|
|
|
|
|
return event
|
|
|
|
|
|
|
|
|
|
def history(self, event_type: str | None = None) -> list[Event]:
|
|
|
|
|
if event_type is None:
|
|
|
|
|
return list(self._history)
|
|
|
|
|
normalized = _normalize_event_type(event_type)
|
|
|
|
|
return [event for event in self._history if event.event_type == normalized]
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def _normalize_event_type(event_type: str) -> str:
|
|
|
|
|
normalized = str(event_type or "").strip()
|
|
|
|
|
if not normalized:
|
|
|
|
|
raise ValueError("event_type is required")
|
|
|
|
|
return normalized
|