Skip to content

Commit

Permalink
Feedback
Browse files Browse the repository at this point in the history
  • Loading branch information
zanieb committed Dec 3, 2024
1 parent 00856bf commit 1446fdc
Showing 1 changed file with 5 additions and 4 deletions.
9 changes: 5 additions & 4 deletions docs/reference/build_failures.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,8 @@
# Troubleshooting build failures

uv needs to build packages when there is not a compatible wheel (a pre-built distribution of the
package) available. Building packages can fail for many reasons.
package) available. Building packages can fail for many reasons, some of which may be unrelated to
uv itself.

## Recognizing a build failure

Expand Down Expand Up @@ -84,9 +85,9 @@ ModuleNotFoundError: No module named 'distutils'

Since this build failure occurs in pip too, it is not likely to be a bug with uv.

If a build failure is reproducible with another installer, you should file an issue upstream (in
this example, with `numpy` or `setuptools`), find a way to avoid building the package in the first
place, or make the necessary adjustments to your system for the build to succeed.
If a build failure is reproducible with another installer, you should investigate upstream (in this
example, `numpy` or `setuptools`), find a way to avoid building the package in the first place, or
make the necessary adjustments to your system for the build to succeed.

## Why does uv build a package?

Expand Down

0 comments on commit 1446fdc

Please sign in to comment.