Allow --config-settings-package to apply configuration settings at the package level (#14573)

## Summary

Closes https://github.com/astral-sh/uv/issues/14564.

Closes https://github.com/astral-sh/uv/issues/10940.

crates/uv-distribution/src/index/built_wheel_index.rs

@@ -1,10 +1,12 @@
+use std::borrow::Cow;
 use uv_cache::{Cache, CacheBucket, CacheShard, WheelCache};
 use uv_cache_info::CacheInfo;
 use uv_cache_key::cache_digest;
-use uv_configuration::ConfigSettings;
+use uv_configuration::{ConfigSettings, PackageConfigSettings};
 use uv_distribution_types::{
     DirectUrlSourceDist, DirectorySourceDist, GitSourceDist, Hashed, PathSourceDist,
 };
+use uv_normalize::PackageName;
 use uv_platform_tags::Tags;
 use uv_types::HashStrategy;
 
@@ -18,7 +20,8 @@ pub struct BuiltWheelIndex<'a> {
     cache: &'a Cache,
     tags: &'a Tags,
     hasher: &'a HashStrategy,
-    build_configuration: &'a ConfigSettings,
+    config_settings: &'a ConfigSettings,
+    config_settings_package: &'a PackageConfigSettings,
 }
 
 impl<'a> BuiltWheelIndex<'a> {
@@ -27,13 +30,15 @@ impl<'a> BuiltWheelIndex<'a> {
         cache: &'a Cache,
         tags: &'a Tags,
         hasher: &'a HashStrategy,
-        build_configuration: &'a ConfigSettings,
+        config_settings: &'a ConfigSettings,
+        config_settings_package: &'a PackageConfigSettings,
     ) -> Self {
         Self {
             cache,
             tags,
             hasher,
-            build_configuration,
+            config_settings,
+            config_settings_package,
         }
     }
 
@@ -63,10 +68,11 @@ impl<'a> BuiltWheelIndex<'a> {
         let cache_shard = cache_shard.shard(revision.id());
 
         // If there are build settings, we need to scope to a cache shard.
-        let cache_shard = if self.build_configuration.is_empty() {
+        let config_settings = self.config_settings_for(&source_dist.name);
+        let cache_shard = if config_settings.is_empty() {
             cache_shard
         } else {
-            cache_shard.shard(cache_digest(self.build_configuration))
+            cache_shard.shard(cache_digest(&config_settings))
         };
 
         Ok(self.find(&cache_shard))
@@ -100,10 +106,11 @@ impl<'a> BuiltWheelIndex<'a> {
         let cache_shard = cache_shard.shard(revision.id());
 
         // If there are build settings, we need to scope to a cache shard.
-        let cache_shard = if self.build_configuration.is_empty() {
+        let config_settings = self.config_settings_for(&source_dist.name);
+        let cache_shard = if config_settings.is_empty() {
             cache_shard
         } else {
-            cache_shard.shard(cache_digest(self.build_configuration))
+            cache_shard.shard(cache_digest(&config_settings))
         };
 
         Ok(self
@@ -148,10 +155,11 @@ impl<'a> BuiltWheelIndex<'a> {
         let cache_shard = cache_shard.shard(revision.id());
 
         // If there are build settings, we need to scope to a cache shard.
-        let cache_shard = if self.build_configuration.is_empty() {
+        let config_settings = self.config_settings_for(&source_dist.name);
+        let cache_shard = if config_settings.is_empty() {
             cache_shard
         } else {
-            cache_shard.shard(cache_digest(self.build_configuration))
+            cache_shard.shard(cache_digest(&config_settings))
         };
 
         Ok(self
@@ -174,10 +182,11 @@ impl<'a> BuiltWheelIndex<'a> {
         );
 
         // If there are build settings, we need to scope to a cache shard.
-        let cache_shard = if self.build_configuration.is_empty() {
+        let config_settings = self.config_settings_for(&source_dist.name);
+        let cache_shard = if config_settings.is_empty() {
             cache_shard
         } else {
-            cache_shard.shard(cache_digest(self.build_configuration))
+            cache_shard.shard(cache_digest(&config_settings))
         };
 
         self.find(&cache_shard)
@@ -239,4 +248,13 @@ impl<'a> BuiltWheelIndex<'a> {
 
         candidate
     }
+
+    /// Determine the [`ConfigSettings`] for the given package name.
+    fn config_settings_for(&self, name: &PackageName) -> Cow<'_, ConfigSettings> {
+        if let Some(package_settings) = self.config_settings_package.get(name) {
+            Cow::Owned(package_settings.clone().merge(self.config_settings.clone()))
+        } else {
+            Cow::Borrowed(self.config_settings)
+        }
+    }
 }

crates/uv-distribution/src/source/mod.rs

@@ -29,7 +29,7 @@ use uv_cache_key::cache_digest;
 use uv_client::{
     CacheControl, CachedClientError, Connectivity, DataWithCachePolicy, RegistryClient,
 };
-use uv_configuration::{BuildKind, BuildOutput, SourceStrategy};
+use uv_configuration::{BuildKind, BuildOutput, ConfigSettings, SourceStrategy};
 use uv_distribution_filename::{SourceDistExtension, WheelFilename};
 use uv_distribution_types::{
     BuildableSource, DirectorySourceUrl, GitSourceUrl, HashPolicy, Hashed, PathSourceUrl,
@@ -373,6 +373,23 @@ impl<'a, T: BuildContext> SourceDistributionBuilder<'a, T> {
         Ok(metadata)
     }
 
+    /// Determine the [`ConfigSettings`] for the given package name.
+    fn config_settings_for(&self, name: Option<&PackageName>) -> Cow<'_, ConfigSettings> {
+        if let Some(name) = name {
+            if let Some(package_settings) = self.build_context.config_settings_package().get(name) {
+                Cow::Owned(
+                    package_settings
+                        .clone()
+                        .merge(self.build_context.config_settings().clone()),
+                )
+            } else {
+                Cow::Borrowed(self.build_context.config_settings())
+            }
+        } else {
+            Cow::Borrowed(self.build_context.config_settings())
+        }
+    }
+
     /// Build a source distribution from a remote URL.
     async fn url<'data>(
         &self,
@@ -407,11 +424,11 @@ impl<'a, T: BuildContext> SourceDistributionBuilder<'a, T> {
         let source_dist_entry = cache_shard.entry(SOURCE);
 
         // If there are build settings, we need to scope to a cache shard.
-        let config_settings = self.build_context.config_settings();
+        let config_settings = self.config_settings_for(source.name());
         let cache_shard = if config_settings.is_empty() {
             cache_shard
         } else {
-            cache_shard.shard(cache_digest(config_settings))
+            cache_shard.shard(cache_digest(&&config_settings))
         };
 
         // If the cache contains a compatible wheel, return it.
@@ -580,11 +597,11 @@ impl<'a, T: BuildContext> SourceDistributionBuilder<'a, T> {
         }
 
         // If there are build settings, we need to scope to a cache shard.
-        let config_settings = self.build_context.config_settings();
+        let config_settings = self.config_settings_for(source.name());
         let cache_shard = if config_settings.is_empty() {
             cache_shard
         } else {
-            cache_shard.shard(cache_digest(config_settings))
+            cache_shard.shard(cache_digest(&config_settings))
         };
 
         // Otherwise, we either need to build the metadata.
@@ -779,11 +796,11 @@ impl<'a, T: BuildContext> SourceDistributionBuilder<'a, T> {
         let source_entry = cache_shard.entry(SOURCE);
 
         // If there are build settings, we need to scope to a cache shard.
-        let config_settings = self.build_context.config_settings();
+        let config_settings = self.config_settings_for(source.name());
         let cache_shard = if config_settings.is_empty() {
             cache_shard
         } else {
-            cache_shard.shard(cache_digest(config_settings))
+            cache_shard.shard(cache_digest(&config_settings))
         };
 
         // If the cache contains a compatible wheel, return it.
@@ -941,11 +958,11 @@ impl<'a, T: BuildContext> SourceDistributionBuilder<'a, T> {
         }
 
         // If there are build settings, we need to scope to a cache shard.
-        let config_settings = self.build_context.config_settings();
+        let config_settings = self.config_settings_for(source.name());
         let cache_shard = if config_settings.is_empty() {
             cache_shard
         } else {
-            cache_shard.shard(cache_digest(config_settings))
+            cache_shard.shard(cache_digest(&config_settings))
         };
 
         // Otherwise, we need to build a wheel.
@@ -1083,11 +1100,11 @@ impl<'a, T: BuildContext> SourceDistributionBuilder<'a, T> {
         let cache_shard = cache_shard.shard(revision.id());
 
         // If there are build settings, we need to scope to a cache shard.
-        let config_settings = self.build_context.config_settings();
+        let config_settings = self.config_settings_for(source.name());
         let cache_shard = if config_settings.is_empty() {
             cache_shard
         } else {
-            cache_shard.shard(cache_digest(config_settings))
+            cache_shard.shard(cache_digest(&config_settings))
         };
 
         // If the cache contains a compatible wheel, return it.
@@ -1271,11 +1288,11 @@ impl<'a, T: BuildContext> SourceDistributionBuilder<'a, T> {
         }
 
         // If there are build settings, we need to scope to a cache shard.
-        let config_settings = self.build_context.config_settings();
+        let config_settings = self.config_settings_for(source.name());
         let cache_shard = if config_settings.is_empty() {
             cache_shard
         } else {
-            cache_shard.shard(cache_digest(config_settings))
+            cache_shard.shard(cache_digest(&config_settings))
         };
 
         // Otherwise, we need to build a wheel.
@@ -1476,11 +1493,11 @@ impl<'a, T: BuildContext> SourceDistributionBuilder<'a, T> {
         let _lock = cache_shard.lock().await.map_err(Error::CacheWrite)?;
 
         // If there are build settings, we need to scope to a cache shard.
-        let config_settings = self.build_context.config_settings();
+        let config_settings = self.config_settings_for(source.name());
         let cache_shard = if config_settings.is_empty() {
             cache_shard
         } else {
-            cache_shard.shard(cache_digest(config_settings))
+            cache_shard.shard(cache_digest(&config_settings))
         };
 
         // If the cache contains a compatible wheel, return it.
@@ -1779,11 +1796,11 @@ impl<'a, T: BuildContext> SourceDistributionBuilder<'a, T> {
         }
 
         // If there are build settings, we need to scope to a cache shard.
-        let config_settings = self.build_context.config_settings();
+        let config_settings = self.config_settings_for(source.name());
         let cache_shard = if config_settings.is_empty() {
             cache_shard
         } else {
-            cache_shard.shard(cache_digest(config_settings))
+            cache_shard.shard(cache_digest(&config_settings))
         };
 
         // Otherwise, we need to build a wheel.