uv/docs/reference
Zanie Blue 9b8d6989d4
Allow pinning managed Python versions to specific build versions (#15314)
Allows pinning the Python build version via environment variables, e.g.,
`UV_PYTHON_CPYTHON_BUILD=...`. Each variable is implementation specific,
because they use different versioning schemes.

Updates the Python download metadata to include a `build` string, so we
can filter downloads by the pin. Writes the build version to a file in
the managed install, e.g., `cpython-3.10.18-macos-aarch64-none/BUILD`,
so we can filter installed versions by the pin.

Some important follow-up here:

- Include the build version in not found errors (when pinned)
- Automatically use a remote list of Python downloads to satisfy build
versions not present in the latest embedded download metadata

Some less important follow-ups to consider:

- Allow using ranges for build version pins
2025-08-25 16:25:05 -05:00
..
internals Move Resolver to new Internals section in the Reference (#15465) 2025-08-22 19:26:16 -05:00
policies Add 3.14 to the supported platform reference (#13990) 2025-06-12 15:18:48 +00:00
troubleshooting Fix and improve docs (#13620) 2025-06-10 13:15:38 -05:00
benchmarks.md Add link to benchmarks in documentation (#6257) 2024-08-20 12:54:46 -04:00
cli.md Add --python-platform to uv pip check (#15486) 2025-08-24 14:14:42 -04:00
environment.md Allow pinning managed Python versions to specific build versions (#15314) 2025-08-25 16:25:05 -05:00
index.md Move Resolver to new Internals section in the Reference (#15465) 2025-08-22 19:26:16 -05:00
installer.md Add UV_ prefix to installer environment variables (#14964) 2025-07-30 01:24:59 +00:00
settings.md Update cli.md to use proper uv cache subcommand "clean" (#15313) 2025-08-15 21:06:37 +00:00