Index

heliaAOT Console API

Presentation layer for the CLI: durable results go to stdout, transient progress/logs/errors go to stderr, so piping machine output stays clean. Logging remains a separate debug channel (see helia_aot.utils.setup_logger) routed to the same stderr console so log lines and live spinners serialize.

Classes

AotConsole

AotConsole(verbosity: int = 1, *, explicit: bool = True)

Stage-progress renderer for pipeline runs.

Verbosity contract (CLI-installed consoles): 0: results only (no stage narration) 1 (default): phase headers + per-stage spinner resolving to ✓ 0.4s 2+: same, plus INFO/DEBUG logging interleaves via the shared stderr console

The implicit default console (library use without :func:set_console) is fully silent — AotConverter.convert() must not narrate to stderr or print to stdout unless a console was explicitly installed. Logging still receives the plain-text mirror either way.

Functions

results

results(context, elapsed: float) -> None

Render the closing results frame (explicitly installed consoles only).

Functions

get_console

get_console() -> AotConsole

The active console; silent (implicit) when none was installed.

set_console

set_console(verbosity: int) -> AotConsole

Install the run's console (called once by the CLI entry point).

print_error

print_error(exc: Exception) -> None

Render a user-facing error to stderr.

print_interrupted

print_interrupted() -> None

Render a clean interruption notice (Ctrl-C).