Build CLI skeleton with typer: stack run/load/generate/bib/lake/db/validate/docs #2

Closed
opened 2026-03-12 17:32:20 +00:00 by kert · 0 comments
Owner

Create src/cli/__init__.py with typer app and subcommands:

stack run <pipeline>     # execute a pipeline
stack load <source>      # ingest CCLF/BCDA/seed data
stack generate models    # regenerate table models from DuckDB
stack bib sync|tag|query # bibliography operations
stack lake deploy|load   # lakehouse schema + data
stack db comment|inspect # DuckDB utilities
stack validate           # schema validation across all pipelines
stack docs build|serve   # generate and serve documentation

Each subcommand should be a separate module under src/cli/.
Wire [project.scripts] in pyproject.toml so uv run stack works.
All commands read from stack.toml via conf.

Create `src/cli/__init__.py` with typer app and subcommands: ``` stack run <pipeline> # execute a pipeline stack load <source> # ingest CCLF/BCDA/seed data stack generate models # regenerate table models from DuckDB stack bib sync|tag|query # bibliography operations stack lake deploy|load # lakehouse schema + data stack db comment|inspect # DuckDB utilities stack validate # schema validation across all pipelines stack docs build|serve # generate and serve documentation ``` Each subcommand should be a separate module under `src/cli/`. Wire `[project.scripts]` in pyproject.toml so `uv run stack` works. All commands read from `stack.toml` via `conf`.
kert added this to the P1: Foundation — Config, CLI scaffold, auth milestone 2026-03-12 17:32:20 +00:00
kert added the cli label 2026-03-12 17:32:20 +00:00
kert closed this issue 2026-03-12 18:45:56 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: homelab/stack#2