Module env

Manage an application’s UV environment.

Modules

migration 🔒

Constants

BASE_CMD

Statics

MINIMUM_UV_LAUNCHER_PYTHON 🔒

Python versions below this cannot execute UV’s Windows console-script launchers. See provision_with_pip.

MINIMUM_UV_VERSION 🔒

Functions

add_commands 🔒

add_helps 🔒

add_prephase_cmds 🔒

discovered_python_executable 🔒

Resolve the discovered Python command to a concrete interpreter path, so it can be handed to UV unambiguously.

ensure_uv_available 🔒

guard_uv_manifest 🔒

is_installable_project 🔒

Does UV install this project itself, or only its dependencies?

needs_pip_provisioning 🔒

UV writes Windows console scripts as a trampoline with a zip archive appended. The trampoline runs python.exe <the .exe itself> and relies on the interpreter executing that archive. CPython’s old C zipimport, used up to and including 3.7, rejects it and falls back to parsing the executable as source, so every console script in such an environment is unusable – pytest, and origen itself. CPython 3.8 replaced zipimport with the pure-Python implementation, which reads it correctly.

provision 🔒

Install the locked environment.

provision_with_pip 🔒

require_python 🔒

require_uv 🔒

run

run_pre_phase 🔒

run_python 🔒

run_uv 🔒