owa-tui

owa-tui is a Textual terminal UI front-end for the owa-tools Microsoft 365 CLI suite.

The project is intentionally separate from owa-tools: owa-tui imports only the stable owa-tools library API and never imports broker internals directly.

Status

This package currently provides the installable launcher shell. Calendar, mail, and graph screens are being ported to Textual behind that launcher.

Install

pip install owa-tui

Usage

owa-tui --help
owa-tui --version
owa-tui

Running owa-tui starts the Textual shell. No Microsoft Graph or broker calls are made during startup.

Development

.venv/bin/ruff check .
.venv/bin/python -m compileall -q src
.venv/bin/python -m pytest -q --cov --cov-fail-under=85
uv build

CI (.github/workflows/ci.yml) runs all of the above plus the tui-test e2e suite on Python 3.10–3.12 for every push to main and every PR.

End-to-end terminal tests (tui-test)

In-process pytest covers widget logic; @microsoft/tui-test covers the real binary by spawning owa-tui in a pty and asserting on what it actually renders. Tests live in e2e/.

npm install          # one-time
npm run test:e2e     # or: npx tui-test

owa-tui must be importable on PATH (e.g. pip install -e .). Traces land in tui-traces/; replay with npx tui-test show-trace.

A live-Graph smoke runs only when opted in: OWA_TUI_LIVE_E2E=1 npx tui-test e2e/live.test.ts (and OWA_TUI_LIVE_TESTS=1 for the unit-level token smoke).

Releasing

Pushing a v* tag triggers .github/workflows/release.yml: it re-runs the full gates (lint, compile, coverage, e2e) on Python 3.10–3.12, then uv builds the wheel/sdist and publishes a GitHub Release. PyInstaller standalone binaries and PyPI publishing are not wired yet.