TESTING.md

Testing

Run the repository's current test environment with:

tox -e test

This executes tests/test_update_sources.sh, which exercises source update and lock-generation behavior with local temporary Git repositories.

Run repository lint checks with:

tox -e linters

The linter environment checks tracked Containerfiles and shell content through pre-commit. Use the narrowest applicable command first, then run both environments before proposing changes to build or source-maintenance behavior.

Regenerate dependency locks from committed source pins with Python 3.12:

uvx --python 3.12 tox -e update-lockfiles

The environment rejects other Python minor versions because environment markers can resolve a different package set. A clean regeneration must leave no tracked diff under containers/.

Additional change-specific validation is described in the developer guide.