Split on version

Author: charliermarsh

crates/uv-cli/src/lib.rs

@@ -4047,6 +4047,20 @@ pub struct ToolUpgradeArgs {
     #[arg(long, hide = true)]
     pub pre: bool,
 
+    /// The strategy to use when selecting multiple versions of a given package across Python
+    /// versions and platforms.
+    ///
+    /// By default, uv will minimize the number of versions selected for each package (`fewest`),
+    /// to minimize differences between environments. Under `latest`, uv will select the latest
+    /// compatible version for each environment, even if it results in more versions being selected.
+    #[arg(
+        long,
+        value_enum,
+        env = EnvVars::UV_MULTI_VERSION,
+        help_heading = "Resolver options"
+    )]
+    pub multi_version: Option<MultiVersionMode>,
+
     /// Settings to pass to the PEP 517 build backend, specified as `KEY=VALUE` pairs.
     #[arg(
         long,

crates/uv-python/src/python_version.rs

@@ -50,7 +50,9 @@ impl schemars::JsonSchema for PythonVersion {
                 ..schemars::schema::StringValidation::default()
             })),
             metadata: Some(Box::new(schemars::schema::Metadata {
-                description: Some("A Python version specifier, e.g. `3.7` or `3.8.0`.".to_string()),
+                description: Some(
+                    "A Python version specifier, e.g. `3.11` or `3.12.4`.".to_string(),
+                ),
                 ..schemars::schema::Metadata::default()
             })),
             ..schemars::schema::SchemaObject::default()

crates/uv-resolver/src/requires_python.rs

@@ -278,23 +278,6 @@ impl RequiresPython {
         }
     }
 
-    /// Returns the [`RequiresPythonBound`] truncated to the major and minor version.
-    pub fn bound_major_minor(&self) -> LowerBound {
-        match self.range.lower().as_ref() {
-            // Ex) `>=3.10.1` -> `>=3.10`
-            Bound::Included(version) => LowerBound(Bound::Included(Version::new(
-                version.release().iter().take(2),
-            ))),
-            // Ex) `>3.10.1` -> `>=3.10`
-            // This is unintuitive, but `>3.10.1` does indicate that _some_ version of Python 3.10
-            // is supported.
-            Bound::Excluded(version) => LowerBound(Bound::Included(Version::new(
-                version.release().iter().take(2),
-            ))),
-            Bound::Unbounded => LowerBound(Bound::Unbounded),
-        }
-    }
-
     /// Returns the [`Range`] bounding the `Requires-Python` specifier.
     pub fn range(&self) -> &RequiresPythonRange {
         &self.range

crates/uv-settings/src/settings.rs

@@ -493,12 +493,14 @@ pub struct ResolverInstallerOptions {
     ///
     /// By default, uv will minimize the number of versions selected for each package (`fewest`),
     /// to minimize differences between environments. Under `latest`, uv will select the latest
-    /// compatible version for each environment, even if it results in more versions being selected.
+    /// compatible version for each environment and perform an independent solve for each Python
+    /// minor version, ensuring that the latest-compatible version is used in each environment,
+    /// even if it results in more versions being selected across the lockfile.
     #[option(
         default = "\"fewest\"",
         value_type = "str",
         example = r#"
-            resolution = "latest"
+            multi-version = "latest"
         "#,
         possible_values = true
     )]
@@ -1091,12 +1093,14 @@ pub struct PipOptions {
     ///
     /// By default, uv will minimize the number of versions selected for each package (`fewest`),
     /// to minimize differences between environments. Under `latest`, uv will select the latest
-    /// compatible version for each environment, even if it results in more versions being selected.
+    /// compatible version for each environment and perform an independent solve for each Python
+    /// minor version, ensuring that the latest-compatible version is used in each environment,
+    /// even if it results in more versions being selected across the lockfile.
     #[option(
         default = "\"fewest\"",
         value_type = "str",
         example = r#"
-            resolution = "latest"
+            multi-version = "latest"
         "#,
         possible_values = true
     )]

crates/uv/src/commands/project/tree.rs

@@ -169,7 +169,7 @@ pub(crate) async fn tree(
                 keyring_provider,
                 resolution: _,
                 prerelease: _,
-                dependency_metadata: _,
+                multi_version: _, dependency_metadata: _,
                 config_setting: _,
                 no_build_isolation: _,
                 no_build_isolation_package: _,

crates/uv/src/settings.rs

@@ -576,7 +576,7 @@ impl ToolUpgradeSettings {
             resolution,
             prerelease,
             pre,
-            config_setting,
+            multi_version, config_setting,
             no_build_isolation,
             no_build_isolation_package,
             build_isolation,
@@ -609,6 +609,7 @@ impl ToolUpgradeSettings {
             resolution,
             prerelease,
             pre,
+            multi_version,
             config_setting,
             no_build_isolation,
             no_build_isolation_package,