generated from coulomb/repo-seed
tegwick
c0a9261cdc
Add profile.sandbox-canary, HostSnapshot/inventory/stale schemas, SSH collectors, before/after provision deltas, telemetry export to State Hub and local JSON, default `sandboxer create` self-deploy, inspect/reap-stale CLI, runbook, and CoulombCore verification (26 tests pass).
1.6 KiB
1.6 KiB
Stack
- Language: Python 3.11+
- Package manager: uv
- Build: hatchling (src layout:
src/sandboxer/) - CLI: typer (
sandboxerentry point) - Test: pytest
- Lint / format: ruff
Dev Commands
Run from the repo root. First-time setup:
make setup # uv sync --all-groups → .venv
make install # sandboxer → ~/.local/bin (ensure ~/.local/bin is on PATH)
Without global install, prefix commands with uv run from the repo root:
uv run sandboxer create --profile profile.compose-e2e --input repo=/path/to/repo
Day-to-day verification (run before committing):
make check # lint + test
make test # pytest
make lint # ruff check
make format # ruff format (apply fixes)
make build # uv build (wheel + sdist)
make cli-version # smoke test: sandboxer version
Sandbox CLI (v0):
sandboxer create # canary self-deploy (profile.sandbox-canary)
sandboxer create --profile profile.compose-e2e --input repo=/path/to/repo
sandboxer get <id>
sandboxer list
sandboxer destroy <id>
sandboxer recreate <id>
sandboxer inspect host
sandboxer inspect stale
sandboxer reap-stale # dry-run; add --apply to remove
export SANDBOXER_COMPOSE_CMD=podman-compose # required on CoulombCore
Equivalent uv invocations without Make:
uv sync --all-groups
uv run pytest
uv run ruff check .
uv run ruff format .
uv build
uv run sandboxer version
No long-running service yet — API and provisioner land in SAND-WP-0002.