Whitebox

API

Standarized API of whitebox for plugins to interact with the core system.

Attributes:

Name	Type	Description
location		LocationService instance for interacting with the location service
traffic		TrafficService instance for interacting with the traffic service
status		StatusService instance for interacting with the status service
host_manager		HostManagerService instance for Host Manager access

EventEmitter

emit_sync(event_type, data)

Synchronous version of emit that properly awaits all callbacks. This is necessary because callbacks are fire-and-forget in async contexts, but in sync contexts wrapped with async_to_sync, the event loop may close before the tasks complete.

Event

add_callback(callback)

Add a callback to be executed after the event handler.

remove_callback(callback)

Remove a callback from the event.

EventRegistry

Bases: RegistryBase

Registry for managing events and their handlers. Allows registering event handlers and callbacks.

register_callback(event_type, callback)

Register a callback for an existing event.

register_event(event_type, handler, callbacks=None)

Register an event with its handler and optional callbacks.

unregister_callback(event_type, callback)

Unregister a callback for an existing event.

unregister_event(event_type)

Unregister an event by its type.

BaseWebsocketConsumer

Bases: AsyncWebsocketConsumer

This consumer handles WebSocket connections for whitebox.

connect() async

Called when client connects to the WebSocket.

disconnect(close_code) async

Called when client disconnects from the WebSocket.

on_connect() async

Called when the WebSocket connection is established. This method can be overridden to handle additional logic on connect.

BaseWebsocketEventConsumer

Bases: BaseWebsocketConsumer

receive(text_data) async

Called when client sends a message to the WebSocket.

Parameters:

Name	Type	Description	Default
text_data	str	The message sent by the client.	required

FlightConsumer

Bases: MessageThrottleMixin, BaseWebsocketEventConsumer