Development

Local Setup

python3 -m venv .venv
. .venv/bin/activate
pip install -U pip uv
uv pip install -e ".[dev]"

Local Checks

ruff check .
mypy src
pytest -q
uv build
twine check dist/*
mkdocs build

Design Principles

• Keep the public API intentionally small.
• Preserve backward compatibility when the migration path is cheap and obvious.
• Prefer explicit auth/config models over implicit magic.
• Keep helper layers thin so hvac behavior remains transparent.