chancy.hub module

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

Bases: object

Parameters:

• name (str)

• body (dict[str, Any])

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, body)

Emit an event with the given body.

Parameters:

event (str)

on(event, f)

Register a handler for an event.

Parameters:

• event (str)

• f (Callable[[Event], Awaitable[None]] | Callable[[Event], None])

on_any(f)

Register a handler for any event.

Parameters:

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

remove(event, handler)

Remove a handler from an event.

Parameters:

• event (str)

• handler (Callable[[Event], Awaitable[None]] | Callable[[Event], None])

remove_on_any(handler)

Remove a handler from any event.

Parameters:

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

async wait_for(event, timeout=None)

Wait for a specific event to occur.

Parameters:

• event (str | list[str]) – The name of the event to wait for, or a list of events.

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

Return type:

list[Event]