Improve error message copy for failed builds

crates/uv-build-frontend/src/error.rs

@@ -63,21 +63,23 @@ pub enum Error {
  InvalidPyprojectTomlSchema(#[from] toml_edit::de::Error),
  #[error("Editable installs with setup.py legacy builds are unsupported, please specify a build backend in pyproject.toml")]
  EditableSetupPy,
+ #[error("Failed to resolve requirements from {0}")]
+ RequirementsResolve(&'static str, #[source] anyhow::Error),
  #[error("Failed to install requirements from {0}")]
  RequirementsInstall(&'static str, #[source] anyhow::Error),
  #[error("Failed to create temporary virtualenv")]
  Virtualenv(#[from] uv_virtualenv::Error),
  #[error("Failed to run `{0}`")]
  CommandFailed(PathBuf, #[source] io::Error),
- #[error("{message} with {exit_code}\n--- stdout:\n{stdout}\n--- stderr:\n{stderr}\n---")]
+ #[error("{message} ({exit_code})\n--- stdout:\n{stdout}\n--- stderr:\n{stderr}\n---")]
  BuildBackendOutput {
  message: String,
  exit_code: ExitStatus,
  stdout: String,
  stderr: String,
  },
  /// Nudge the user towards installing the missing dev library
- #[error("{message} with {exit_code}\n--- stdout:\n{stdout}\n--- stderr:\n{stderr}\n---")]
+ #[error("{message} ({exit_code})\n--- stdout:\n{stdout}\n--- stderr:\n{stderr}\n---")]
  MissingHeaderOutput {
  message: String,
  exit_code: ExitStatus,
@@ -86,12 +88,12 @@ pub enum Error {
  #[source]
  missing_header_cause: MissingHeaderCause,
  },
- #[error("{message} with {exit_code}")]
+ #[error("{message} ({exit_code})")]
  BuildBackend {
  message: String,
  exit_code: ExitStatus,
  },
- #[error("{message} with {exit_code}")]
+ #[error("{message} ({exit_code})")]
  MissingHeader {
  message: String,
  exit_code: ExitStatus,
@@ -327,7 +329,7 @@ mod test {
  // Unix uses exit status, Windows uses exit code.
  let formatted = err.to_string().replace("exit status: ", "exit code: ");
  insta::assert_snapshot!(formatted, @r###"
- Failed building wheel through setup.py with exit code: 0
+ Failed building wheel through setup.py (exit code: 0)
  --- stdout:
  running bdist_wheel
  running build
@@ -382,7 +384,7 @@ mod test {
  // Unix uses exit status, Windows uses exit code.
  let formatted = err.to_string().replace("exit status: ", "exit code: ");
  insta::assert_snapshot!(formatted, @r###"
- Failed building wheel through setup.py with exit code: 0
+ Failed building wheel through setup.py (exit code: 0)
  --- stdout:
 
  --- stderr:
@@ -430,7 +432,7 @@ mod test {
  // Unix uses exit status, Windows uses exit code.
  let formatted = err.to_string().replace("exit status: ", "exit code: ");
  insta::assert_snapshot!(formatted, @r###"
- Failed building wheel through setup.py with exit code: 0
+ Failed building wheel through setup.py (exit code: 0)
  --- stdout:
 
  --- stderr:
@@ -476,7 +478,7 @@ mod test {
  // Unix uses exit status, Windows uses exit code.
  let formatted = err.to_string().replace("exit status: ", "exit code: ");
  insta::assert_snapshot!(formatted, @r###"
- Failed building wheel through setup.py with exit code: 0
+ Failed building wheel through setup.py (exit code: 0)
  --- stdout:
 
  --- stderr:

crates/uv-build-frontend/src/lib.rs

@@ -310,9 +310,7 @@ impl SourceBuild {
  build_context
  .install(&resolved_requirements, &venv)
  .await
- .map_err(|err| {
- Error::RequirementsInstall("`build-system.requires` (install)", err)
- })?;
+ .map_err(|err| Error::RequirementsInstall("`build-system.requires`", err))?;
  } else {
  debug!("Proceeding without build isolation");
  }
@@ -407,19 +405,15 @@ impl SourceBuild {
  let resolved_requirements = build_context
  .resolve(&default_backend.requirements)
  .await
- .map_err(|err| {
- Error::RequirementsInstall("`setup.py` build (resolve)", err)
- })?;
+ .map_err(|err| Error::RequirementsResolve("`setup.py` build", err))?;
  *resolution = Some(resolved_requirements.clone());
  resolved_requirements
  }
  } else {
  build_context
  .resolve(&pep517_backend.requirements)
  .await
- .map_err(|err| {
- Error::RequirementsInstall("`build-system.requires` (resolve)", err)
- })?
+ .map_err(|err| Error::RequirementsResolve("`build-system.requires`", err))?
  },
  )
  }
@@ -808,7 +802,7 @@ async fn create_pep517_build_environment(
  .await?;
  if !output.status.success() {
  return Err(Error::from_command_output(
- format!("Build backend failed to determine extra requires with `build_{build_kind}()`"),
+ format!("Build backend failed to determine requirements with `build_{build_kind}()`"),
  &output,
  level,
  package_name,
@@ -821,7 +815,7 @@ async fn create_pep517_build_environment(
  let contents = fs_err::read(&outfile).map_err(|err| {
  Error::from_command_output(
  format!(
- "Build backend failed to read extra requires from `get_requires_for_build_{build_kind}`: {err}"
+ "Build backend failed to read requirements from `get_requires_for_build_{build_kind}`: {err}"
  ),
  &output,
  level,
@@ -835,7 +829,7 @@ async fn create_pep517_build_environment(
  let extra_requires: Vec<pep508_rs::Requirement<VerbatimParsedUrl>> = serde_json::from_slice::<Vec<pep508_rs::Requirement<VerbatimParsedUrl>>>(&contents).map_err(|err| {
  Error::from_command_output(
  format!(
- "Build backend failed to return extra requires with `get_requires_for_build_{build_kind}`: {err}"
+ "Build backend failed to return requirements from `get_requires_for_build_{build_kind}`: {err}"
  ),
  &output,
  level,
@@ -864,12 +858,12 @@ async fn create_pep517_build_environment(
  let resolution = build_context
  .resolve(&requirements)
  .await
- .map_err(|err| Error::RequirementsInstall("`build-system.requires` (resolve)", err))?;
+ .map_err(|err| Error::RequirementsResolve("`build-system.requires`", err))?;
 
  build_context
  .install(&resolution, venv)
  .await
- .map_err(|err| Error::RequirementsInstall("`build-system.requires` (install)", err))?;
+ .map_err(|err| Error::RequirementsInstall("`build-system.requires`", err))?;
  }
 
  Ok(())

crates/uv/tests/build.rs

@@ -888,7 +888,7 @@ fn fail() -> Result<()> {
  File "<string>", line 2
  from setuptools import setup
  IndentationError: unexpected indent
- error: Build backend failed to determine extra requires with `build_sdist()` with exit status: 1
+ error: Build backend failed to determine requirements with `build_sdist()` (exit status: 1)
  "###);
 
  Ok(())
@@ -1328,7 +1328,7 @@ fn build_all_with_failure() -> Result<()> {
  [PKG] Building wheel from source distribution...
  [PKG] Building wheel from source distribution...
  Successfully built dist/member_a-0.1.0.tar.gz and dist/member_a-0.1.0-py3-none-any.whl
- [PKG] error: Build backend failed to determine extra requires with `build_sdist()` with exit status: 1
+ [PKG] error: Build backend failed to determine requirements with `build_sdist()` (exit status: 1)
  Successfully built dist/project-0.1.0.tar.gz and dist/project-0.1.0-py3-none-any.whl
  "###);
 
@@ -1397,7 +1397,7 @@ fn build_constraints() -> Result<()> {
 
  ----- stderr -----
  Building source distribution...
- error: Failed to install requirements from `build-system.requires` (resolve)
+ error: Failed to resolve requirements from `build-system.requires`
  Caused by: No solution found when resolving: `setuptools>=42`
  Caused by: Because you require setuptools>=42 and setuptools==0.1.0, we can conclude that your requirements are unsatisfiable.
  "###);
@@ -1551,7 +1551,7 @@ fn sha() -> Result<()> {
 
  ----- stderr -----
  Building source distribution...
- error: Failed to install requirements from `build-system.requires` (install)
+ error: Failed to install requirements from `build-system.requires`
  Caused by: Failed to prepare distributions
  Caused by: Failed to fetch wheel: setuptools==68.2.2
  Caused by: Hash mismatch for `setuptools==68.2.2`
@@ -1585,7 +1585,7 @@ fn sha() -> Result<()> {
 
  ----- stderr -----
  Building source distribution...
- error: Failed to install requirements from `build-system.requires` (resolve)
+ error: Failed to resolve requirements from `build-system.requires`
  Caused by: No solution found when resolving: `setuptools>=42`
  Caused by: In `--require-hashes` mode, all requirements must be pinned upfront with `==`, but found: `setuptools`
  "###);

crates/uv/tests/edit.rs

@@ -4594,7 +4594,7 @@ fn fail_to_add_revert_project() -> Result<()> {
  Resolved 2 packages in [TIME]
  error: Failed to prepare distributions
  Caused by: Failed to fetch wheel: pytorch==1.0.2
- Caused by: Build backend failed to build wheel through `build_wheel()` with exit status: 1
+ Caused by: Build backend failed to build wheel through `build_wheel()` (exit status: 1)
  --- stdout:
 
  --- stderr:

crates/uv/tests/pip_compile.rs

@@ -11782,7 +11782,7 @@ fn incompatible_build_constraint() -> Result<()> {
 
  ----- stderr -----
  × Failed to download and build `requests==1.2.0`
- ├─▶ Failed to install requirements from `setup.py` build (resolve)
+ ├─▶ Failed to resolve requirements from `setup.py` build
  ├─▶ No solution found when resolving: `setuptools>=40.8.0`
  ╰─▶ Because you require setuptools>=40.8.0 and setuptools==1, we can conclude that your requirements are unsatisfiable.
  "###

crates/uv/tests/pip_install.rs

@@ -227,11 +227,9 @@ dependencies = ["flask==1.0.x"]
  let requirements_txt = context.temp_dir.child("requirements.txt");
  requirements_txt.write_str("./path_dep")?;
 
- let filters = [("exit status", "exit code")]
- .into_iter()
+ let filters = std::iter::once((r"exit code: 1", "exit status: 1"))
  .chain(context.filters())
  .collect::<Vec<_>>();
-
  uv_snapshot!(filters, context.pip_install()
  .arg("-r")
  .arg("requirements.txt"), @r###"
@@ -241,7 +239,7 @@ dependencies = ["flask==1.0.x"]
 
  ----- stderr -----
  error: Failed to build: `project @ file://[TEMP_DIR]/path_dep`
- Caused by: Build backend failed to determine extra requires with `build_wheel()` with exit code: 1
+ Caused by: Build backend failed to determine requirements with `build_wheel()` (exit status: 1)
  --- stdout:
  configuration error: `project.dependencies[0]` must be pep508
  DESCRIPTION:
@@ -3820,7 +3818,7 @@ fn no_build_isolation() -> Result<()> {
 
  ----- stderr -----
  error: Failed to download and build: `anyio @ https://files.pythonhosted.org/packages/db/4d/3970183622f0330d3c23d9b8a5f52e365e50381fd484d08e3285104333d3/anyio-4.3.0.tar.gz`
- Caused by: Build backend failed to determine metadata through `prepare_metadata_for_build_wheel` with exit status: 1
+ Caused by: Build backend failed to determine metadata through `prepare_metadata_for_build_wheel` (exit status: 1)
  --- stdout:
 
  --- stderr:
@@ -3890,7 +3888,7 @@ fn respect_no_build_isolation_env_var() -> Result<()> {
 
  ----- stderr -----
  error: Failed to download and build: `anyio @ https://files.pythonhosted.org/packages/db/4d/3970183622f0330d3c23d9b8a5f52e365e50381fd484d08e3285104333d3/anyio-4.3.0.tar.gz`
- Caused by: Build backend failed to determine metadata through `prepare_metadata_for_build_wheel` with exit status: 1
+ Caused by: Build backend failed to determine metadata through `prepare_metadata_for_build_wheel` (exit status: 1)
  --- stdout:
 
  --- stderr:
@@ -6759,7 +6757,7 @@ fn incompatible_build_constraint() -> Result<()> {
 
  ----- stderr -----
  × Failed to download and build `requests==1.2.0`
- ├─▶ Failed to install requirements from `setup.py` build (resolve)
+ ├─▶ Failed to resolve requirements from `setup.py` build
  ├─▶ No solution found when resolving: `setuptools>=40.8.0`
  ╰─▶ Because you require setuptools>=40.8.0 and setuptools==1, we can conclude that your requirements are unsatisfiable.
  "###
@@ -6835,7 +6833,7 @@ fn install_build_isolation_package() -> Result<()> {
 
  ----- stderr -----
  error: Failed to download and build: `iniconfig @ https://files.pythonhosted.org/packages/d7/4b/cbd8e699e64a6f16ca3a8220661b5f83792b3017d0f79807cb8708d33913/iniconfig-2.0.0.tar.gz`
- Caused by: Build backend failed to determine metadata through `prepare_metadata_for_build_wheel` with exit status: 1
+ Caused by: Build backend failed to determine metadata through `prepare_metadata_for_build_wheel` (exit status: 1)
  --- stdout:
 
  --- stderr:
@@ -7096,7 +7094,7 @@ fn sklearn() {
 
  ----- stderr -----
  × Failed to download and build `sklearn==0.0.post12`
- ╰─▶ Build backend failed to determine extra requires with `build_wheel()` with exit status: 1
+ ╰─▶ Build backend failed to determine requirements with `build_wheel()` (exit status: 1)
  --- stdout:
 
  --- stderr:

crates/uv/tests/pip_sync.rs

@@ -5499,7 +5499,7 @@ fn incompatible_build_constraint() -> Result<()> {
  Resolved 1 package in [TIME]
  error: Failed to prepare distributions
  Caused by: Failed to fetch wheel: requests==1.2.0
- Caused by: Failed to install requirements from `setup.py` build (resolve)
+ Caused by: Failed to resolve requirements from `setup.py` build
  Caused by: No solution found when resolving: `setuptools>=40.8.0`
  Caused by: Because you require setuptools>=40.8.0 and setuptools==1, we can conclude that your requirements are unsatisfiable.
  "###

crates/uv/tests/sync.rs

@@ -577,7 +577,7 @@ fn sync_build_isolation_package() -> Result<()> {
  Resolved 2 packages in [TIME]
  error: Failed to prepare distributions
  Caused by: Failed to fetch wheel: source-distribution @ https://files.pythonhosted.org/packages/10/1f/57aa4cce1b1abf6b433106676e15f9fa2c92ed2bd4cf77c3b50a9e9ac773/source_distribution-0.0.1.tar.gz
- Caused by: Build backend failed to build wheel through `build_wheel()` with exit status: 1
+ Caused by: Build backend failed to build wheel through `build_wheel()` (exit status: 1)
  --- stdout:
 
  --- stderr:
@@ -669,7 +669,7 @@ fn sync_build_isolation_extra() -> Result<()> {
  Resolved [N] packages in [TIME]
  error: Failed to prepare distributions
  Caused by: Failed to fetch wheel: source-distribution @ https://files.pythonhosted.org/packages/10/1f/57aa4cce1b1abf6b433106676e15f9fa2c92ed2bd4cf77c3b50a9e9ac773/source_distribution-0.0.1.tar.gz
- Caused by: Build backend failed to build wheel through `build_wheel()` with exit status: 1
+ Caused by: Build backend failed to build wheel through `build_wheel()` (exit status: 1)
  --- stdout:
 
  --- stderr:
@@ -689,7 +689,7 @@ fn sync_build_isolation_extra() -> Result<()> {
  Resolved [N] packages in [TIME]
  error: Failed to prepare distributions
  Caused by: Failed to fetch wheel: source-distribution @ https://files.pythonhosted.org/packages/10/1f/57aa4cce1b1abf6b433106676e15f9fa2c92ed2bd4cf77c3b50a9e9ac773/source_distribution-0.0.1.tar.gz
- Caused by: Build backend failed to build wheel through `build_wheel()` with exit status: 1
+ Caused by: Build backend failed to build wheel through `build_wheel()` (exit status: 1)
  --- stdout:
 
  --- stderr: