fleetlint Policy for a fleet of repositories
v0.4
Getting started

repo/toolchain-pinned/python

Toolchain version is pinned

Implements repo/toolchain-pinned for python.

Severitywarning
Tiers1, 2
Stackspython
Scopeeach
Kindexpr
Sourcelibrary v0.1.0
Selected byfleetlint-recommended@v0.1.0

Requirement

.python-version names a version, or .tool-versions/mise names python with a version. requires-python is a range, not a pin.

Why

Without a pin, every machine and every CI run builds with whatever compiler or runtime happens to be installed, and failures cannot be reproduced.

Check

["", "../", "../../", "../../../"].exists(d, file(d + ".python-version") && scan(d + ".python-version", r'^\s*\d').size() > 0) || ["", "../", "../../", "../../../"].exists(d, file(d + ".tool-versions") && scan(d + ".tool-versions", r'^\s*(python)\s+\S*\d').size() > 0) || ["", "../", "../../", "../../../"].exists(d, ["mise.toml", ".mise.toml", ".config/mise.toml", ".config/mise/config.toml", "mise/config.toml"].exists(n,
     file(d + n) && scan(d + n, r'^\s*"?(python)"?\s*=\s*[^#\n]*\d').size() > 0))

Fix

Run uv python pin 3.x (writes .python-version).

Agent instruction: Add the stack’s toolchain pin set to the version currently installed; do not upgrade the toolchain in the same change.

See: https://fleetlint.org/baseline/#hygiene, https://fleetlint.org/stacks/, https://fleetlint.org/stacks/#python


Generated by fleetlint docs from catalog v0.1.0.