astrbot_plugin_imagestudio/core/event_bus.py

64 行
2.3 KiB
Python

"""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