diff --git a/crates/uv-cli/src/lib.rs b/crates/uv-cli/src/lib.rs index d6db18555..caccdf6e9 100644 --- a/crates/uv-cli/src/lib.rs +++ b/crates/uv-cli/src/lib.rs @@ -4332,10 +4332,10 @@ pub enum PythonCommand { /// Download and install Python versions. /// - /// Multiple Python versions may be requested. - /// /// Supports CPython and PyPy. CPython distributions are downloaded from the Astral - /// `python-build-standalone` project. PyPy distributions are downloaded from `python.org`. + /// `python-build-standalone` project. PyPy distributions are downloaded from `python.org`. The + /// available Python versions are bundled with each uv release. To install new Python versions, + /// you may need upgrade uv. /// /// Python versions are installed into the uv Python directory, which can be retrieved with `uv /// python dir`. @@ -4344,6 +4344,8 @@ pub enum PythonCommand { /// in uv commands or in active virtual environments. There is experimental support for adding /// Python executables to the `PATH` — use the `--preview` flag to enable this behavior. /// + /// Multiple Python versions may be requested. + /// /// See `uv help python` to view supported request formats. Install(PythonInstallArgs), diff --git a/crates/uv/tests/it/help.rs b/crates/uv/tests/it/help.rs index 93b6ece02..f677508ff 100644 --- a/crates/uv/tests/it/help.rs +++ b/crates/uv/tests/it/help.rs @@ -458,10 +458,10 @@ fn help_subsubcommand() { ----- stdout ----- Download and install Python versions. - Multiple Python versions may be requested. - Supports CPython and PyPy. CPython distributions are downloaded from the Astral - `python-build-standalone` project. PyPy distributions are downloaded from `python.org`. + `python-build-standalone` project. PyPy distributions are downloaded from `python.org`. The + available Python versions are bundled with each uv release. To install new Python versions, you may + need upgrade uv. Python versions are installed into the uv Python directory, which can be retrieved with `uv python dir`. @@ -470,6 +470,8 @@ fn help_subsubcommand() { commands or in active virtual environments. There is experimental support for adding Python executables to the `PATH` — use the `--preview` flag to enable this behavior. + Multiple Python versions may be requested. + See `uv help python` to view supported request formats. Usage: uv python install [OPTIONS] [TARGETS]... diff --git a/docs/concepts/python-versions.md b/docs/concepts/python-versions.md index c6f35519d..0413a4411 100644 --- a/docs/concepts/python-versions.md +++ b/docs/concepts/python-versions.md @@ -110,6 +110,11 @@ latest version. If a `.python-version` file is present, uv will install the Pyth the file. A project that requires multiple Python versions may define a `.python-versions` file. If present, uv will install all of the Python versions listed in the file. +!!! important + + The available Python versions are frozen for each uv release. To install new Python versions, + you may need upgrade uv. + ### Installing Python executables !!! important diff --git a/docs/reference/cli.md b/docs/reference/cli.md index 186a349c1..7ea836ed8 100644 --- a/docs/reference/cli.md +++ b/docs/reference/cli.md @@ -4742,14 +4742,14 @@ uv python list [OPTIONS] Download and install Python versions. -Multiple Python versions may be requested. - -Supports CPython and PyPy. CPython distributions are downloaded from the Astral `python-build-standalone` project. PyPy distributions are downloaded from `python.org`. +Supports CPython and PyPy. CPython distributions are downloaded from the Astral `python-build-standalone` project. PyPy distributions are downloaded from `python.org`. The available Python versions are bundled with each uv release. To install new Python versions, you may need upgrade uv. Python versions are installed into the uv Python directory, which can be retrieved with `uv python dir`. A `python` executable is not made globally available, managed Python versions are only used in uv commands or in active virtual environments. There is experimental support for adding Python executables to the `PATH` — use the `--preview` flag to enable this behavior. +Multiple Python versions may be requested. + See `uv help python` to view supported request formats.

Usage