mirrors/uv
1
0
Fork 0
mirror of https://github.com/astral-sh/uv.git synced 2025-11-03 21:23:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 3

Update the interface for declaring Python download preferences (#5936)

Browse source 
The loose consensus is that "fetch" doesn't have much meaning and that a
boolean flag makes more sense from the command line.

1. Adds `--allow-python-downloads` (hidden, default) and
`--no-python-downloads` to the CLI to quickly enable or disable
downloads
2. Deprecates `--python-fetch` in favor of the options from (1)
3. Removes  `python-fetch` in favor of a `python-downloads` setting
5. Adds a `never` variant to the enum, allowing even explicit installs
to be disabled via the configuration file

## Test plan

I tested this with various `pyproject.toml`-level settings and `uv venv
--preview --python 3.12.2` and `uv python install 3.12.2` with and
without the new CLI flags.
This commit is contained in:
Zanie Blue 2024-08-09 13:10:19 -05:00 • committed by GitHub
parent a129cf7d7e
commit 4df0fe9a01
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
28 changed files with 266 additions and 488 deletions
Download patch file Download diff file Expand all files Collapse all files

16
crates/uv-cli/src/lib.rs
View file

@ -15,7 +15,7 @@ use uv_configuration::{
ConfigSettingEntry, IndexStrategy, KeyringProviderType, PackageNameSpecifier, TargetTriple, ConfigSettingEntry, IndexStrategy, KeyringProviderType, PackageNameSpecifier, TargetTriple,
}; };
use uv_normalize::{ExtraName, PackageName}; use uv_normalize::{ExtraName, PackageName};
use uv_python::{PythonFetch, PythonPreference, PythonVersion}; use uv_python::{PythonDownloads, PythonPreference, PythonVersion};
use uv_resolver::{AnnotationStyle, ExcludeNewer, PrereleaseMode, ResolutionMode}; use uv_resolver::{AnnotationStyle, ExcludeNewer, PrereleaseMode, ResolutionMode};
pub mod compat; pub mod compat;
@ -119,9 +119,17 @@ pub struct GlobalArgs {
)] )]
pub python_preference: Option<PythonPreference>, pub python_preference: Option<PythonPreference>,
/// Whether to automatically download Python when required. /// Allow automatically downloading Python when required.
#[arg(global = true, long, help_heading = "Python options", hide = true)]
pub allow_python_downloads: bool,
/// Disable automatic downloads of Python.
#[arg(global = true, long, help_heading = "Python options")] #[arg(global = true, long, help_heading = "Python options")]
pub python_fetch: Option<PythonFetch>, pub no_python_downloads: bool,
/// Deprecated version of [`Self::python_downloads`].
#[arg(global = true, long, hide = true)]
pub python_fetch: Option<PythonDownloads>,
/// Do not print any output. /// Do not print any output.
#[arg(global = true, long, short, conflicts_with = "verbose")] #[arg(global = true, long, short, conflicts_with = "verbose")]
@ -258,7 +266,7 @@ pub enum Commands {
/// ///
/// When preview is enabled, i.e., via `--preview` or by using a preview /// When preview is enabled, i.e., via `--preview` or by using a preview
/// command, uv will download Python if a version cannot be found. This /// command, uv will download Python if a version cannot be found. This
/// behavior can be disabled with the `--python-fetch` option. /// behavior can be disabled with the `--python-downloads` option.
/// ///
/// The `--python` option allows requesting a different interpreter. /// The `--python` option allows requesting a different interpreter.
/// ///

21
crates/uv-python/src/discovery.rs
View file

@ -79,12 +79,25 @@ pub enum PythonPreference {
#[serde(deny_unknown_fields, rename_all = "kebab-case")] #[serde(deny_unknown_fields, rename_all = "kebab-case")]
#[cfg_attr(feature = "clap", derive(clap::ValueEnum))] #[cfg_attr(feature = "clap", derive(clap::ValueEnum))]
#[cfg_attr(feature = "schemars", derive(schemars::JsonSchema))] #[cfg_attr(feature = "schemars", derive(schemars::JsonSchema))]
pub enum PythonFetch { pub enum PythonDownloads {
/// Automatically fetch managed Python installations when needed. /// Automatically download managed Python installations when needed.
#[default] #[default]
#[serde(alias = "auto")]
Automatic, Automatic,
/// Do not automatically fetch managed Python installations; require explicit installation. /// Do not automatically download managed Python installations; require explicit installation.
Manual, Manual,
/// Do not ever allow Python downloads.
Never,
}
impl From<bool> for PythonDownloads {
fn from(value: bool) -> Self {
if value {
PythonDownloads::Automatic
} else {
PythonDownloads::Never
}
}
} }
#[derive(Debug, Clone, Copy, PartialEq, Eq, Default)] #[derive(Debug, Clone, Copy, PartialEq, Eq, Default)]
@ -1298,7 +1311,7 @@ impl PythonPreference {
} }
} }
impl PythonFetch { impl PythonDownloads {
pub fn is_automatic(self) -> bool { pub fn is_automatic(self) -> bool {
matches!(self, Self::Automatic) matches!(self, Self::Automatic)
} }

8
crates/uv-python/src/installation.rs
View file

@ -15,7 +15,7 @@ use crate::implementation::LenientImplementationName;
use crate::managed::{ManagedPythonInstallation, ManagedPythonInstallations}; use crate::managed::{ManagedPythonInstallation, ManagedPythonInstallations};
use crate::platform::{Arch, Libc, Os}; use crate::platform::{Arch, Libc, Os};
use crate::{ use crate::{
downloads, Error, Interpreter, PythonFetch, PythonPreference, PythonSource, PythonVersion, downloads, Error, Interpreter, PythonDownloads, PythonPreference, PythonSource, PythonVersion,
}; };
/// A Python interpreter and accompanying tools. /// A Python interpreter and accompanying tools.
@ -77,11 +77,11 @@ impl PythonInstallation {
/// Find or fetch a [`PythonInstallation`]. /// Find or fetch a [`PythonInstallation`].
/// ///
/// Unlike [`PythonInstallation::find`], if the required Python is not installed it will be installed automatically. /// Unlike [`PythonInstallation::find`], if the required Python is not installed it will be installed automatically.
pub async fn find_or_fetch<'a>( pub async fn find_or_download<'a>(
request: Option<PythonRequest>, request: Option<PythonRequest>,
environments: EnvironmentPreference, environments: EnvironmentPreference,
preference: PythonPreference, preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
client_builder: &BaseClientBuilder<'a>, client_builder: &BaseClientBuilder<'a>,
cache: &Cache, cache: &Cache,
reporter: Option<&dyn Reporter>, reporter: Option<&dyn Reporter>,
@ -94,7 +94,7 @@ impl PythonInstallation {
// If missing and allowed, perform a fetch // If missing and allowed, perform a fetch
Err(Error::MissingPython(err)) Err(Error::MissingPython(err))
if preference.allows_managed() if preference.allows_managed()
&& python_fetch.is_automatic() && python_downloads.is_automatic()
&& client_builder.connectivity.is_online() => && client_builder.connectivity.is_online() =>
{ {
if let Some(request) = PythonDownloadRequest::from_request(&request) { if let Some(request) = PythonDownloadRequest::from_request(&request) {

2
crates/uv-python/src/lib.rs
View file

@ -2,7 +2,7 @@
use thiserror::Error; use thiserror::Error;
pub use crate::discovery::{ pub use crate::discovery::{
find_python_installations, EnvironmentPreference, Error as DiscoveryError, PythonFetch, find_python_installations, EnvironmentPreference, Error as DiscoveryError, PythonDownloads,
PythonNotFound, PythonPreference, PythonRequest, PythonSource, VersionRequest, PythonNotFound, PythonPreference, PythonRequest, PythonSource, VersionRequest,
}; };
pub use crate::environment::PythonEnvironment; pub use crate::environment::PythonEnvironment;

4
crates/uv-settings/src/combine.rs
View file

@ -4,7 +4,7 @@ use std::path::PathBuf;
use distribution_types::IndexUrl; use distribution_types::IndexUrl;
use install_wheel_rs::linker::LinkMode; use install_wheel_rs::linker::LinkMode;
use uv_configuration::{ConfigSettings, IndexStrategy, KeyringProviderType, TargetTriple}; use uv_configuration::{ConfigSettings, IndexStrategy, KeyringProviderType, TargetTriple};
use uv_python::{PythonFetch, PythonPreference, PythonVersion}; use uv_python::{PythonDownloads, PythonPreference, PythonVersion};
use uv_resolver::{AnnotationStyle, ExcludeNewer, PrereleaseMode, ResolutionMode}; use uv_resolver::{AnnotationStyle, ExcludeNewer, PrereleaseMode, ResolutionMode};
use crate::{FilesystemOptions, PipOptions}; use crate::{FilesystemOptions, PipOptions};
@ -70,7 +70,7 @@ impl_combine_or!(ResolutionMode);
impl_combine_or!(String); impl_combine_or!(String);
impl_combine_or!(TargetTriple); impl_combine_or!(TargetTriple);
impl_combine_or!(PythonPreference); impl_combine_or!(PythonPreference);
impl_combine_or!(PythonFetch); impl_combine_or!(PythonDownloads);
impl_combine_or!(bool); impl_combine_or!(bool);
impl<T> Combine for Option<Vec<T>> { impl<T> Combine for Option<Vec<T>> {

8
crates/uv-settings/src/settings.rs
View file

@ -11,7 +11,7 @@ use uv_configuration::{
}; };
use uv_macros::{CombineOptions, OptionsMetadata}; use uv_macros::{CombineOptions, OptionsMetadata};
use uv_normalize::{ExtraName, PackageName}; use uv_normalize::{ExtraName, PackageName};
use uv_python::{PythonFetch, PythonPreference, PythonVersion}; use uv_python::{PythonDownloads, PythonPreference, PythonVersion};
use uv_resolver::{AnnotationStyle, ExcludeNewer, PrereleaseMode, ResolutionMode}; use uv_resolver::{AnnotationStyle, ExcludeNewer, PrereleaseMode, ResolutionMode};
/// A `pyproject.toml` with an (optional) `[tool.uv]` section. /// A `pyproject.toml` with an (optional) `[tool.uv]` section.
@ -143,16 +143,16 @@ pub struct GlobalOptions {
possible_values = true possible_values = true
)] )]
pub python_preference: Option<PythonPreference>, pub python_preference: Option<PythonPreference>,
/// Whether to automatically download Python when required. /// Whether to allow Python downloads.
#[option( #[option(
default = "\"automatic\"", default = "\"automatic\"",
value_type = "str", value_type = "str",
example = r#" example = r#"
python-fetch = "manual" python-downloads = "manual"
"#, "#,
possible_values = true possible_values = true
)] )]
pub python_fetch: Option<PythonFetch>, pub python_downloads: Option<PythonDownloads>,
} }
/// Settings relevant to all installer operations. /// Settings relevant to all installer operations.

6
crates/uv/src/commands/project/add.rs
View file

@ -15,7 +15,7 @@ use uv_dispatch::BuildDispatch;
use uv_distribution::DistributionDatabase; use uv_distribution::DistributionDatabase;
use uv_fs::CWD; use uv_fs::CWD;
use uv_normalize::PackageName; use uv_normalize::PackageName;
use uv_python::{PythonFetch, PythonPreference, PythonRequest}; use uv_python::{PythonDownloads, PythonPreference, PythonRequest};
use uv_requirements::{NamedRequirementsResolver, RequirementsSource, RequirementsSpecification}; use uv_requirements::{NamedRequirementsResolver, RequirementsSource, RequirementsSpecification};
use uv_resolver::FlatIndex; use uv_resolver::FlatIndex;
use uv_types::{BuildIsolation, HashStrategy}; use uv_types::{BuildIsolation, HashStrategy};
@ -51,7 +51,7 @@ pub(crate) async fn add(
python: Option<String>, python: Option<String>,
settings: ResolverInstallerSettings, settings: ResolverInstallerSettings,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
preview: PreviewMode, preview: PreviewMode,
connectivity: Connectivity, connectivity: Connectivity,
concurrency: Concurrency, concurrency: Concurrency,
@ -93,7 +93,7 @@ pub(crate) async fn add(
project.workspace(), project.workspace(),
python.as_deref().map(PythonRequest::parse), python.as_deref().map(PythonRequest::parse),
python_preference, python_preference,
python_fetch, python_downloads,
connectivity, connectivity,
native_tls, native_tls,
cache, cache,

16
crates/uv/src/commands/project/init.rs
View file

@ -11,7 +11,7 @@ use uv_client::{BaseClientBuilder, Connectivity};
use uv_configuration::PreviewMode; use uv_configuration::PreviewMode;
use uv_fs::{absolutize_path, Simplified, CWD}; use uv_fs::{absolutize_path, Simplified, CWD};
use uv_python::{ use uv_python::{
EnvironmentPreference, PythonFetch, PythonInstallation, PythonPreference, PythonRequest, EnvironmentPreference, PythonDownloads, PythonInstallation, PythonPreference, PythonRequest,
VersionRequest, VersionRequest,
}; };
use uv_resolver::RequiresPython; use uv_resolver::RequiresPython;
@ -35,7 +35,7 @@ pub(crate) async fn init(
no_workspace: bool, no_workspace: bool,
preview: PreviewMode, preview: PreviewMode,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
connectivity: Connectivity, connectivity: Connectivity,
native_tls: bool, native_tls: bool,
cache: &Cache, cache: &Cache,
@ -86,7 +86,7 @@ pub(crate) async fn init(
python, python,
no_workspace, no_workspace,
python_preference, python_preference,
python_fetch, python_downloads,
connectivity, connectivity,
native_tls, native_tls,
cache, cache,
@ -160,7 +160,7 @@ async fn init_project(
python: Option<String>, python: Option<String>,
no_workspace: bool, no_workspace: bool,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
connectivity: Connectivity, connectivity: Connectivity,
native_tls: bool, native_tls: bool,
cache: &Cache, cache: &Cache,
@ -213,11 +213,11 @@ async fn init_project(
let client_builder = BaseClientBuilder::new() let client_builder = BaseClientBuilder::new()
.connectivity(connectivity) .connectivity(connectivity)
.native_tls(native_tls); .native_tls(native_tls);
let interpreter = PythonInstallation::find_or_fetch( let interpreter = PythonInstallation::find_or_download(
Some(request), Some(request),
EnvironmentPreference::Any, EnvironmentPreference::Any,
python_preference, python_preference,
python_fetch, python_downloads,
&client_builder, &client_builder,
cache, cache,
Some(&reporter), Some(&reporter),
@ -240,11 +240,11 @@ async fn init_project(
let client_builder = BaseClientBuilder::new() let client_builder = BaseClientBuilder::new()
.connectivity(connectivity) .connectivity(connectivity)
.native_tls(native_tls); .native_tls(native_tls);
let interpreter = PythonInstallation::find_or_fetch( let interpreter = PythonInstallation::find_or_download(
Some(request), Some(request),
EnvironmentPreference::Any, EnvironmentPreference::Any,
python_preference, python_preference,
python_fetch, python_downloads,
&client_builder, &client_builder,
cache, cache,
Some(&reporter), Some(&reporter),

6
crates/uv/src/commands/project/lock.rs
View file

@ -18,7 +18,7 @@ use uv_dispatch::BuildDispatch;
use uv_fs::CWD; use uv_fs::CWD;
use uv_git::ResolvedRepositoryReference; use uv_git::ResolvedRepositoryReference;
use uv_normalize::{PackageName, DEV_DEPENDENCIES}; use uv_normalize::{PackageName, DEV_DEPENDENCIES};
use uv_python::{Interpreter, PythonEnvironment, PythonFetch, PythonPreference, PythonRequest}; use uv_python::{Interpreter, PythonDownloads, PythonEnvironment, PythonPreference, PythonRequest};
use uv_requirements::upgrade::{read_lock_requirements, LockedRequirements}; use uv_requirements::upgrade::{read_lock_requirements, LockedRequirements};
use uv_resolver::{ use uv_resolver::{
FlatIndex, Lock, OptionsBuilder, PythonRequirement, RequiresPython, ResolverMarkers, FlatIndex, Lock, OptionsBuilder, PythonRequirement, RequiresPython, ResolverMarkers,
@ -50,7 +50,7 @@ pub(crate) async fn lock(
settings: ResolverSettings, settings: ResolverSettings,
preview: PreviewMode, preview: PreviewMode,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
connectivity: Connectivity, connectivity: Connectivity,
concurrency: Concurrency, concurrency: Concurrency,
native_tls: bool, native_tls: bool,
@ -69,7 +69,7 @@ pub(crate) async fn lock(
&workspace, &workspace,
python.as_deref().map(PythonRequest::parse), python.as_deref().map(PythonRequest::parse),
python_preference, python_preference,
python_fetch, python_downloads,
connectivity, connectivity,
native_tls, native_tls,
cache, cache,

14
crates/uv/src/commands/project/mod.rs
View file

@ -20,8 +20,8 @@ use uv_fs::Simplified;
use uv_installer::{SatisfiesResult, SitePackages}; use uv_installer::{SatisfiesResult, SitePackages};
use uv_normalize::PackageName; use uv_normalize::PackageName;
use uv_python::{ use uv_python::{
request_from_version_file, EnvironmentPreference, Interpreter, PythonEnvironment, PythonFetch, request_from_version_file, EnvironmentPreference, Interpreter, PythonDownloads,
PythonInstallation, PythonPreference, PythonRequest, VersionRequest, PythonEnvironment, PythonInstallation, PythonPreference, PythonRequest, VersionRequest,
}; };
use uv_requirements::{NamedRequirementsResolver, RequirementsSpecification}; use uv_requirements::{NamedRequirementsResolver, RequirementsSpecification};
use uv_resolver::{ use uv_resolver::{
@ -202,7 +202,7 @@ impl FoundInterpreter {
workspace: &Workspace, workspace: &Workspace,
python_request: Option<PythonRequest>, python_request: Option<PythonRequest>,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
connectivity: Connectivity, connectivity: Connectivity,
native_tls: bool, native_tls: bool,
cache: &Cache, cache: &Cache,
@ -251,11 +251,11 @@ impl FoundInterpreter {
let reporter = PythonDownloadReporter::single(printer); let reporter = PythonDownloadReporter::single(printer);
// Locate the Python interpreter to use in the environment // Locate the Python interpreter to use in the environment
let python = PythonInstallation::find_or_fetch( let python = PythonInstallation::find_or_download(
python_request, python_request,
EnvironmentPreference::OnlySystem, EnvironmentPreference::OnlySystem,
python_preference, python_preference,
python_fetch, python_downloads,
&client_builder, &client_builder,
cache, cache,
Some(&reporter), Some(&reporter),
@ -329,7 +329,7 @@ pub(crate) async fn get_or_init_environment(
workspace: &Workspace, workspace: &Workspace,
python: Option<PythonRequest>, python: Option<PythonRequest>,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
connectivity: Connectivity, connectivity: Connectivity,
native_tls: bool, native_tls: bool,
cache: &Cache, cache: &Cache,
@ -339,7 +339,7 @@ pub(crate) async fn get_or_init_environment(
workspace, workspace,
python, python,
python_preference, python_preference,
python_fetch, python_downloads,
connectivity, connectivity,
native_tls, native_tls,
cache, cache,

6
crates/uv/src/commands/project/remove.rs
View file

@ -5,7 +5,7 @@ use uv_cache::Cache;
use uv_client::Connectivity; use uv_client::Connectivity;
use uv_configuration::{Concurrency, ExtrasSpecification, PreviewMode}; use uv_configuration::{Concurrency, ExtrasSpecification, PreviewMode};
use uv_fs::CWD; use uv_fs::CWD;
use uv_python::{PythonFetch, PythonPreference, PythonRequest}; use uv_python::{PythonDownloads, PythonPreference, PythonRequest};
use uv_warnings::{warn_user, warn_user_once}; use uv_warnings::{warn_user, warn_user_once};
use uv_workspace::pyproject::DependencyType; use uv_workspace::pyproject::DependencyType;
use uv_workspace::pyproject_mut::PyProjectTomlMut; use uv_workspace::pyproject_mut::PyProjectTomlMut;
@ -29,7 +29,7 @@ pub(crate) async fn remove(
python: Option<String>, python: Option<String>,
settings: ResolverInstallerSettings, settings: ResolverInstallerSettings,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
preview: PreviewMode, preview: PreviewMode,
connectivity: Connectivity, connectivity: Connectivity,
concurrency: Concurrency, concurrency: Concurrency,
@ -101,7 +101,7 @@ pub(crate) async fn remove(
project.workspace(), project.workspace(),
python.as_deref().map(PythonRequest::parse), python.as_deref().map(PythonRequest::parse),
python_preference, python_preference,
python_fetch, python_downloads,
connectivity, connectivity,
native_tls, native_tls,
cache, cache,

24
crates/uv/src/commands/project/run.rs
View file

@ -18,8 +18,8 @@ use uv_fs::{PythonExt, Simplified, CWD};
use uv_installer::{SatisfiesResult, SitePackages}; use uv_installer::{SatisfiesResult, SitePackages};
use uv_normalize::PackageName; use uv_normalize::PackageName;
use uv_python::{ use uv_python::{
request_from_version_file, EnvironmentPreference, Interpreter, PythonEnvironment, PythonFetch, request_from_version_file, EnvironmentPreference, Interpreter, PythonDownloads,
PythonInstallation, PythonPreference, PythonRequest, VersionRequest, PythonEnvironment, PythonInstallation, PythonPreference, PythonRequest, VersionRequest,
}; };
use uv_requirements::{RequirementsSource, RequirementsSpecification}; use uv_requirements::{RequirementsSource, RequirementsSpecification};
use uv_warnings::warn_user_once; use uv_warnings::warn_user_once;
@ -53,7 +53,7 @@ pub(crate) async fn run(
settings: ResolverInstallerSettings, settings: ResolverInstallerSettings,
preview: PreviewMode, preview: PreviewMode,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
connectivity: Connectivity, connectivity: Connectivity,
concurrency: Concurrency, concurrency: Concurrency,
native_tls: bool, native_tls: bool,
@ -122,11 +122,11 @@ pub(crate) async fn run(
.connectivity(connectivity) .connectivity(connectivity)
.native_tls(native_tls); .native_tls(native_tls);
let interpreter = PythonInstallation::find_or_fetch( let interpreter = PythonInstallation::find_or_download(
python_request, python_request,
EnvironmentPreference::Any, EnvironmentPreference::Any,
python_preference, python_preference,
python_fetch, python_downloads,
&client_builder, &client_builder,
cache, cache,
Some(&download_reporter), Some(&download_reporter),
@ -240,11 +240,11 @@ pub(crate) async fn run(
.await?; .await?;
// Note we force preview on during `uv run` for now since the entire interface is in preview. // Note we force preview on during `uv run` for now since the entire interface is in preview.
PythonInstallation::find_or_fetch( PythonInstallation::find_or_download(
python_request, python_request,
EnvironmentPreference::Any, EnvironmentPreference::Any,
python_preference, python_preference,
python_fetch, python_downloads,
&client_builder, &client_builder,
cache, cache,
Some(&download_reporter), Some(&download_reporter),
@ -270,7 +270,7 @@ pub(crate) async fn run(
project.workspace(), project.workspace(),
python.as_deref().map(PythonRequest::parse), python.as_deref().map(PythonRequest::parse),
python_preference, python_preference,
python_fetch, python_downloads,
connectivity, connectivity,
native_tls, native_tls,
cache, cache,
@ -342,12 +342,12 @@ pub(crate) async fn run(
.connectivity(connectivity) .connectivity(connectivity)
.native_tls(native_tls); .native_tls(native_tls);
let python = PythonInstallation::find_or_fetch( let python = PythonInstallation::find_or_download(
python.as_deref().map(PythonRequest::parse), python.as_deref().map(PythonRequest::parse),
// No opt-in is required for system environments, since we are not mutating it. // No opt-in is required for system environments, since we are not mutating it.
EnvironmentPreference::Any, EnvironmentPreference::Any,
python_preference, python_preference,
python_fetch, python_downloads,
&client_builder, &client_builder,
cache, cache,
Some(&download_reporter), Some(&download_reporter),
@ -460,11 +460,11 @@ pub(crate) async fn run(
.native_tls(native_tls); .native_tls(native_tls);
// Note we force preview on during `uv run` for now since the entire interface is in preview // Note we force preview on during `uv run` for now since the entire interface is in preview
PythonInstallation::find_or_fetch( PythonInstallation::find_or_download(
python.as_deref().map(PythonRequest::parse), python.as_deref().map(PythonRequest::parse),
EnvironmentPreference::Any, EnvironmentPreference::Any,
python_preference, python_preference,
python_fetch, python_downloads,
&client_builder, &client_builder,
cache, cache,
Some(&download_reporter), Some(&download_reporter),

6
crates/uv/src/commands/project/sync.rs
View file

@ -10,7 +10,7 @@ use uv_dispatch::BuildDispatch;
use uv_fs::CWD; use uv_fs::CWD;
use uv_installer::SitePackages; use uv_installer::SitePackages;
use uv_normalize::{PackageName, DEV_DEPENDENCIES}; use uv_normalize::{PackageName, DEV_DEPENDENCIES};
use uv_python::{PythonEnvironment, PythonFetch, PythonPreference, PythonRequest}; use uv_python::{PythonDownloads, PythonEnvironment, PythonPreference, PythonRequest};
use uv_resolver::{FlatIndex, Lock}; use uv_resolver::{FlatIndex, Lock};
use uv_types::{BuildIsolation, HashStrategy}; use uv_types::{BuildIsolation, HashStrategy};
use uv_warnings::warn_user_once; use uv_warnings::warn_user_once;
@ -35,7 +35,7 @@ pub(crate) async fn sync(
modifications: Modifications, modifications: Modifications,
python: Option<String>, python: Option<String>,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
settings: ResolverInstallerSettings, settings: ResolverInstallerSettings,
preview: PreviewMode, preview: PreviewMode,
connectivity: Connectivity, connectivity: Connectivity,
@ -65,7 +65,7 @@ pub(crate) async fn sync(
project.workspace(), project.workspace(),
python.as_deref().map(PythonRequest::parse), python.as_deref().map(PythonRequest::parse),
python_preference, python_preference,
python_fetch, python_downloads,
connectivity, connectivity,
native_tls, native_tls,
cache, cache,

6
crates/uv/src/commands/project/tree.rs
View file

@ -8,7 +8,7 @@ use uv_cache::Cache;
use uv_client::Connectivity; use uv_client::Connectivity;
use uv_configuration::{Concurrency, PreviewMode, TargetTriple}; use uv_configuration::{Concurrency, PreviewMode, TargetTriple};
use uv_fs::CWD; use uv_fs::CWD;
use uv_python::{PythonFetch, PythonPreference, PythonRequest, PythonVersion}; use uv_python::{PythonDownloads, PythonPreference, PythonRequest, PythonVersion};
use uv_resolver::TreeDisplay; use uv_resolver::TreeDisplay;
use uv_warnings::warn_user_once; use uv_warnings::warn_user_once;
use uv_workspace::{DiscoveryOptions, Workspace}; use uv_workspace::{DiscoveryOptions, Workspace};
@ -35,7 +35,7 @@ pub(crate) async fn tree(
python: Option<String>, python: Option<String>,
settings: ResolverSettings, settings: ResolverSettings,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
preview: PreviewMode, preview: PreviewMode,
connectivity: Connectivity, connectivity: Connectivity,
concurrency: Concurrency, concurrency: Concurrency,
@ -55,7 +55,7 @@ pub(crate) async fn tree(
&workspace, &workspace,
python.as_deref().map(PythonRequest::parse), python.as_deref().map(PythonRequest::parse),
python_preference, python_preference,
python_fetch, python_downloads,
connectivity, connectivity,
native_tls, native_tls,
cache, cache,

12
crates/uv/src/commands/python/install.rs
View file

@ -15,7 +15,8 @@ use uv_fs::CWD;
use uv_python::downloads::{DownloadResult, ManagedPythonDownload, PythonDownloadRequest}; use uv_python::downloads::{DownloadResult, ManagedPythonDownload, PythonDownloadRequest};
use uv_python::managed::{ManagedPythonInstallation, ManagedPythonInstallations}; use uv_python::managed::{ManagedPythonInstallation, ManagedPythonInstallations};
use uv_python::{ use uv_python::{
requests_from_version_file, PythonRequest, PYTHON_VERSIONS_FILENAME, PYTHON_VERSION_FILENAME, requests_from_version_file, PythonDownloads, PythonRequest, PYTHON_VERSIONS_FILENAME,
PYTHON_VERSION_FILENAME,
}; };
use uv_warnings::warn_user_once; use uv_warnings::warn_user_once;
@ -28,6 +29,7 @@ use crate::printer::Printer;
pub(crate) async fn install( pub(crate) async fn install(
targets: Vec<String>, targets: Vec<String>,
reinstall: bool, reinstall: bool,
python_downloads: PythonDownloads,
native_tls: bool, native_tls: bool,
connectivity: Connectivity, connectivity: Connectivity,
preview: PreviewMode, preview: PreviewMode,
@ -124,6 +126,14 @@ pub(crate) async fn install(
return Ok(ExitStatus::Success); return Ok(ExitStatus::Success);
} }
if matches!(python_downloads, PythonDownloads::Never) {
writeln!(
printer.stderr(),
"Python downloads are not allowed (`python-downloads = \"never\"`). Change to `python-downloads = \"manual\"` to allow explicit installs.",
)?;
return Ok(ExitStatus::Failure);
}
let downloads = unfilled_requests let downloads = unfilled_requests
.into_iter() .into_iter()
// Populate the download requests with defaults // Populate the download requests with defaults

6
crates/uv/src/commands/python/list.rs
View file

@ -9,7 +9,7 @@ use uv_configuration::PreviewMode;
use uv_fs::Simplified; use uv_fs::Simplified;
use uv_python::downloads::PythonDownloadRequest; use uv_python::downloads::PythonDownloadRequest;
use uv_python::{ use uv_python::{
find_python_installations, DiscoveryError, EnvironmentPreference, PythonFetch, find_python_installations, DiscoveryError, EnvironmentPreference, PythonDownloads,
PythonInstallation, PythonNotFound, PythonPreference, PythonRequest, PythonSource, PythonInstallation, PythonNotFound, PythonPreference, PythonRequest, PythonSource,
}; };
use uv_warnings::warn_user_once; use uv_warnings::warn_user_once;
@ -32,7 +32,7 @@ pub(crate) async fn list(
all_versions: bool, all_versions: bool,
all_platforms: bool, all_platforms: bool,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
preview: PreviewMode, preview: PreviewMode,
cache: &Cache, cache: &Cache,
printer: Printer, printer: Printer,
@ -46,7 +46,7 @@ pub(crate) async fn list(
let download_request = match kinds { let download_request = match kinds {
PythonListKinds::Installed => None, PythonListKinds::Installed => None,
PythonListKinds::Default => { PythonListKinds::Default => {
if python_fetch.is_automatic() { if python_downloads.is_automatic() {
Some(if all_platforms { Some(if all_platforms {
PythonDownloadRequest::default() PythonDownloadRequest::default()
} else { } else {

8
crates/uv/src/commands/tool/install.rs
View file

@ -11,7 +11,7 @@ use uv_client::{BaseClientBuilder, Connectivity};
use uv_configuration::{Concurrency, PreviewMode}; use uv_configuration::{Concurrency, PreviewMode};
use uv_normalize::PackageName; use uv_normalize::PackageName;
use uv_python::{ use uv_python::{
EnvironmentPreference, PythonFetch, PythonInstallation, PythonPreference, PythonRequest, EnvironmentPreference, PythonDownloads, PythonInstallation, PythonPreference, PythonRequest,
}; };
use uv_requirements::{RequirementsSource, RequirementsSpecification}; use uv_requirements::{RequirementsSource, RequirementsSpecification};
use uv_tool::InstalledTools; use uv_tool::InstalledTools;
@ -40,7 +40,7 @@ pub(crate) async fn install(
settings: ResolverInstallerSettings, settings: ResolverInstallerSettings,
preview: PreviewMode, preview: PreviewMode,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
connectivity: Connectivity, connectivity: Connectivity,
concurrency: Concurrency, concurrency: Concurrency,
native_tls: bool, native_tls: bool,
@ -61,11 +61,11 @@ pub(crate) async fn install(
// Pre-emptively identify a Python interpreter. We need an interpreter to resolve any unnamed // Pre-emptively identify a Python interpreter. We need an interpreter to resolve any unnamed
// requirements, even if we end up using a different interpreter for the tool install itself. // requirements, even if we end up using a different interpreter for the tool install itself.
let interpreter = PythonInstallation::find_or_fetch( let interpreter = PythonInstallation::find_or_download(
python_request.clone(), python_request.clone(),
EnvironmentPreference::OnlySystem, EnvironmentPreference::OnlySystem,
python_preference, python_preference,
python_fetch, python_downloads,
&client_builder, &client_builder,
cache, cache,
Some(&reporter), Some(&reporter),

14
crates/uv/src/commands/tool/run.rs
View file

@ -20,8 +20,8 @@ use uv_configuration::{Concurrency, PreviewMode};
use uv_installer::{SatisfiesResult, SitePackages}; use uv_installer::{SatisfiesResult, SitePackages};
use uv_normalize::PackageName; use uv_normalize::PackageName;
use uv_python::{ use uv_python::{
EnvironmentPreference, PythonEnvironment, PythonFetch, PythonInstallation, PythonPreference, EnvironmentPreference, PythonDownloads, PythonEnvironment, PythonInstallation,
PythonRequest, PythonPreference, PythonRequest,
}; };
use uv_requirements::{RequirementsSource, RequirementsSpecification}; use uv_requirements::{RequirementsSource, RequirementsSpecification};
use uv_tool::{entrypoint_paths, InstalledTools}; use uv_tool::{entrypoint_paths, InstalledTools};
@ -70,7 +70,7 @@ pub(crate) async fn run(
isolated: bool, isolated: bool,
preview: PreviewMode, preview: PreviewMode,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
connectivity: Connectivity, connectivity: Connectivity,
concurrency: Concurrency, concurrency: Concurrency,
native_tls: bool, native_tls: bool,
@ -107,7 +107,7 @@ pub(crate) async fn run(
isolated, isolated,
preview, preview,
python_preference, python_preference,
python_fetch, python_downloads,
connectivity, connectivity,
concurrency, concurrency,
native_tls, native_tls,
@ -293,7 +293,7 @@ async fn get_or_create_environment(
isolated: bool, isolated: bool,
preview: PreviewMode, preview: PreviewMode,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
connectivity: Connectivity, connectivity: Connectivity,
concurrency: Concurrency, concurrency: Concurrency,
native_tls: bool, native_tls: bool,
@ -309,11 +309,11 @@ async fn get_or_create_environment(
let python_request = python.map(PythonRequest::parse); let python_request = python.map(PythonRequest::parse);
// Discover an interpreter. // Discover an interpreter.
let interpreter = PythonInstallation::find_or_fetch( let interpreter = PythonInstallation::find_or_download(
python_request.clone(), python_request.clone(),
EnvironmentPreference::OnlySystem, EnvironmentPreference::OnlySystem,
python_preference, python_preference,
python_fetch, python_downloads,
&client_builder, &client_builder,
cache, cache,
Some(&reporter), Some(&reporter),

12
crates/uv/src/commands/venv.rs
View file

@ -22,7 +22,7 @@ use uv_configuration::{
use uv_dispatch::BuildDispatch; use uv_dispatch::BuildDispatch;
use uv_fs::{Simplified, CWD}; use uv_fs::{Simplified, CWD};
use uv_python::{ use uv_python::{
request_from_version_file, EnvironmentPreference, PythonFetch, PythonInstallation, request_from_version_file, EnvironmentPreference, PythonDownloads, PythonInstallation,
PythonPreference, PythonRequest, VersionRequest, PythonPreference, PythonRequest, VersionRequest,
}; };
use uv_resolver::{ExcludeNewer, FlatIndex, RequiresPython}; use uv_resolver::{ExcludeNewer, FlatIndex, RequiresPython};
@ -42,7 +42,7 @@ pub(crate) async fn venv(
path: &Path, path: &Path,
python_request: Option<&str>, python_request: Option<&str>,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
link_mode: LinkMode, link_mode: LinkMode,
index_locations: &IndexLocations, index_locations: &IndexLocations,
index_strategy: IndexStrategy, index_strategy: IndexStrategy,
@ -72,7 +72,7 @@ pub(crate) async fn venv(
seed, seed,
preview, preview,
python_preference, python_preference,
python_fetch, python_downloads,
allow_existing, allow_existing,
exclude_newer, exclude_newer,
native_tls, native_tls,
@ -124,7 +124,7 @@ async fn venv_impl(
seed: bool, seed: bool,
preview: PreviewMode, preview: PreviewMode,
python_preference: PythonPreference, python_preference: PythonPreference,
python_fetch: PythonFetch, python_downloads: PythonDownloads,
allow_existing: bool, allow_existing: bool,
exclude_newer: Option<ExcludeNewer>, exclude_newer: Option<ExcludeNewer>,
native_tls: bool, native_tls: bool,
@ -174,11 +174,11 @@ async fn venv_impl(
} }
// Locate the Python interpreter to use in the environment // Locate the Python interpreter to use in the environment
let python = PythonInstallation::find_or_fetch( let python = PythonInstallation::find_or_download(
interpreter_request, interpreter_request,
EnvironmentPreference::OnlySystem, EnvironmentPreference::OnlySystem,
python_preference, python_preference,
python_fetch, python_downloads,
&client_builder, &client_builder,
cache, cache,
Some(&reporter), Some(&reporter),

23
crates/uv/src/lib.rs
View file

@ -662,7 +662,7 @@ async fn run(cli: Cli) -> Result<ExitStatus> {
&args.name, &args.name,
args.settings.python.as_deref(), args.settings.python.as_deref(),
globals.python_preference, globals.python_preference,
globals.python_fetch, globals.python_downloads,
args.settings.link_mode, args.settings.link_mode,
&args.settings.index_locations, &args.settings.index_locations,
args.settings.index_strategy, args.settings.index_strategy,
@ -739,7 +739,7 @@ async fn run(cli: Cli) -> Result<ExitStatus> {
args.isolated, args.isolated,
globals.preview, globals.preview,
globals.python_preference, globals.python_preference,
globals.python_fetch, globals.python_downloads,
globals.connectivity, globals.connectivity,
Concurrency::default(), Concurrency::default(),
globals.native_tls, globals.native_tls,
@ -783,7 +783,7 @@ async fn run(cli: Cli) -> Result<ExitStatus> {
args.settings, args.settings,
globals.preview, globals.preview,
globals.python_preference, globals.python_preference,
globals.python_fetch, globals.python_downloads,
globals.connectivity, globals.connectivity,
Concurrency::default(), Concurrency::default(),
globals.native_tls, globals.native_tls,
@ -866,7 +866,7 @@ async fn run(cli: Cli) -> Result<ExitStatus> {
args.all_versions, args.all_versions,
args.all_platforms, args.all_platforms,
globals.python_preference, globals.python_preference,
globals.python_fetch, globals.python_downloads,
globals.preview, globals.preview,
&cache, &cache,
printer, printer,
@ -886,6 +886,7 @@ async fn run(cli: Cli) -> Result<ExitStatus> {
commands::python_install( commands::python_install(
args.targets, args.targets,
args.reinstall, args.reinstall,
globals.python_downloads,
globals.native_tls, globals.native_tls,
globals.connectivity, globals.connectivity,
globals.preview, globals.preview,
@ -992,7 +993,7 @@ async fn run_project(
args.no_workspace, args.no_workspace,
globals.preview, globals.preview,
globals.python_preference, globals.python_preference,
globals.python_fetch, globals.python_downloads,
globals.connectivity, globals.connectivity,
globals.native_tls, globals.native_tls,
&cache, &cache,
@ -1038,7 +1039,7 @@ async fn run_project(
args.settings, args.settings,
globals.preview, globals.preview,
globals.python_preference, globals.python_preference,
globals.python_fetch, globals.python_downloads,
globals.connectivity, globals.connectivity,
Concurrency::default(), Concurrency::default(),
globals.native_tls, globals.native_tls,
@ -1068,7 +1069,7 @@ async fn run_project(
args.modifications, args.modifications,
args.python, args.python,
globals.python_preference, globals.python_preference,
globals.python_fetch, globals.python_downloads,
args.settings, args.settings,
globals.preview, globals.preview,
globals.connectivity, globals.connectivity,
@ -1094,7 +1095,7 @@ async fn run_project(
args.settings, args.settings,
globals.preview, globals.preview,
globals.python_preference, globals.python_preference,
globals.python_fetch, globals.python_downloads,
globals.connectivity, globals.connectivity,
Concurrency::default(), Concurrency::default(),
globals.native_tls, globals.native_tls,
@ -1131,7 +1132,7 @@ async fn run_project(
args.python, args.python,
args.settings, args.settings,
globals.python_preference, globals.python_preference,
globals.python_fetch, globals.python_downloads,
globals.preview, globals.preview,
globals.connectivity, globals.connectivity,
Concurrency::default(), Concurrency::default(),
@ -1163,7 +1164,7 @@ async fn run_project(
args.python, args.python,
args.settings, args.settings,
globals.python_preference, globals.python_preference,
globals.python_fetch, globals.python_downloads,
globals.preview, globals.preview,
globals.connectivity, globals.connectivity,
Concurrency::default(), Concurrency::default(),
@ -1195,7 +1196,7 @@ async fn run_project(
args.python, args.python,
args.resolver, args.resolver,
globals.python_preference, globals.python_preference,
globals.python_fetch, globals.python_downloads,
globals.preview, globals.preview,
globals.connectivity, globals.connectivity,
Concurrency::default(), Concurrency::default(),

10
crates/uv/src/settings.rs
View file

@ -27,7 +27,7 @@ use uv_configuration::{
SourceStrategy, TargetTriple, Upgrade, SourceStrategy, TargetTriple, Upgrade,
}; };
use uv_normalize::PackageName; use uv_normalize::PackageName;
use uv_python::{Prefix, PythonFetch, PythonPreference, PythonVersion, Target}; use uv_python::{Prefix, PythonDownloads, PythonPreference, PythonVersion, Target};
use uv_requirements::RequirementsSource; use uv_requirements::RequirementsSource;
use uv_resolver::{AnnotationStyle, DependencyMode, ExcludeNewer, PrereleaseMode, ResolutionMode}; use uv_resolver::{AnnotationStyle, DependencyMode, ExcludeNewer, PrereleaseMode, ResolutionMode};
use uv_settings::{ use uv_settings::{
@ -50,7 +50,7 @@ pub(crate) struct GlobalSettings {
pub(crate) show_settings: bool, pub(crate) show_settings: bool,
pub(crate) preview: PreviewMode, pub(crate) preview: PreviewMode,
pub(crate) python_preference: PythonPreference, pub(crate) python_preference: PythonPreference,
pub(crate) python_fetch: PythonFetch, pub(crate) python_downloads: PythonDownloads,
pub(crate) no_progress: bool, pub(crate) no_progress: bool,
} }
@ -117,9 +117,9 @@ impl GlobalSettings {
.python_preference .python_preference
.combine(workspace.and_then(|workspace| workspace.globals.python_preference)) .combine(workspace.and_then(|workspace| workspace.globals.python_preference))
.unwrap_or(default_python_preference), .unwrap_or(default_python_preference),
python_fetch: args python_downloads: flag(args.allow_python_downloads, args.no_python_downloads)
.python_fetch .map(PythonDownloads::from)
.combine(workspace.and_then(|workspace| workspace.globals.python_fetch)) .combine(workspace.and_then(|workspace| workspace.globals.python_downloads))
.unwrap_or_default(), .unwrap_or_default(),
no_progress: args.no_progress, no_progress: args.no_progress,
} }

55
crates/uv/tests/help.rs
View file

@ -40,9 +40,8 @@ fn help() {
--python-preference <PYTHON_PREFERENCE> --python-preference <PYTHON_PREFERENCE>
Whether to prefer uv-managed or system Python installations [possible values: Whether to prefer uv-managed or system Python installations [possible values:
only-managed, managed, system, only-system] only-managed, managed, system, only-system]
--python-fetch <PYTHON_FETCH> --no-python-downloads
Whether to automatically download Python when required [possible values: automatic, Disable automatic downloads of Python
manual]
Global options: Global options:
-q, --quiet Do not print any output -q, --quiet Do not print any output
@ -103,9 +102,8 @@ fn help_flag() {
--python-preference <PYTHON_PREFERENCE> --python-preference <PYTHON_PREFERENCE>
Whether to prefer uv-managed or system Python installations [possible values: Whether to prefer uv-managed or system Python installations [possible values:
only-managed, managed, system, only-system] only-managed, managed, system, only-system]
--python-fetch <PYTHON_FETCH> --no-python-downloads
Whether to automatically download Python when required [possible values: automatic, Disable automatic downloads of Python
manual]
Global options: Global options:
-q, --quiet Do not print any output -q, --quiet Do not print any output
@ -165,9 +163,8 @@ fn help_short_flag() {
--python-preference <PYTHON_PREFERENCE> --python-preference <PYTHON_PREFERENCE>
Whether to prefer uv-managed or system Python installations [possible values: Whether to prefer uv-managed or system Python installations [possible values:
only-managed, managed, system, only-system] only-managed, managed, system, only-system]
--python-fetch <PYTHON_FETCH> --no-python-downloads
Whether to automatically download Python when required [possible values: automatic, Disable automatic downloads of Python
manual]
Global options: Global options:
-q, --quiet Do not print any output -q, --quiet Do not print any output
@ -212,7 +209,7 @@ fn help_subcommand() {
When preview is enabled, i.e., via `--preview` or by using a preview When preview is enabled, i.e., via `--preview` or by using a preview
command, uv will download Python if a version cannot be found. This command, uv will download Python if a version cannot be found. This
behavior can be disabled with the `--python-fetch` option. behavior can be disabled with the `--python-downloads` option.
The `--python` option allows requesting a different interpreter. The `--python` option allows requesting a different interpreter.
@ -281,13 +278,8 @@ fn help_subcommand() {
- only-system: Only use system Python installations; never use managed Python - only-system: Only use system Python installations; never use managed Python
installations installations
--python-fetch <PYTHON_FETCH> --no-python-downloads
Whether to automatically download Python when required Disable automatic downloads of Python
Possible values:
- automatic: Automatically fetch managed Python installations when needed
- manual: Do not automatically fetch managed Python installations; require explicit
installation
Global options: Global options:
-q, --quiet -q, --quiet
@ -419,13 +411,8 @@ fn help_subsubcommand() {
- only-system: Only use system Python installations; never use managed Python - only-system: Only use system Python installations; never use managed Python
installations installations
--python-fetch <PYTHON_FETCH> --no-python-downloads
Whether to automatically download Python when required Disable automatic downloads of Python
Possible values:
- automatic: Automatically fetch managed Python installations when needed
- manual: Do not automatically fetch managed Python installations; require explicit
installation
Global options: Global options:
-q, --quiet -q, --quiet
@ -527,9 +514,8 @@ fn help_flag_subcommand() {
--python-preference <PYTHON_PREFERENCE> --python-preference <PYTHON_PREFERENCE>
Whether to prefer uv-managed or system Python installations [possible values: Whether to prefer uv-managed or system Python installations [possible values:
only-managed, managed, system, only-system] only-managed, managed, system, only-system]
--python-fetch <PYTHON_FETCH> --no-python-downloads
Whether to automatically download Python when required [possible values: automatic, Disable automatic downloads of Python
manual]
Global options: Global options:
-q, --quiet Do not print any output -q, --quiet Do not print any output
@ -580,9 +566,8 @@ fn help_flag_subsubcommand() {
--python-preference <PYTHON_PREFERENCE> --python-preference <PYTHON_PREFERENCE>
Whether to prefer uv-managed or system Python installations [possible values: Whether to prefer uv-managed or system Python installations [possible values:
only-managed, managed, system, only-system] only-managed, managed, system, only-system]
--python-fetch <PYTHON_FETCH> --no-python-downloads
Whether to automatically download Python when required [possible values: automatic, Disable automatic downloads of Python
manual]
Global options: Global options:
-q, --quiet Do not print any output -q, --quiet Do not print any output
@ -710,9 +695,8 @@ fn help_with_global_option() {
--python-preference <PYTHON_PREFERENCE> --python-preference <PYTHON_PREFERENCE>
Whether to prefer uv-managed or system Python installations [possible values: Whether to prefer uv-managed or system Python installations [possible values:
only-managed, managed, system, only-system] only-managed, managed, system, only-system]
--python-fetch <PYTHON_FETCH> --no-python-downloads
Whether to automatically download Python when required [possible values: automatic, Disable automatic downloads of Python
manual]
Global options: Global options:
-q, --quiet Do not print any output -q, --quiet Do not print any output
@ -809,9 +793,8 @@ fn help_with_no_pager() {
--python-preference <PYTHON_PREFERENCE> --python-preference <PYTHON_PREFERENCE>
Whether to prefer uv-managed or system Python installations [possible values: Whether to prefer uv-managed or system Python installations [possible values:
only-managed, managed, system, only-system] only-managed, managed, system, only-system]
--python-fetch <PYTHON_FETCH> --no-python-downloads
Whether to automatically download Python when required [possible values: automatic, Disable automatic downloads of Python
manual]
Global options: Global options:
-q, --quiet Do not print any output -q, --quiet Do not print any output

2
crates/uv/tests/lock.rs
View file

@ -3061,7 +3061,7 @@ fn lock_requires_python() -> Result<()> {
// Install from the lockfile. // Install from the lockfile.
// Note we need to disable Python fetches or we'll just download 3.12 // Note we need to disable Python fetches or we'll just download 3.12
uv_snapshot!(filters, context38.sync().arg("--frozen").arg("--python-fetch").arg("manual"), @r###" uv_snapshot!(filters, context38.sync().arg("--frozen").arg("--no-python-downloads"), @r###"
success: false success: false
exit_code: 2 exit_code: 2
----- stdout ----- ----- stdout -----

44
crates/uv/tests/show_settings.rs
View file

@ -56,7 +56,7 @@ fn resolve_uv_toml() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -192,7 +192,7 @@ fn resolve_uv_toml() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -329,7 +329,7 @@ fn resolve_uv_toml() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -498,7 +498,7 @@ fn resolve_pyproject_toml() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -636,7 +636,7 @@ fn resolve_pyproject_toml() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -760,7 +760,7 @@ fn resolve_pyproject_toml() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -921,7 +921,7 @@ fn resolve_index_url() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -1082,7 +1082,7 @@ fn resolve_index_url() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -1288,7 +1288,7 @@ fn resolve_find_links() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -1448,7 +1448,7 @@ fn resolve_top_level() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -1578,7 +1578,7 @@ fn resolve_top_level() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -1736,7 +1736,7 @@ fn resolve_top_level() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -1918,7 +1918,7 @@ fn resolve_user_configuration() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -2038,7 +2038,7 @@ fn resolve_user_configuration() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -2158,7 +2158,7 @@ fn resolve_user_configuration() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -2280,7 +2280,7 @@ fn resolve_user_configuration() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -2421,7 +2421,7 @@ fn resolve_tool() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -2534,7 +2534,7 @@ fn resolve_poetry_toml() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -2682,7 +2682,7 @@ fn resolve_both() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -2845,7 +2845,7 @@ fn resolve_config_file() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -3083,7 +3083,7 @@ fn resolve_skip_empty() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {
@ -3206,7 +3206,7 @@ fn resolve_skip_empty() -> anyhow::Result<()> {
show_settings: true, show_settings: true,
preview: Disabled, preview: Disabled,
python_preference: OnlySystem, python_preference: OnlySystem,
python_fetch: Automatic, python_downloads: Automatic,
no_progress: false, no_progress: false,
} }
CacheSettings { CacheSettings {

4
docs/concepts/python-versions.md
View file

@ -47,7 +47,7 @@ Additionally, a specific system Python interpreter can be requested with:
By default, uv will automatically download Python versions if they cannot be found on the system. By default, uv will automatically download Python versions if they cannot be found on the system.
This behavior can be This behavior can be
[disabled with the `python-fetch` option](#disabling-automatic-python-downloads). [disabled with the `python-downloads` option](#disabling-automatic-python-downloads).
## Installing a Python version ## Installing a Python version
@ -155,7 +155,7 @@ version download.
By default, uv will automatically download Python versions when needed. By default, uv will automatically download Python versions when needed.
The `python-fetch` option can be used to disable this behavior. By default, it is set to The `python-downloads` option can be used to disable this behavior. By default, it is set to
`automatic`; set to `manual` to only allow Python downloads during `uv python install`. `automatic`; set to `manual` to only allow Python downloads during `uv python install`.
## Adjusting Python version preferences ## Adjusting Python version preferences

389
docs/reference/cli.md
View file

@ -235,6 +235,8 @@ uv run [OPTIONS] <COMMAND>
<p>If a virtual environment is active or found in a current or parent directory, it will be used as if there was no project or workspace.</p> <p>If a virtual environment is active or found in a current or parent directory, it will be used as if there was no project or workspace.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p> </dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
@ -268,15 +270,6 @@ uv run [OPTIONS] <COMMAND>
<p>See <a href="#uv-python">uv python</a> to view supported request formats.</p> <p>See <a href="#uv-python">uv python</a> to view supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -409,6 +402,8 @@ uv init [OPTIONS] [PATH]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-readme</code></dt><dd><p>Do not create a <code>README.md</code> file</p> </dd><dt><code>--no-readme</code></dt><dd><p>Do not create a <code>README.md</code> file</p>
</dd><dt><code>--no-workspace</code></dt><dd><p>Avoid discovering a workspace.</p> </dd><dt><code>--no-workspace</code></dt><dd><p>Avoid discovering a workspace.</p>
@ -425,15 +420,6 @@ uv init [OPTIONS] [PATH]
<p>See <a href="#uv-python">uv python</a> to view supported request formats.</p> <p>See <a href="#uv-python">uv python</a> to view supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -642,6 +628,8 @@ uv add [OPTIONS] <REQUIREMENTS>...
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p> </dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p>
</dd><dt><code>--no-sync</code></dt><dd><p>Avoid syncing the virtual environment after re-locking the project</p> </dd><dt><code>--no-sync</code></dt><dd><p>Avoid syncing the virtual environment after re-locking the project</p>
@ -679,15 +667,6 @@ uv add [OPTIONS] <REQUIREMENTS>...
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -915,6 +894,8 @@ uv remove [OPTIONS] <PACKAGES>...
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p> </dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p>
</dd><dt><code>--no-sync</code></dt><dd><p>Avoid syncing the virtual environment after re-locking the project</p> </dd><dt><code>--no-sync</code></dt><dd><p>Avoid syncing the virtual environment after re-locking the project</p>
@ -948,15 +929,6 @@ uv remove [OPTIONS] <PACKAGES>...
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -1168,6 +1140,8 @@ uv sync [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p> </dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
@ -1201,15 +1175,6 @@ uv sync [OPTIONS]
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -1409,6 +1374,8 @@ uv lock [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p> </dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
@ -1440,15 +1407,6 @@ uv lock [OPTIONS]
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -1649,6 +1607,8 @@ uv tree [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p> </dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
@ -1682,15 +1642,6 @@ uv tree [OPTIONS]
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-platform</code> <i>python-platform</i></dt><dd><p>The platform to use when filtering the tree.</p> </dd><dt><code>--python-platform</code> <i>python-platform</i></dt><dd><p>The platform to use when filtering the tree.</p>
<p>For example, pass <code>--platform windows</code> to display the dependencies that would be included when installing on Windows.</p> <p>For example, pass <code>--platform windows</code> to display the dependencies that would be included when installing on Windows.</p>
@ -1963,6 +1914,8 @@ uv tool run [OPTIONS] [COMMAND]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p> </dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
@ -1990,15 +1943,6 @@ uv tool run [OPTIONS] [COMMAND]
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -2206,6 +2150,8 @@ uv tool install [OPTIONS] <PACKAGE>
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p> </dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
@ -2233,15 +2179,6 @@ uv tool install [OPTIONS] <PACKAGE>
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -2447,6 +2384,8 @@ uv tool upgrade [OPTIONS] <NAME>
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p> </dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
@ -2470,15 +2409,6 @@ uv tool upgrade [OPTIONS] <NAME>
<li><code>if-necessary-or-explicit</code>: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirements</li> <li><code>if-necessary-or-explicit</code>: Allow pre-release versions if all versions of a package are pre-release, or if the package has an explicit pre-release marker in its version requirements</li>
</ul> </ul>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -2579,19 +2509,12 @@ uv tool list [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -2677,19 +2600,12 @@ uv tool uninstall [OPTIONS] <NAME>
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -2765,19 +2681,12 @@ uv tool update-shell [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -2857,19 +2766,12 @@ uv tool dir [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -2910,7 +2812,7 @@ executables.
When preview is enabled, i.e., via `--preview` or by using a preview When preview is enabled, i.e., via `--preview` or by using a preview
command, uv will download Python if a version cannot be found. This command, uv will download Python if a version cannot be found. This
behavior can be disabled with the `--python-fetch` option. behavior can be disabled with the `--python-downloads` option.
The `--python` option allows requesting a different interpreter. The `--python` option allows requesting a different interpreter.
@ -3014,21 +2916,14 @@ uv python list [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--only-installed</code></dt><dd><p>Only show installed Python versions, exclude available downloads</p> </dd><dt><code>--only-installed</code></dt><dd><p>Only show installed Python versions, exclude available downloads</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -3114,19 +3009,12 @@ uv python install [OPTIONS] [TARGETS]...
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -3212,19 +3100,12 @@ uv python find [OPTIONS] [REQUEST]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -3310,21 +3191,14 @@ uv python pin [OPTIONS] [REQUEST]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-workspace</code></dt><dd><p>Avoid validating the Python pin against the workspace in the current directory or any parent directory</p> </dd><dt><code>--no-workspace</code></dt><dd><p>Avoid validating the Python pin against the workspace in the current directory or any parent directory</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -3404,19 +3278,12 @@ uv python dir [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -3502,19 +3369,12 @@ uv python uninstall [OPTIONS] <TARGETS>...
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -3770,6 +3630,8 @@ uv pip compile [OPTIONS] <SRC_FILE>...
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p> </dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p>
</dd><dt><code>--no-strip-extras</code></dt><dd><p>Include extras in the output file.</p> </dd><dt><code>--no-strip-extras</code></dt><dd><p>Include extras in the output file.</p>
@ -3825,15 +3687,6 @@ uv pip compile [OPTIONS] <SRC_FILE>...
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-platform</code> <i>python-platform</i></dt><dd><p>The platform for which requirements should be resolved.</p> </dd><dt><code>--python-platform</code> <i>python-platform</i></dt><dd><p>The platform for which requirements should be resolved.</p>
<p>Represented as a &quot;target triple&quot;, a string that describes the target platform in terms of its CPU, vendor, and operating system name, like <code>x86_64-unknown-linux-gnu</code> or <code>aaarch64-apple-darwin</code>.</p> <p>Represented as a &quot;target triple&quot;, a string that describes the target platform in terms of its CPU, vendor, and operating system name, like <code>x86_64-unknown-linux-gnu</code> or <code>aaarch64-apple-darwin</code>.</p>
@ -4104,6 +3957,8 @@ uv pip sync [OPTIONS] <SRC_FILE>...
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p> </dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
@ -4126,15 +3981,6 @@ uv pip sync [OPTIONS] <SRC_FILE>...
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-platform</code> <i>python-platform</i></dt><dd><p>The platform for which requirements should be installed.</p> </dd><dt><code>--python-platform</code> <i>python-platform</i></dt><dd><p>The platform for which requirements should be installed.</p>
<p>Represented as a &quot;target triple&quot;, a string that describes the target platform in terms of its CPU, vendor, and operating system name, like <code>x86_64-unknown-linux-gnu</code> or <code>aaarch64-apple-darwin</code>.</p> <p>Represented as a &quot;target triple&quot;, a string that describes the target platform in terms of its CPU, vendor, and operating system name, like <code>x86_64-unknown-linux-gnu</code> or <code>aaarch64-apple-darwin</code>.</p>
@ -4416,6 +4262,8 @@ uv pip install [OPTIONS] <PACKAGE|--requirement <REQUIREMENT>|--editable <EDITAB
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p> </dd><dt><code>--no-sources</code></dt><dd><p>Ignore the <code>tool.uv.sources</code> table when resolving dependencies. Used to lock against the standards-compliant, publishable package metadata, as opposed to using any local or Git sources</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
@ -4461,15 +4309,6 @@ uv pip install [OPTIONS] <PACKAGE|--requirement <REQUIREMENT>|--editable <EDITAB
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-platform</code> <i>python-platform</i></dt><dd><p>The platform for which requirements should be installed.</p> </dd><dt><code>--python-platform</code> <i>python-platform</i></dt><dd><p>The platform for which requirements should be installed.</p>
<p>Represented as a &quot;target triple&quot;, a string that describes the target platform in terms of its CPU, vendor, and operating system name, like <code>x86_64-unknown-linux-gnu</code> or <code>aaarch64-apple-darwin</code>.</p> <p>Represented as a &quot;target triple&quot;, a string that describes the target platform in terms of its CPU, vendor, and operating system name, like <code>x86_64-unknown-linux-gnu</code> or <code>aaarch64-apple-darwin</code>.</p>
@ -4668,6 +4507,8 @@ uv pip uninstall [OPTIONS] <PACKAGE|--requirement <REQUIREMENT>>
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
@ -4680,15 +4521,6 @@ uv pip uninstall [OPTIONS] <PACKAGE|--requirement <REQUIREMENT>>
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -4776,6 +4608,8 @@ uv pip freeze [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
@ -4786,15 +4620,6 @@ uv pip freeze [OPTIONS]
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -4896,6 +4721,8 @@ uv pip list [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
@ -4906,15 +4733,6 @@ uv pip list [OPTIONS]
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -5004,6 +4822,8 @@ uv pip show [OPTIONS] [PACKAGE]...
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
@ -5014,15 +4834,6 @@ uv pip show [OPTIONS] [PACKAGE]...
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -5113,6 +4924,8 @@ uv pip tree [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--no-system</code></dt><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--no-system</code></dt><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
@ -5127,15 +4940,6 @@ uv pip tree [OPTIONS]
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -5221,6 +5025,8 @@ uv pip check [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
@ -5231,15 +5037,6 @@ uv pip check [OPTIONS]
<p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p> <p>See <a href="#uv-python">uv python</a> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -5406,6 +5203,8 @@ uv venv [OPTIONS] [NAME]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
@ -5422,15 +5221,6 @@ uv venv [OPTIONS] [NAME]
<p>See <code>uv python help</code> for details on Python discovery and supported request formats.</p> <p>See <code>uv python help</code> for details on Python discovery and supported request formats.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -5548,19 +5338,12 @@ uv cache clean [OPTIONS] [PACKAGE]...
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -5642,19 +5425,12 @@ uv cache prune [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -5730,19 +5506,12 @@ uv cache dir [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -5818,20 +5587,13 @@ uv version [OPTIONS]
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--output-format</code> <i>output-format</i></dt><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p> </dd><dt><code>--output-format</code> <i>output-format</i></dt><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>
@ -5912,19 +5674,12 @@ uv help [OPTIONS] [COMMAND]...
<p>For example, spinners or progress bars.</p> <p>For example, spinners or progress bars.</p>
</dd><dt><code>--no-python-downloads</code></dt><dd><p>Disable automatic downloads of Python</p>
</dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p> </dd><dt><code>--offline</code></dt><dd><p>Disable network access.</p>
<p>When disabled, uv will only use locally cached data and locally available files.</p> <p>When disabled, uv will only use locally cached data and locally available files.</p>
</dd><dt><code>--python-fetch</code> <i>python-fetch</i></dt><dd><p>Whether to automatically download Python when required</p>
<p>Possible values:</p>
<ul>
<li><code>automatic</code>: Automatically fetch managed Python installations when needed</li>
<li><code>manual</code>: Do not automatically fetch managed Python installations; require explicit installation</li>
</ul>
</dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p> </dd><dt><code>--python-preference</code> <i>python-preference</i></dt><dd><p>Whether to prefer uv-managed or system Python installations.</p>
<p>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.</p> <p>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.</p>

13
docs/reference/settings.md
View file

@ -693,16 +693,17 @@ Whether to enable experimental, preview features.
--- ---
#### [`python-fetch`](#python-fetch) {: #python-fetch } #### [`python-downloads`](#python-downloads) {: #python-downloads }
Whether to automatically download Python when required. Whether to allow Python downloads.
**Default value**: `"automatic"` **Default value**: `"automatic"`
**Possible values**: **Possible values**:
- `"automatic"`: Automatically fetch managed Python installations when needed - `"automatic"`: Automatically download managed Python installations when needed
- `"manual"`: Do not automatically fetch managed Python installations; require explicit installation - `"manual"`: Do not automatically download managed Python installations; require explicit installation
- `"never"`: Do not ever allow Python downloads
**Example usage**: **Example usage**:
@ -710,13 +711,13 @@ Whether to automatically download Python when required.
```toml ```toml
[tool.uv] [tool.uv]
python-fetch = "manual" python-downloads = "manual"
``` ```
=== "uv.toml" === "uv.toml"
```toml ```toml
python-fetch = "manual" python-downloads = "manual"
``` ```
--- ---

19
uv.schema.json generated
View file

@ -254,11 +254,11 @@
"null" "null"
] ]
}, },
"python-fetch": { "python-downloads": {
"description": "Whether to automatically download Python when required.", "description": "Whether to allow Python downloads.",
"anyOf": [ "anyOf": [
{ {
"$ref": "#/definitions/PythonFetch" "$ref": "#/definitions/PythonDownloads"
}, },
{ {
"type": "null" "type": "null"
@ -1015,21 +1015,28 @@
} }
] ]
}, },
"PythonFetch": { "PythonDownloads": {
"oneOf": [ "oneOf": [
{ {
"description": "Automatically fetch managed Python installations when needed.", "description": "Automatically download managed Python installations when needed.",
"type": "string", "type": "string",
"enum": [ "enum": [
"automatic" "automatic"
] ]
}, },
{ {
"description": "Do not automatically fetch managed Python installations; require explicit installation.", "description": "Do not automatically download managed Python installations; require explicit installation.",
"type": "string", "type": "string",
"enum": [ "enum": [
"manual" "manual"
] ]
},
{
"description": "Do not ever allow Python downloads.",
"type": "string",
"enum": [
"never"
]
} }
] ]
}, },