Struct HookRegistry 

pub struct HookRegistry { /* private fields */ }

A thread-safe registry that maps typed events to ordered observe-only handlers.

Registration and emission are constructor-injected through registry values; there is no global hook registry. Handlers for the same event type run in registration order. A fatal HookError short-circuits the remaining handlers for that event type; non-fatal errors are collected and the first non-fatal error is returned after all handlers run.

Implementations

impl HookRegistry

pub fn new() -> Self

Create a new empty registry.

pub fn on<E>( &self, event_type: EventType, handler: impl Fn(CancellationToken, &E) -> HookResult + Send + Sync + 'static, ) -> Box<dyn FnOnce() + Send>

where E: Event,

Register a typed handler for event E.

The returned function unregisters this handler when invoked.

pub fn emit<E>(&self, event: &E, cancel: CancellationToken) -> HookResult

where E: Event,

Emit an event to all registered handlers for its concrete type.

Dispatch uses snapshot semantics: handlers registered or removed during an in-flight emit do not affect that emit, but apply to subsequent emits.

pub fn has_handlers<E>(&self, event_type: &EventType) -> bool

where E: Event,

Check whether any handlers are registered for event E and event_type.

pub fn clear<E>(&self, event_type: &EventType)

where E: Event,

Remove all handlers for event E and event_type.

pub fn clear_all(&self)

Remove all handlers from the registry.

Trait Implementations

impl Debug for HookRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for HookRegistry

fn default() -> Self

Returns the “default value” for a type.