taurus.core.diagnostics

Read-only diagnostic snapshots for live Taurus models.

Classes

class AttributeDiagnostics(name: str, listener_count: int, listeners: tuple, subscription_state: str, polling_active: bool, polling_period: int, event_counts: dict, last_event_time: float | None)

Diagnostic information for an attribute model.

(more info)

class DeviceDiagnostics(name: str, idl_version: int | None, events_support: str, listener_count: int, listeners: tuple, event_counts: dict)

Diagnostic information for a device model.

idl_version and events_support are optional, backend-specific capabilities. They are currently provided by Tango devices.

(more info)

class FactoryDiagnostics(name: str, schemes: tuple, details: dict)

Diagnostic information provided by a Taurus factory.

(more info)

Functions

collect_attribute_diagnostics(factory=None)

Return snapshots for attributes already created by Taurus factories.

This function only inspects existing models. It never creates attributes, registers listeners, starts polling, or changes event subscriptions.

Parameters:

factory – optional factory providing getExistingAttributes. If omitted, all available Taurus factories are inspected.

Returns:

tuple of AttributeDiagnostics, sorted by model name

collect_device_diagnostics(factory=None, device_info_cache=None)

Return snapshots for devices already created by Taurus factories.

If factory is omitted, all available Taurus factories are inspected. device_info_cache avoids repeating backend capability queries on every UI refresh. Event count is the total number of events dispatched while event statistics were enabled for attributes belonging to the device.

collect_factory_diagnostics(factory=None)

Return runtime information for the available Taurus factories.

Optional factories which cannot be initialized are omitted. A failure in one factory’s diagnostic hook does not prevent reporting the others.