pytauargus-tui

A lightweight Textual terminal UI for Tau-Argus — a thin interactive view over the pytauargus engine.

Design: Option B. The TUI is a presentation layer only — every action is a call the headless CLI already makes. It re-implements no engine behaviour and never touches the native bindings directly.

Screenshots

Install

pip install pytauargus-tui
# or, as an extra of the engine package:
pip install "pytauargus[tui]"

This pulls pytauargus (the native engine + tauargus CLI) and textual, so one install gives you both the headless CLI and the TUI.

Run

tauargus-tui                 # opens a file browser
tauargus-tui path/to/batch.arb

Load a .arb batch, browse the computed tables, inspect cells, preview suppression/rounding, audit feasibility intervals, and save outputs.

Full user guide (all screenshots, key reference, implemented vs outstanding): docs/tui.md.

Layout

• Left — table navigator (one row per specify_table) with its explanatory/response variables and active safety rules.
• Center — the computed table as a grid; each cell is coloured by its status category (S=green, U=red, P=cyan, M=yellow, E=dim).
• Detail (bottom) — the selected cell's value, full status name and, after an audit, its realised feasibility interval.
• Log/status (bottom) — the engine log stream and a keymap hint.

Develop

cd bindings/tui
uv sync --extra test        # resolves pytauargus from the sibling package
.venv/bin/python -m pytest

The [tool.uv.sources] override in pyproject.toml points pytauargus at ../python (editable) so the TUI follows the in-tree engine; it never leaks into the published wheel metadata. The superbuild output (engine/build/lib) must exist — scripts/sync-venv.sh builds it if needed.