Python
/
uv
mirror of https://github.com/astral-sh/uv
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Simplify managed Python flags (#12246) 

Currently, for users to specify at the command line whether to use
uv-managed or system Python interpreters, they use the
`--python-preference` parameter, which takes four possible values. This
is more complex than necessary since the normal case is to either say
"only managed" or "not managed". This PR hides the old
`--python-preference` parameter from help and documentation and adds two
new flags: `--managed-python` and `--no-managed-python` to capture the
"only managed" and "not managed" cases.

I have successfully tested this locally but currently cannot add
snapshot tests because of problems with distinguishing managed vs.
system interpreters in CI (and non-determinism when run on different
developers' machines). The `--python-preference` test in
`tool-install.rs` is currently ignored for this reason. See #5144 and
#7473.

---------

Co-authored-by: Zanie Blue <contact@zanie.dev>
This commit is contained in:
John Mumm 2025-03-18 18:13:14 +01:00 committed by GitHub
parent e9d2b6ecea
commit f66ce58a09
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
8 changed files with 569 additions and 716 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
crates/uv-cli/src/lib.rs
View File

@ -134,21 +134,44 @@ pub struct TopLevelArgs {
#[command(next_help_heading = "Global options", next_display_order = 1000)] #[command(next_help_heading = "Global options", next_display_order = 1000)]
#[allow(clippy::struct_excessive_bools)] #[allow(clippy::struct_excessive_bools)]
pub struct GlobalArgs { pub struct GlobalArgs {
/// Whether to prefer uv-managed or system Python installations.
///
/// By default, uv prefers using Python versions it manages. However, it
/// will use system Python installations if a uv-managed Python is not
/// installed. This option allows prioritizing or ignoring system Python
/// installations.
#[arg( #[arg(
global = true, global = true,
long, long,
help_heading = "Python options", help_heading = "Python options",
display_order = 700, display_order = 700,
env = EnvVars::UV_PYTHON_PREFERENCE env = EnvVars::UV_PYTHON_PREFERENCE,
hide = true
)] )]
pub python_preference: Option<PythonPreference>, pub python_preference: Option<PythonPreference>,
/// Require use of uv-managed Python versions.
///
/// By default, uv prefers using Python versions it manages. However, it
/// will use system Python versions if a uv-managed Python is not
/// installed. This option disables use of system Python versions.
#[arg(
global = true,
long,
help_heading = "Python options",
env = EnvVars::UV_MANAGED_PYTHON,
overrides_with = "no_managed_python",
conflicts_with = "python_preference"
)]
pub managed_python: bool,
/// Disable use of uv-managed Python versions.
///
/// Instead, uv will search for a suitable Python version on the system.
#[arg(
global = true,
long,
help_heading = "Python options",
env = EnvVars::UV_NO_MANAGED_PYTHON,
overrides_with = "managed_python",
conflicts_with = "python_preference"
)]
pub no_managed_python: bool,
#[allow(clippy::doc_markdown)] #[allow(clippy::doc_markdown)]
/// Allow automatically downloading Python when required. [env: "UV_PYTHON_DOWNLOADS=auto"] /// Allow automatically downloading Python when required. [env: "UV_PYTHON_DOWNLOADS=auto"]
#[arg(global = true, long, help_heading = "Python options", hide = true)] #[arg(global = true, long, help_heading = "Python options", hide = true)]
@ -4419,8 +4442,9 @@ pub enum PythonCommand {
/// By default, installed Python versions and the downloads for latest available patch version /// By default, installed Python versions and the downloads for latest available patch version
/// of each supported Python major version are shown. /// of each supported Python major version are shown.
/// ///
/// The displayed versions are filtered by the `--python-preference` option, i.e., if using /// Use `--managed-python` to view only managed Python versions.
/// `only-system`, no managed Python versions will be shown. ///
/// Use `--no-managed-python` to omit managed Python versions.
/// ///
/// Use `--all-versions` to view all available patch versions. /// Use `--all-versions` to view all available patch versions.
/// ///

9
crates/uv-static/src/env_vars.rs
View File

@ -140,10 +140,15 @@ impl EnvVars {
/// exclude distributions published after the specified date. /// exclude distributions published after the specified date.
pub const UV_EXCLUDE_NEWER: &'static str = "UV_EXCLUDE_NEWER"; pub const UV_EXCLUDE_NEWER: &'static str = "UV_EXCLUDE_NEWER";
/// Equivalent to the `--python-preference` command-line argument. Whether uv /// Whether uv should prefer system or managed Python versions.
/// should prefer system or managed Python versions.
pub const UV_PYTHON_PREFERENCE: &'static str = "UV_PYTHON_PREFERENCE"; pub const UV_PYTHON_PREFERENCE: &'static str = "UV_PYTHON_PREFERENCE";
/// Require use of uv-managed Python versions.
pub const UV_MANAGED_PYTHON: &'static str = "UV_MANAGED_PYTHON";
/// Disable use of uv-managed Python versions.
pub const UV_NO_MANAGED_PYTHON: &'static str = "UV_NO_MANAGED_PYTHON";
/// Equivalent to the /// Equivalent to the
/// [`python-downloads`](../reference/settings.md#python-downloads) setting and, when disabled, the /// [`python-downloads`](../reference/settings.md#python-downloads) setting and, when disabled, the
/// `--no-python-downloads` option. Whether uv should allow Python downloads. /// `--no-python-downloads` option. Whether uv should allow Python downloads.

21
crates/uv/src/settings.rs
View File

@ -73,6 +73,7 @@ impl GlobalSettings {
/// Resolve the [`GlobalSettings`] from the CLI and filesystem configuration. /// Resolve the [`GlobalSettings`] from the CLI and filesystem configuration.
pub(crate) fn resolve(args: &GlobalArgs, workspace: Option<&FilesystemOptions>) -> Self { pub(crate) fn resolve(args: &GlobalArgs, workspace: Option<&FilesystemOptions>) -> Self {
let network_settings = NetworkSettings::resolve(args, workspace); let network_settings = NetworkSettings::resolve(args, workspace);
let python_preference = resolve_python_preference(args, workspace);
Self { Self {
required_version: workspace required_version: workspace
.and_then(|workspace| workspace.globals.required_version.clone()), .and_then(|workspace| workspace.globals.required_version.clone()),
@ -120,10 +121,7 @@ impl GlobalSettings {
.combine(workspace.and_then(|workspace| workspace.globals.preview)) .combine(workspace.and_then(|workspace| workspace.globals.preview))
.unwrap_or(false), .unwrap_or(false),
), ),
python_preference: args python_preference,
.python_preference
.combine(workspace.and_then(|workspace| workspace.globals.python_preference))
.unwrap_or_default(),
python_downloads: flag(args.allow_python_downloads, args.no_python_downloads) python_downloads: flag(args.allow_python_downloads, args.no_python_downloads)
.map(PythonDownloads::from) .map(PythonDownloads::from)
.combine(env(env::UV_PYTHON_DOWNLOADS)) .combine(env(env::UV_PYTHON_DOWNLOADS))
@ -137,6 +135,21 @@ impl GlobalSettings {
} }
} }
fn resolve_python_preference(
args: &GlobalArgs,
workspace: Option<&FilesystemOptions>,
) -> PythonPreference {
if args.managed_python {
PythonPreference::OnlyManaged
} else if args.no_managed_python {
PythonPreference::OnlySystem
} else {
args.python_preference
.combine(workspace.and_then(|workspace| workspace.globals.python_preference))
.unwrap_or_default()
}
}
/// The resolved network settings to use for any invocation of the CLI. /// The resolved network settings to use for any invocation of the CLI.
#[derive(Debug, Clone)] #[derive(Debug, Clone)]
pub(crate) struct NetworkSettings { pub(crate) struct NetworkSettings {

145
crates/uv/tests/it/help.rs
View File

@ -7,7 +7,7 @@ fn help() {
let context = TestContext::new_with_versions(&[]); let context = TestContext::new_with_versions(&[]);
// The `uv help` command should show the long help message // The `uv help` command should show the long help message
uv_snapshot!(context.filters(), context.help(), @r###" uv_snapshot!(context.filters(), context.help(), @r#"
success: true success: true
exit_code: 0 exit_code: 0
----- stdout ----- ----- stdout -----
@ -42,11 +42,10 @@ fn help() {
--cache-dir [CACHE_DIR] Path to the cache directory [env: UV_CACHE_DIR=] --cache-dir [CACHE_DIR] Path to the cache directory [env: UV_CACHE_DIR=]
Python options: Python options:
--python-preference <PYTHON_PREFERENCE> --managed-python Require use of uv-managed Python versions [env: UV_MANAGED_PYTHON=]
Whether to prefer uv-managed or system Python installations [env: UV_PYTHON_PREFERENCE=] --no-managed-python Disable use of uv-managed Python versions [env: UV_NO_MANAGED_PYTHON=]
[possible values: only-managed, managed, system, only-system] --no-python-downloads Disable automatic downloads of Python. [env:
--no-python-downloads "UV_PYTHON_DOWNLOADS=never"]
Disable automatic downloads of Python. [env: "UV_PYTHON_DOWNLOADS=never"]
Global options: Global options:
-q, --quiet -q, --quiet
@ -81,14 +80,14 @@ fn help() {
----- stderr ----- ----- stderr -----
"###); "#);
} }
#[test] #[test]
fn help_flag() { fn help_flag() {
let context = TestContext::new_with_versions(&[]); let context = TestContext::new_with_versions(&[]);
uv_snapshot!(context.filters(), context.command().arg("--help"), @r###" uv_snapshot!(context.filters(), context.command().arg("--help"), @r#"
success: true success: true
exit_code: 0 exit_code: 0
----- stdout ----- ----- stdout -----
@ -122,11 +121,10 @@ fn help_flag() {
--cache-dir [CACHE_DIR] Path to the cache directory [env: UV_CACHE_DIR=] --cache-dir [CACHE_DIR] Path to the cache directory [env: UV_CACHE_DIR=]
Python options: Python options:
--python-preference <PYTHON_PREFERENCE> --managed-python Require use of uv-managed Python versions [env: UV_MANAGED_PYTHON=]
Whether to prefer uv-managed or system Python installations [env: UV_PYTHON_PREFERENCE=] --no-managed-python Disable use of uv-managed Python versions [env: UV_NO_MANAGED_PYTHON=]
[possible values: only-managed, managed, system, only-system] --no-python-downloads Disable automatic downloads of Python. [env:
--no-python-downloads "UV_PYTHON_DOWNLOADS=never"]
Disable automatic downloads of Python. [env: "UV_PYTHON_DOWNLOADS=never"]
Global options: Global options:
-q, --quiet -q, --quiet
@ -160,14 +158,14 @@ fn help_flag() {
Use `uv help` for more details. Use `uv help` for more details.
----- stderr ----- ----- stderr -----
"###); "#);
} }
#[test] #[test]
fn help_short_flag() { fn help_short_flag() {
let context = TestContext::new_with_versions(&[]); let context = TestContext::new_with_versions(&[]);
uv_snapshot!(context.filters(), context.command().arg("-h"), @r###" uv_snapshot!(context.filters(), context.command().arg("-h"), @r#"
success: true success: true
exit_code: 0 exit_code: 0
----- stdout ----- ----- stdout -----
@ -201,11 +199,10 @@ fn help_short_flag() {
--cache-dir [CACHE_DIR] Path to the cache directory [env: UV_CACHE_DIR=] --cache-dir [CACHE_DIR] Path to the cache directory [env: UV_CACHE_DIR=]
Python options: Python options:
--python-preference <PYTHON_PREFERENCE> --managed-python Require use of uv-managed Python versions [env: UV_MANAGED_PYTHON=]
Whether to prefer uv-managed or system Python installations [env: UV_PYTHON_PREFERENCE=] --no-managed-python Disable use of uv-managed Python versions [env: UV_NO_MANAGED_PYTHON=]
[possible values: only-managed, managed, system, only-system] --no-python-downloads Disable automatic downloads of Python. [env:
--no-python-downloads "UV_PYTHON_DOWNLOADS=never"]
Disable automatic downloads of Python. [env: "UV_PYTHON_DOWNLOADS=never"]
Global options: Global options:
-q, --quiet -q, --quiet
@ -239,14 +236,14 @@ fn help_short_flag() {
Use `uv help` for more details. Use `uv help` for more details.
----- stderr ----- ----- stderr -----
"###); "#);
} }
#[test] #[test]
fn help_subcommand() { fn help_subcommand() {
let context = TestContext::new_with_versions(&[]); let context = TestContext::new_with_versions(&[]);
uv_snapshot!(context.filters(), context.help().arg("python"), @r###" uv_snapshot!(context.filters(), context.help().arg("python"), @r#"
success: true success: true
exit_code: 0 exit_code: 0
----- stdout ----- ----- stdout -----
@ -318,22 +315,21 @@ fn help_subcommand() {
[env: UV_CACHE_DIR=] [env: UV_CACHE_DIR=]
Python options: Python options:
--python-preference <PYTHON_PREFERENCE> --managed-python
Whether to prefer uv-managed or system Python installations. Require use of uv-managed Python versions.
By default, uv prefers using Python versions it manages. However, it will use system By default, uv prefers using Python versions it manages. However, it will use system
Python installations if a uv-managed Python is not installed. This option allows Python versions if a uv-managed Python is not installed. This option disables use of
prioritizing or ignoring system Python installations. system Python versions.
[env: UV_PYTHON_PREFERENCE=] [env: UV_MANAGED_PYTHON=]
Possible values: --no-managed-python
- only-managed: Only use managed Python installations; never use system Python Disable use of uv-managed Python versions.
installations
- managed: Prefer managed Python installations over system Python installations Instead, uv will search for a suitable Python version on the system.
- system: Prefer system Python installations over managed Python installations
- only-system: Only use system Python installations; never use managed Python [env: UV_NO_MANAGED_PYTHON=]
installations
--no-python-downloads --no-python-downloads
Disable automatic downloads of Python. [env: "UV_PYTHON_DOWNLOADS=never"] Disable automatic downloads of Python. [env: "UV_PYTHON_DOWNLOADS=never"]
@ -447,14 +443,14 @@ fn help_subcommand() {
----- stderr ----- ----- stderr -----
"###); "#);
} }
#[test] #[test]
fn help_subsubcommand() { fn help_subsubcommand() {
let context = TestContext::new_with_versions(&[]); let context = TestContext::new_with_versions(&[]);
uv_snapshot!(context.filters(), context.help().env_remove(EnvVars::UV_PYTHON_INSTALL_DIR).arg("python").arg("install"), @r###" uv_snapshot!(context.filters(), context.help().env_remove(EnvVars::UV_PYTHON_INSTALL_DIR).arg("python").arg("install"), @r#"
success: true success: true
exit_code: 0 exit_code: 0
----- stdout ----- ----- stdout -----
@ -567,22 +563,21 @@ fn help_subsubcommand() {
[env: UV_CACHE_DIR=] [env: UV_CACHE_DIR=]
Python options: Python options:
--python-preference <PYTHON_PREFERENCE> --managed-python
Whether to prefer uv-managed or system Python installations. Require use of uv-managed Python versions.
By default, uv prefers using Python versions it manages. However, it will use system By default, uv prefers using Python versions it manages. However, it will use system
Python installations if a uv-managed Python is not installed. This option allows Python versions if a uv-managed Python is not installed. This option disables use of
prioritizing or ignoring system Python installations. system Python versions.
[env: UV_PYTHON_PREFERENCE=] [env: UV_MANAGED_PYTHON=]
Possible values: --no-managed-python
- only-managed: Only use managed Python installations; never use system Python Disable use of uv-managed Python versions.
installations
- managed: Prefer managed Python installations over system Python installations Instead, uv will search for a suitable Python version on the system.
- system: Prefer system Python installations over managed Python installations
- only-system: Only use system Python installations; never use managed Python [env: UV_NO_MANAGED_PYTHON=]
installations
--no-python-downloads --no-python-downloads
Disable automatic downloads of Python. [env: "UV_PYTHON_DOWNLOADS=never"] Disable automatic downloads of Python. [env: "UV_PYTHON_DOWNLOADS=never"]
@ -694,14 +689,14 @@ fn help_subsubcommand() {
----- stderr ----- ----- stderr -----
"###); "#);
} }
#[test] #[test]
fn help_flag_subcommand() { fn help_flag_subcommand() {
let context = TestContext::new_with_versions(&[]); let context = TestContext::new_with_versions(&[]);
uv_snapshot!(context.filters(), context.command().arg("python").arg("--help"), @r###" uv_snapshot!(context.filters(), context.command().arg("python").arg("--help"), @r#"
success: true success: true
exit_code: 0 exit_code: 0
----- stdout ----- ----- stdout -----
@ -723,11 +718,10 @@ fn help_flag_subcommand() {
--cache-dir [CACHE_DIR] Path to the cache directory [env: UV_CACHE_DIR=] --cache-dir [CACHE_DIR] Path to the cache directory [env: UV_CACHE_DIR=]
Python options: Python options:
--python-preference <PYTHON_PREFERENCE> --managed-python Require use of uv-managed Python versions [env: UV_MANAGED_PYTHON=]
Whether to prefer uv-managed or system Python installations [env: UV_PYTHON_PREFERENCE=] --no-managed-python Disable use of uv-managed Python versions [env: UV_NO_MANAGED_PYTHON=]
[possible values: only-managed, managed, system, only-system] --no-python-downloads Disable automatic downloads of Python. [env:
--no-python-downloads "UV_PYTHON_DOWNLOADS=never"]
Disable automatic downloads of Python. [env: "UV_PYTHON_DOWNLOADS=never"]
Global options: Global options:
-q, --quiet -q, --quiet
@ -761,14 +755,14 @@ fn help_flag_subcommand() {
Use `uv help python` for more details. Use `uv help python` for more details.
----- stderr ----- ----- stderr -----
"###); "#);
} }
#[test] #[test]
fn help_flag_subsubcommand() { fn help_flag_subsubcommand() {
let context = TestContext::new_with_versions(&[]); let context = TestContext::new_with_versions(&[]);
uv_snapshot!(context.filters(), context.command().arg("python").arg("install").arg("--help"), @r###" uv_snapshot!(context.filters(), context.command().arg("python").arg("install").arg("--help"), @r#"
success: true success: true
exit_code: 0 exit_code: 0
----- stdout ----- ----- stdout -----
@ -796,11 +790,10 @@ fn help_flag_subsubcommand() {
--cache-dir [CACHE_DIR] Path to the cache directory [env: UV_CACHE_DIR=] --cache-dir [CACHE_DIR] Path to the cache directory [env: UV_CACHE_DIR=]
Python options: Python options:
--python-preference <PYTHON_PREFERENCE> --managed-python Require use of uv-managed Python versions [env: UV_MANAGED_PYTHON=]
Whether to prefer uv-managed or system Python installations [env: UV_PYTHON_PREFERENCE=] --no-managed-python Disable use of uv-managed Python versions [env: UV_NO_MANAGED_PYTHON=]
[possible values: only-managed, managed, system, only-system] --no-python-downloads Disable automatic downloads of Python. [env:
--no-python-downloads "UV_PYTHON_DOWNLOADS=never"]
Disable automatic downloads of Python. [env: "UV_PYTHON_DOWNLOADS=never"]
Global options: Global options:
-q, --quiet -q, --quiet
@ -832,7 +825,7 @@ fn help_flag_subsubcommand() {
Display the uv version Display the uv version
----- stderr ----- ----- stderr -----
"###); "#);
} }
#[test] #[test]
@ -918,7 +911,7 @@ fn help_unknown_subsubcommand() {
fn help_with_global_option() { fn help_with_global_option() {
let context = TestContext::new_with_versions(&[]); let context = TestContext::new_with_versions(&[]);
uv_snapshot!(context.filters(), context.help().arg("--no-cache"), @r###" uv_snapshot!(context.filters(), context.help().arg("--no-cache"), @r#"
success: true success: true
exit_code: 0 exit_code: 0
----- stdout ----- ----- stdout -----
@ -953,11 +946,10 @@ fn help_with_global_option() {
--cache-dir [CACHE_DIR] Path to the cache directory [env: UV_CACHE_DIR=] --cache-dir [CACHE_DIR] Path to the cache directory [env: UV_CACHE_DIR=]
Python options: Python options:
--python-preference <PYTHON_PREFERENCE> --managed-python Require use of uv-managed Python versions [env: UV_MANAGED_PYTHON=]
Whether to prefer uv-managed or system Python installations [env: UV_PYTHON_PREFERENCE=] --no-managed-python Disable use of uv-managed Python versions [env: UV_NO_MANAGED_PYTHON=]
[possible values: only-managed, managed, system, only-system] --no-python-downloads Disable automatic downloads of Python. [env:
--no-python-downloads "UV_PYTHON_DOWNLOADS=never"]
Disable automatic downloads of Python. [env: "UV_PYTHON_DOWNLOADS=never"]
Global options: Global options:
-q, --quiet -q, --quiet
@ -992,7 +984,7 @@ fn help_with_global_option() {
----- stderr ----- ----- stderr -----
"###); "#);
} }
#[test] #[test]
@ -1034,7 +1026,7 @@ fn help_with_no_pager() {
// We can't really test whether the --no-pager option works with a snapshot test. // We can't really test whether the --no-pager option works with a snapshot test.
// It's still nice to have a test for the option to confirm the option exists. // It's still nice to have a test for the option to confirm the option exists.
uv_snapshot!(context.filters(), context.help().arg("--no-pager"), @r###" uv_snapshot!(context.filters(), context.help().arg("--no-pager"), @r#"
success: true success: true
exit_code: 0 exit_code: 0
----- stdout ----- ----- stdout -----
@ -1069,11 +1061,10 @@ fn help_with_no_pager() {
--cache-dir [CACHE_DIR] Path to the cache directory [env: UV_CACHE_DIR=] --cache-dir [CACHE_DIR] Path to the cache directory [env: UV_CACHE_DIR=]
Python options: Python options:
--python-preference <PYTHON_PREFERENCE> --managed-python Require use of uv-managed Python versions [env: UV_MANAGED_PYTHON=]
Whether to prefer uv-managed or system Python installations [env: UV_PYTHON_PREFERENCE=] --no-managed-python Disable use of uv-managed Python versions [env: UV_NO_MANAGED_PYTHON=]
[possible values: only-managed, managed, system, only-system] --no-python-downloads Disable automatic downloads of Python. [env:
--no-python-downloads "UV_PYTHON_DOWNLOADS=never"]
Disable automatic downloads of Python. [env: "UV_PYTHON_DOWNLOADS=never"]
Global options: Global options:
-q, --quiet -q, --quiet
@ -1108,5 +1099,5 @@ fn help_with_no_pager() {
----- stderr ----- ----- stderr -----
"###); "#);
} }

41
docs/concepts/python-versions.md
View File

@ -275,24 +275,43 @@ during `uv python install`.
[persistent configuration file](../configuration/files.md) to change the default behavior, or [persistent configuration file](../configuration/files.md) to change the default behavior, or
the `--no-python-downloads` flag can be passed to any uv command. the `--no-python-downloads` flag can be passed to any uv command.
## Adjusting Python version preferences ## Requiring or disabling managed Python versions
By default, uv will attempt to use Python versions found on the system and only download managed By default, uv will attempt to use Python versions found on the system and only download managed
interpreters when necessary. Python versions when necessary. To ignore system Python versions, and only use managed Python
versions, use the `--managed-python` flag:
The [`python-preference`](../reference/settings.md#python-preference) option can be used to adjust ```console
this behavior. By default, it is set to `managed` which prefers managed Python installations over $ uv python list --managed-python
system Python installations. However, system Python installations are still preferred over ```
Similarly, to ignore managed Python versions and only use system Python versions, use the
`--no-managed-python` flag:
```console
$ uv python list --no-managed-python
```
To change uv's default behavior in a configuration file, use the
[`python-preference` setting](#adjusting-python-version-preferences).
## Adjusting Python version preferences
The [`python-preference`](../reference/settings.md#python-preference) setting determines whether to
prefer using Python installations that are already present on the system, or those that are
downloaded and installed by uv.
By default, the `python-preference` is set to `managed` which prefers managed Python installations
over system Python installations. However, system Python installations are still preferred over
downloading a managed Python version. downloading a managed Python version.
The following alternative options are available: The following alternative options are available:
- `only-managed`: Only use managed Python installations; never use system Python installations - `only-managed`: Only use managed Python installations; never use system Python installations.
- `system`: Prefer system Python installations over managed Python installations Equivalent to `--managed-python`.
- `only-system`: Only use system Python installations; never use managed Python installations - `system`: Prefer system Python installations over managed Python installations.
- `only-system`: Only use system Python installations; never use managed Python installations.
These options allow disabling uv's managed Python versions entirely or always using them and Equivalent to `--no-managed-python`.
ignoring any existing system installations.
!!! note !!! note

11
docs/configuration/environment.md
View File

@ -179,6 +179,10 @@ Add additional context and structure to log messages.
If logging is not enabled, e.g., with `RUST_LOG` or `-v`, this has no effect. If logging is not enabled, e.g., with `RUST_LOG` or `-v`, this has no effect.
### `UV_MANAGED_PYTHON`
Require use of uv-managed Python versions.
### `UV_NATIVE_TLS` ### `UV_NATIVE_TLS`
Equivalent to the `--native-tls` command-line argument. If set to `true`, uv will Equivalent to the `--native-tls` command-line argument. If set to `true`, uv will
@ -229,6 +233,10 @@ Ignore `.env` files when executing `uv run` commands.
Skip writing `uv` installer metadata files (e.g., `INSTALLER`, `REQUESTED`, and `direct_url.json`) to site-packages `.dist-info` directories. Skip writing `uv` installer metadata files (e.g., `INSTALLER`, `REQUESTED`, and `direct_url.json`) to site-packages `.dist-info` directories.
### `UV_NO_MANAGED_PYTHON`
Disable use of uv-managed Python versions.
### `UV_NO_PROGRESS` ### `UV_NO_PROGRESS`
Equivalent to the `--no-progress` command-line argument. Disables all progress output. For Equivalent to the `--no-progress` command-line argument. Disables all progress output. For
@ -343,8 +351,7 @@ Distributions can be read from a local directory by using the `file://` URL sche
### `UV_PYTHON_PREFERENCE` ### `UV_PYTHON_PREFERENCE`
Equivalent to the `--python-preference` command-line argument. Whether uv Whether uv should prefer system or managed Python versions.
should prefer system or managed Python versions.
### `UV_REQUEST_TIMEOUT` ### `UV_REQUEST_TIMEOUT`

4
docs/guides/install-python.md
View File

@ -116,8 +116,8 @@ command invocation. See the
[Python discovery](../concepts/python-versions.md#discovery-of-python-versions) documentation for [Python discovery](../concepts/python-versions.md#discovery-of-python-versions) documentation for
details. details.
To force uv to use the system Python, provide the `--python-preference only-system` option. See the To force uv to use the system Python, provide the `--no-managed-python` flag. See the
[Python version preference](../concepts/python-versions.md#adjusting-python-version-preferences) [Python version preference](../concepts/python-versions.md#requiring-or-disabling-managed-python-versions)
documentation for more details. documentation for more details.
## Next steps ## Next steps

1012
docs/reference/cli.md
View File

File diff suppressed because it is too large Load Diff