Tooling Reference

This is the top-level map of the repository’s tooling and workflow surface.

Project Layout

src/mercury/            Python package — the exercise code
INTERVIEW_FORMAT.md     Exercise format, constraints, strategy
pyproject.toml          Python project config (hatchling build)
mise.toml               Toolchain versions (python, prek, dagger, trivy)
uv.lock                 Dependency lock file
.forgejo/workflows/     CI and release workflows
.dagger/                Dagger pipeline (docs build)
mise-tasks/             Mise task scripts
docs/                   Diataxis documentation (Quartz)
problems/               Practice prompts and generated datasets

Reference Map

• python-package-contract — package metadata, CLI entrypoints, dependencies, and test coverage
• automation-task-reference — grouped mise tasks
• git-hooks-reference — what prek enforces locally before commits and pushes
• docs-site-reference — docs build and preview entrypoints
• practice-problem-reference — the rehearsal prompts in problems/

Common Paths

• develop-locally — local development workflow
• run-released-package — how to run the latest packaged release with uvx mercury
• build-release-pipeline — end-to-end release behavior and artifact flow
• interview-repo-architecture — why the repo is structured this way before the interview solution exists

Toolchain Summary

• Python 3.14.4
• prek 0.3.8 — local hooks
• dagger 0.20.1 — docs build pipeline
• trivy 0.69.3 — vulnerability, secret, and misconfiguration scanning