chancy.hub module

class chancy.hub.Event(name: str, body: dict[str, any])

Bases: object

body: dict[str, any]

name: str

class chancy.hub.Hub

Bases: object

An event hub for registering and emitting events.

clear()

Clear all handlers.

async emit(event: str, body)

Emit an event with the given body.

on(event: str, f: Callable[[Event], Awaitable[None]] | Callable[[Event], None])

Register a handler for an event.

on_any(f: Callable[[Event], Awaitable[None]] | Callable[[Event], None])

Register a handler for any event.

remove(event: str, handler: Callable[[Event], Awaitable[None]] | Callable[[Event], None])

Remove a handler from an event.

remove_on_any(handler: Callable[[Event], Awaitable[None]] | Callable[[Event], None])

Remove a handler from any event.

async wait_for(event: str | list[str], timeout: float | None = None) → list[Event]

Wait for a specific event to occur.

Parameters:

• event – The name of the event to wait for, or a list of events.

• timeout – The maximum time to wait for the event (in seconds).