neuralqx.utils.io.printing package

class AbstractPrinter(logger=None, console=None)

Bases: ABC

class NQXPrinter(logger=None, console=None)

Bases: AbstractPrinter

Default neuraLQX printer implementation.

This printer renders user-facing messages to a Rich-enabled console and records them via the underlying logger. Output is formatted as Rich panels containing the message, timestamp, and caller information for improved readability and traceability.

The printer is MPI-aware: messages are only displayed on the global master rank (rank 0) unless running in serial mode. Worker ranks remain silent to avoid duplicated output.

Printing behavior is controlled by the global configuration; messages are only emitted when the NQX_VERBOSE configuration flag is enabled.

In addition to real-time message display, the printer can render all accumulated log entries in a structured Rich table for post hoc inspection.

This class is intended to be the default console printer for neuraLQX applications.

Submodules