Skip to content
BETAGuardrails are in beta. The library, the configuration format and the CLI command can still change.

Guardrails

python

4 guardrails, all at version v1.

GuardrailDefault severityWhat it checks
python/build-backend-declaredwarningA packaged project names its build backend in [build-system], so it builds the same way everywhere.
python/lockfile-committedwarningThe project commits a lock file, so an install of the same commit resolves the same versions.
python/single-lockfilewarningThe project commits at most one lock file, so two installers do not each believe they own the environment.
python/version-declaredwarningThe project declares the Python version it is built and run against, and that version is no older than the configured floor.

Shared inputs

Every python guardrail declares these inputs, and each one may add its own.

InputDescriptionDefault
projectDirDirectory holding the project, relative to the directory the CLI runs in..

Shared collectors

Every python guardrail is handed the facts these collectors gather, and each one may ask for more of its own.

CollectorGathers
pythonThe Python project in the project directory: its manifest and build backend, the Python version it asks for, the requirements it declares and which of them are pinned, and the lock files committed beside them.

Every guardrail in this category is configured the same way, in the guardrails.checks array of buildnote.json. See Configuring guardrails for every option, and Guardrails to search the whole library.

Buildnote Limited
Registered in England and Wales, Reg: 16140412