All notable changes to this project will be documented in this file.
This project follows a pragmatic versioning approach:
- Patch: bug fixes / docs / small improvements.
- Minor: new template features or non-breaking developer workflow changes.
- Major: breaking template changes (e.g., required file/command renames).
TODO: Template note: when you create a new project from this template, you should reset the changelog to reflect your new project’s history.
-
Added
- Placeholder for future changes.
-
Changed
- Placeholder for future changes.
-
Fixed
- Placeholder for future changes.
Initial public template release.
-
Added
- Poetry + Python 3.12 base project (
pyproject.toml) with local.venvworkflow. - Typer CLI with:
- Global constructor callback (
Main) and--versionoption. - Example commands:
hello,config-path. - Example subcommand group:
random num,random str.
- Global constructor callback (
- Rich logging integration with:
InitLogging(verbosity)and globalConsole()singleton access pattern.
- Cross-platform config path helper using
platformdirs(resources/config.py). - Ruff configured as:
- formatter (2-space indentation, single quotes)
- linter with
select = ["ALL"]plus template-focused ignores (including allowing PascalCase for methods).
- Strict typing with MyPy (
strict = true) and Pyright (typeCheckingMode = "strict"). - Pytest suite with didactic examples, parametrize + patch, and CLI runner usage.
- pre-commit hooks for Ruff + MyPy (pinned versions).
- GitHub Actions CI running: lint, format check, typing, tests + coverage.
- Poetry + Python 3.12 base project (
-
Changed
- N/A
-
Fixed
- N/A