pytauargus-tui

An interactive terminal UI for Tau-Argus, the statistical disclosure control engine. It is a thin view over the pytauargus engine — every action is a call the headless CLI already makes — and installing it gives you the tauargus CLI as well.

Screenshots

What it does

• Runs your .arb batch — the full Tau-Argus pipeline (apriori safety rules, suppression, rounding, audit) with every computed table browsable. Start without a file and a .arb file browser opens.
• Colours cells by status — green safe · red unsafe (a sensitive value) · cyan protected · yellow hidden by a suppression · dim empty. All 14 engine status codes are recognised and named.
• Shows what any cell means — value, status name, pending mark, and after an audit the realised feasibility interval, for the cell under the cursor.
• Lets you mark cells before solving — u require suppression, p protect (keep), S override safe. Marks are instant draft edits with toggle/replace and undo/redo; the solver never runs until you ask.
• Previews suppression and rounding — s (OPT, whole table) and r (RND) run on a throwaway copy of your batch: you inspect the previewed grid, then y accepts or n cancels. Your working table never changes behind your back, and a preview that is no longer current is flagged.
• Audits — realised feasibility intervals per cell (a).
• Exports — writes the accepted table as a legacy INTERMEDIATE .tab file (o).
• Saves the workspace — a versioned, fingerprinted JSON manifest of everything you did (accepted operations, cell marks) next to the .arb (w).
• Reopens a saved workspace — launch tauargus-tui on the .workspace.json (or pick it in the file browser): the accepted result is rebuilt through the engine, the pending draft comes back (undoable), and the revisions are continuous. If the .arb changed since the save, the old outcome is not treated as current — the current input opens fresh instead, with a clear message.
• Writes a replay batch — R materialises the accepted recipe as a headless-runnable .arb (plus apriori files) next to the input, so tauargus run <stem>.replay.arb reproduces the recorded operator intent.

What it can't do (yet)

• Mark total cells — that needs the real total code, which the display labels do not preserve; the app blocks such marks with a message.
• Choose the rounding base — r always uses the engine's minimum base.
• Work on several batches — one .arb per session, and the batch spec itself is not editable from the UI.

Install

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

Run

tauargus-tui                          # opens a file browser (.arb + saved workspaces)
tauargus-tui path/to/batch.arb        # opens that .arb batch directly
tauargus-tui path/to/batch.workspace.json   # reopens a saved workspace

Full user guide — every key, every status code, the whole workflow: docs/tui.md.

Develop (monorepo)

cd bindings/tui
uv sync --extra test
.venv/bin/python -m pytest