Python package and CLI project structure

Top level, at Growing

• .gitGit history for the project. `uv init` creates the repository for you.
• .venvThe project virtual environment that uv creates and keeps in sync with uv.lock.
• .vscodeShared VS Code settings: the project interpreter, Ruff as formatter, pytest as test runner.
• .pytest_cachepytest's cache: which tests failed last time, for `--last-failed`.
• .ruff_cacheRuff's cache of already-checked files.
• .mypy_cachemypy's incremental cache.
• .coverageRaw coverage data written by pytest-cov.
• distBuilt distributions: the `.tar.gz` sdist and the `.whl` wheel from `uv build`.
• htmlcovThe browsable HTML coverage report from `coverage html`.
• siteThe built documentation website from `mkdocs build`.
• docsThe documentation site sources: Markdown pages that MkDocs turns into a website.
• srcHolds the import package. The "src layout" that `uv init --package` creates.
• testspytest tests, organised by kind: unit, CLI, end to end, and later property, snapshot and benchmark tests.
• .editorconfigIndentation, line endings and final newline rules for every editor.
• .gitignoreKeeps the venv, caches, build output and coverage files out of Git.
• .pre-commit-config.yamlRuns Ruff (lint and format), whitespace fixes and a uv.lock check before every commit.
• .python-versionThe Python version uv uses for local development, for example 3.14.
• LICENSEThe license text, for example MIT or Apache-2.0.
• README.mdThe front page on GitHub and on PyPI: what it does, install, one example, link to the docs.
• mkdocs.ymlMkDocs config: site name, Material theme, navigation and the mkdocstrings plugin.
• pyproject.tomlPackage metadata, dependencies, the console script, the build backend, and every tool's settings.
• uv.lockThe exact resolved version of every dependency for every platform, written by uv.