Devtools#
This appendix summarizes the development helpers under devtools/.
Conda environments#
Environment definitions are stored in devtools/conda-envs/.
Common choices:
development_env.yamlfor day-to-day development,test_env.yamlfor test-focused execution,docs_env.yamlfor documentation builds,release_gates_env.yamlfor release-gate parity checks.
Standalone environment creation from the repository root (Python 3.14):
conda env create --name pyunitwizard-dev --file devtools/conda-envs/development_env.yaml
conda activate pyunitwizard-dev
python -m pip install --no-deps --editable .
Recommended local baseline#
python -m pytest --receptor=llm tests
make -C docs html
Use this baseline before opening PRs or preparing release tags.
Routine Linux development uses the shared Python 3.14 workspace described in Development Environment. Authorized internal direct pushes use the common scoped-checkpoint policy; PR and publication gates retain their full requirements.
Maintenance tools#
python devtools/devguide_index.pyregenerates issue-backed report indexes;--checkverifies them without changing files.python devtools/check_dependency_routes.pychecks the declared dependency routes using the pinned suite SDK. It does not replace a clean installed artifact qualification or a global environment dependency check.python devtools/benchmark_backend_attribution.pymeasures warmed optional attribution paths; retain its raw samples and provider capabilities.