Developer Checklist

Install the package with development dependencies:

python -m pip install -e ".[dev,docs,release]"

Run the full verification suite:

python -m ruff check .
python -m ruff format --check .
python -m mypy OpenUtility
python -m pytest --cov=OpenUtility --cov-report=term-missing --cov-fail-under=90
python -m sphinx -W -b html docs /tmp/openutility-docs-html
python -m build --no-isolation

Validate release metadata:

python scripts/check_lockfile_version.py
python scripts/check_release_version.py
python scripts/check_release_tag.py v0.1.0

Run the single release gate:

python tools/release_check.py

The release gate checks linting, formatting, typing, tests, docs, build metadata, wheel contents, dependency audit, and a fresh-install smoke test.

The public test suite must not import or read private replication workflows. Use small package-owned fixtures for reproducible tests.