Support build constraints

crates/bench/benches/uv.rs

@@ -151,10 +151,12 @@ mod resolver {
  let python_requirement = PythonRequirement::from_interpreter(interpreter);
 
  let options = OptionsBuilder::new().exclude_newer(exclude_newer).build();
+ let build_constraints = [];
 
  let build_context = BuildDispatch::new(
  client,
  &cache,
+ &build_constraints,
  interpreter,
  &index_locations,
  &flat_index,

crates/uv-cli/src/lib.rs

@@ -520,6 +520,14 @@ pub struct PipCompileArgs {
  #[arg(long, env = "UV_OVERRIDE", value_delimiter = ' ', value_parser = parse_maybe_file_path)]
  pub r#override: Vec<Maybe<PathBuf>>,
 
+ /// Constrain build requirement versions using the given requirements files.
+ ///
+ /// Constraints files are `requirements.txt`-like files that only control the _version_ of a
+ /// requirement that's installed. However, including a package in a constraints file will _not_
+ /// trigger the installation of that package.
+ #[arg(long, short, env = "UV_BUILD_CONSTRAINT", value_delimiter = ' ', value_parser = parse_maybe_file_path)]
+ pub build_constraint: Vec<Maybe<PathBuf>>,
+
  /// Include optional dependencies from the extra group name; may be provided more than once.
  ///
  /// Only applies to `pyproject.toml`, `setup.py`, and `setup.cfg` sources.
@@ -817,6 +825,14 @@ pub struct PipSyncArgs {
  #[arg(long, short, env = "UV_CONSTRAINT", value_delimiter = ' ', value_parser = parse_maybe_file_path)]
  pub constraint: Vec<Maybe<PathBuf>>,
 
+ /// Constrain build requirement versions using the given requirements files.
+ ///
+ /// Constraints files are `requirements.txt`-like files that only control the _version_ of a
+ /// requirement that's installed. However, including a package in a constraints file will _not_
+ /// trigger the installation of that package.
+ #[arg(long, short, env = "UV_BUILD_CONSTRAINT", value_delimiter = ' ', value_parser = parse_maybe_file_path)]
+ pub build_constraint: Vec<Maybe<PathBuf>>,
+
  #[command(flatten)]
  pub installer: InstallerArgs,
 
@@ -1084,6 +1100,14 @@ pub struct PipInstallArgs {
  #[arg(long, env = "UV_OVERRIDE", value_delimiter = ' ', value_parser = parse_maybe_file_path)]
  pub r#override: Vec<Maybe<PathBuf>>,
 
+ /// Constrain build requirement versions using the given requirements files.
+ ///
+ /// Constraints files are `requirements.txt`-like files that only control the _version_ of a
+ /// requirement that's installed. However, including a package in a constraints file will _not_
+ /// trigger the installation of that package.
+ #[arg(long, short, env = "UV_BUILD_CONSTRAINT", value_delimiter = ' ', value_parser = parse_maybe_file_path)]
+ pub build_constraint: Vec<Maybe<PathBuf>>,
+
  /// Include optional dependencies from the extra group name; may be provided more than once.
  ///
  /// Only applies to `pyproject.toml`, `setup.py`, and `setup.cfg` sources.

crates/uv-dev/src/build.rs

@@ -75,9 +75,13 @@ pub(crate) async fn build(args: BuildArgs) -> Result<PathBuf> {
  )?;
  let build_options = BuildOptions::default();
 
+ // TODO: support build constraints
+ let build_constraints = [];
+
  let build_dispatch = BuildDispatch::new(
  &client,
  &cache,
+ &build_constraints,
  python.interpreter(),
  &index_urls,
  &flat_index,

crates/uv-dispatch/src/lib.rs

@@ -17,16 +17,17 @@ use uv_build::{SourceBuild, SourceBuildContext};
 use uv_cache::Cache;
 use uv_client::RegistryClient;
 use uv_configuration::{
- BuildKind, BuildOptions, ConfigSettings, IndexStrategy, Reinstall, SetupPyStrategy,
+ BuildKind, BuildOptions, ConfigSettings, Constraints, IndexStrategy, Overrides, Reinstall,
+ SetupPyStrategy,
 };
 use uv_configuration::{Concurrency, PreviewMode};
 use uv_distribution::DistributionDatabase;
 use uv_git::GitResolver;
 use uv_installer::{Installer, Plan, Planner, Preparer, SitePackages};
 use uv_python::{Interpreter, PythonEnvironment};
 use uv_resolver::{
- ExcludeNewer, FlatIndex, InMemoryIndex, Manifest, OptionsBuilder, PythonRequirement, Resolver,
- ResolverMarkers,
+ ExcludeNewer, Exclusions, FlatIndex, InMemoryIndex, Manifest, OptionsBuilder, Preferences,
+ PythonRequirement, Resolver, ResolverMarkers,
 };
 use uv_types::{BuildContext, BuildIsolation, EmptyInstalledPackages, HashStrategy, InFlight};
 
@@ -35,6 +36,7 @@ use uv_types::{BuildContext, BuildIsolation, EmptyInstalledPackages, HashStrateg
 pub struct BuildDispatch<'a> {
  client: &'a RegistryClient,
  cache: &'a Cache,
+ constraints: Constraints,
  interpreter: &'a Interpreter,
  index_locations: &'a IndexLocations,
  index_strategy: IndexStrategy,
@@ -58,6 +60,7 @@ impl<'a> BuildDispatch<'a> {
  pub fn new(
  client: &'a RegistryClient,
  cache: &'a Cache,
+ constraints: &'a [Requirement],
  interpreter: &'a Interpreter,
  index_locations: &'a IndexLocations,
  flat_index: &'a FlatIndex,
@@ -77,6 +80,7 @@ impl<'a> BuildDispatch<'a> {
  Self {
  client,
  cache,
+ constraints: Constraints::from_requirements(constraints.iter().cloned()),
  interpreter,
  index_locations,
  flat_index,
@@ -140,8 +144,19 @@ impl<'a> BuildContext for BuildDispatch<'a> {
  let python_requirement = PythonRequirement::from_interpreter(self.interpreter);
  let markers = self.interpreter.markers();
  let tags = self.interpreter.tags()?;
+ let manifest = Manifest::new(
+ requirements.to_vec(),
+ self.constraints.clone(),
+ Overrides::default(),
+ Vec::new(),
+ Preferences::default(),
+ None,
+ Exclusions::default(),
+ Vec::new(),
+ );
+
  let resolver = Resolver::new(
- Manifest::simple(requirements.to_vec()),
+ manifest,
  OptionsBuilder::new()
  .exclude_newer(self.exclude_newer)
  .index_strategy(self.index_strategy)

crates/uv/src/commands/pip/compile.rs

@@ -48,6 +48,7 @@ pub(crate) async fn pip_compile(
  requirements: &[RequirementsSource],
  constraints: &[RequirementsSource],
  overrides: &[RequirementsSource],
+ build_constraints: &[RequirementsSource],
  constraints_from_workspace: Vec<Requirement>,
  overrides_from_workspace: Vec<Requirement>,
  extras: ExtrasSpecification,
@@ -143,6 +144,20 @@ pub(crate) async fn pip_compile(
  )
  .collect();
 
+ // Read build constraints and overrides
+ let RequirementsSpecification {
+ constraints: build_constraints,
+ overrides: _build_overrides,
+ ..
+ } = operations::read_requirements(
+ &[],
+ build_constraints,
+ &[],
+ &ExtrasSpecification::None,
+ &client_builder,
+ )
+ .await?;
+
  // If all the metadata could be statically resolved, validate that every extra was used. If we
  // need to resolve metadata via PEP 517, we don't know which extras are used until much later.
  if source_trees.is_empty() {
@@ -304,6 +319,7 @@ pub(crate) async fn pip_compile(
  let build_dispatch = BuildDispatch::new(
  &client,
  &cache,
+ &build_constraints,
  &interpreter,
  &index_locations,
  &flat_index,

crates/uv/src/commands/pip/install.rs

@@ -40,6 +40,7 @@ pub(crate) async fn pip_install(
  requirements: &[RequirementsSource],
  constraints: &[RequirementsSource],
  overrides: &[RequirementsSource],
+ build_constraints: &[RequirementsSource],
  constraints_from_workspace: Vec<Requirement>,
  overrides_from_workspace: Vec<Requirement>,
  extras: &ExtrasSpecification,
@@ -105,6 +106,20 @@ pub(crate) async fn pip_install(
  )
  .await?;
 
+ // Read build constraints and overrides
+ let RequirementsSpecification {
+ constraints: build_constraints,
+ overrides: _build_overrides,
+ ..
+ } = operations::read_requirements(
+ &[],
+ build_constraints,
+ &[],
+ &ExtrasSpecification::None,
+ &client_builder,
+ )
+ .await?;
+
  let constraints: Vec<Requirement> = constraints
  .iter()
  .cloned()
@@ -294,6 +309,7 @@ pub(crate) async fn pip_install(
  let build_dispatch = BuildDispatch::new(
  &client,
  &cache,
+ &build_constraints,
  interpreter,
  &index_locations,
  &flat_index,

crates/uv/src/commands/pip/sync.rs

@@ -38,6 +38,7 @@ use crate::printer::Printer;
 pub(crate) async fn pip_sync(
  requirements: &[RequirementsSource],
  constraints: &[RequirementsSource],
+ build_constraints: &[RequirementsSource],
  reinstall: Reinstall,
  link_mode: LinkMode,
  compile: bool,
@@ -103,6 +104,20 @@ pub(crate) async fn pip_sync(
  )
  .await?;
 
+ // Read build constraints and overrides
+ let RequirementsSpecification {
+ constraints: build_constraints,
+ overrides: _build_overrides,
+ ..
+ } = operations::read_requirements(
+ &[],
+ build_constraints,
+ &[],
+ &ExtrasSpecification::None,
+ &client_builder,
+ )
+ .await?;
+
  // Validate that the requirements are non-empty.
  if !allow_empty_requirements {
  let num_requirements = requirements.len() + source_trees.len();
@@ -240,6 +255,7 @@ pub(crate) async fn pip_sync(
  let build_dispatch = BuildDispatch::new(
  &client,
  &cache,
+ &build_constraints,
  interpreter,
  &index_locations,
  &flat_index,

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

@@ -121,10 +121,14 @@ pub(crate) async fn add(
  FlatIndex::from_entries(entries, Some(&tags), &hasher, &settings.build_options)
  };
 
+ // TODO: read locked build constraints
+ let build_constraints = [];
+
  // Create a build dispatch.
  let build_dispatch = BuildDispatch::new(
  &client,
  cache,
+ &build_constraints,
  venv.interpreter(),
  &settings.index_locations,
  &flat_index,

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

@@ -396,10 +396,13 @@ async fn do_lock(
  // Prefill the index with the lockfile metadata.
  let index = lock.to_index(workspace.install_path(), upgrade)?;
 
+ // TODO: read locked build constraints
+ let build_constraints = [];
  // Create a build dispatch.
  let build_dispatch = BuildDispatch::new(
  &client,
  cache,
+ &build_constraints,
  interpreter,
  index_locations,
  &flat_index,
@@ -472,10 +475,13 @@ async fn do_lock(
  None => {
  debug!("Starting clean resolution");
 
+ // TODO: read locked build constraints
+ let build_constraints = [];
  // Create a build dispatch.
  let build_dispatch = BuildDispatch::new(
  &client,
  cache,
+ &build_constraints,
  interpreter,
  index_locations,
  &flat_index,

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

@@ -371,10 +371,13 @@ pub(crate) async fn resolve_names(
  let setup_py = SetupPyStrategy::default();
  let flat_index = FlatIndex::default();
 
+ // TODO: read locked build constraints
+ let build_constraints = [];
  // Create a build dispatch.
  let build_dispatch = BuildDispatch::new(
  &client,
  cache,
+ &build_constraints,
  interpreter,
  index_locations,
  &flat_index,
@@ -491,10 +494,13 @@ pub(crate) async fn resolve_environment<'a>(
  FlatIndex::from_entries(entries, Some(tags), &hasher, build_options)
  };
 
+ // TODO: read locked build constraints
+ let build_constraints = [];
  // Create a build dispatch.
  let resolve_dispatch = BuildDispatch::new(
  &client,
  cache,
+ &build_constraints,
  interpreter,
  index_locations,
  &flat_index,
@@ -604,10 +610,13 @@ pub(crate) async fn sync_environment(
  FlatIndex::from_entries(entries, Some(tags), &hasher, build_options)
  };
 
+ // TODO: read locked build constraints
+ let build_constraints = [];
  // Create a build dispatch.
  let build_dispatch = BuildDispatch::new(
  &client,
  cache,
+ &build_constraints,
  interpreter,
  index_locations,
  &flat_index,
@@ -765,10 +774,14 @@ pub(crate) async fn update_environment(
  FlatIndex::from_entries(entries, Some(tags), &hasher, build_options)
  };
 
+ // TODO: read locked build constraints
+ let build_constraints = [];
+
  // Create a build dispatch.
  let build_dispatch = BuildDispatch::new(
  &client,
  cache,
+ &build_constraints,
  interpreter,
  index_locations,
  &flat_index,

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

@@ -199,10 +199,13 @@ pub(super) async fn do_sync(
  FlatIndex::from_entries(entries, Some(tags), &hasher, build_options)
  };
 
+ // TODO: read locked build constraints
+ let build_constraints = [];
  // Create a build dispatch.
  let build_dispatch = BuildDispatch::new(
  &client,
  cache,
+ &build_constraints,
  venv.interpreter(),
  index_locations,
  &flat_index,

crates/uv/src/commands/venv.rs

@@ -252,10 +252,13 @@ async fn venv_impl(
  // Do not allow builds
  let build_options = BuildOptions::new(NoBinary::None, NoBuild::All);
 
+ let build_constraints = [];
+
  // Prep the build context.
  let build_dispatch = BuildDispatch::new(
  &client,
  cache,
+ &build_constraints,
  interpreter,
  index_locations,
  &flat_index,