A minimal build backend for uv: uv_build

.github/workflows/ci.yml

@@ -107,6 +107,11 @@ jobs:
       - uses: Swatinem/rust-cache@v2
         with:
           save-if: ${{ github.ref == 'refs/heads/main' }}
+      - name: "Check uv_build dependencies"
+        uses: EmbarkStudios/cargo-deny-action@v1
+        with:
+          command: check bans
+          manifest-path: crates/uv-build/Cargo.toml
       - name: "Install Rust toolchain"
         run: rustup component add clippy
       - name: "Clippy"

.github/workflows/publish-pypi.yml

@@ -12,8 +12,8 @@ on:
         type: string
 
 jobs:
-  pypi-publish:
-    name: Upload to PyPI
+  pypi-publish-uv:
+    name: Upload uv to PyPI
     runs-on: ubuntu-latest
     environment:
       name: release
@@ -25,8 +25,27 @@ jobs:
         uses: astral-sh/setup-uv@v5
       - uses: actions/download-artifact@v4
         with:
-          pattern: wheels-*
-          path: wheels
+          pattern: wheels_uv-*
+          path: wheels_uv
           merge-multiple: true
       - name: Publish to PyPi
-        run: uv publish -v wheels/*
+        run: uv publish -v wheels_uv/*
+
+  pypi-publish-uv-build:
+    name: Upload uv-build to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: release
+    permissions:
+      # For PyPI's trusted publishing.
+      id-token: write
+    steps:
+      - name: "Install uv"
+        uses: astral-sh/setup-uv@v5
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels_uv_build-*
+          path: wheels_uv_build
+          merge-multiple: true
+      - name: Publish to PyPi
+        run: uv publish -v wheels_uv_build/*

.gitignore

@@ -23,6 +23,8 @@ __pycache__
 *.so
 *.pyd
 *.dll
+/dist
+/crates/uv-build/dist
 
 # Profiling
 flamegraph.svg

Cargo.toml

@@ -280,6 +280,12 @@ inherits = "dev"
 debug = 0
 strip = "debuginfo"
 
+# Profile for uv-build
+[profile.minimal-size]
+inherits = "release"
+opt-level = "z"
+panic = "abort"
+
 # The profile that 'cargo dist' will build with.
 [profile.dist]
 inherits = "release"

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

@@ -403,8 +403,8 @@ mod tests {
             license = { file = "license.txt" }
 
             [build-system]
-            requires = ["uv>=0.5.15,<0.6"]
-            build-backend = "uv"
+            requires = ["uv_build>=0.5.15,<0.6"]
+            build-backend = "uv_build"
         "#
             },
         )
@@ -471,8 +471,8 @@ mod tests {
             version = "1.0.0"
 
             [build-system]
-            requires = ["uv>=0.5.15,<0.6"]
-            build-backend = "uv"
+            requires = ["uv_build>=0.5.15,<0.6"]
+            build-backend = "uv_build"
         "#
             },
         )

crates/uv-build-backend/src/metadata.rs

@@ -161,14 +161,14 @@ impl PyProjectToml {
     ///
     /// ```toml
     /// [build-system]
-    /// requires = ["uv>=0.4.15,<5"]
-    /// build-backend = "uv"
+    /// requires = ["uv_build>=0.4.15,<5"]
+    /// build-backend = "uv_build"
     /// ```
     pub fn check_build_system(&self, uv_version: &str) -> Vec<String> {
         let mut warnings = Vec::new();
-        if self.build_system.build_backend.as_deref() != Some("uv") {
+        if self.build_system.build_backend.as_deref() != Some("uv_build") {
             warnings.push(format!(
-                r#"The value for `build_system.build-backend` should be `"uv"`, not `"{}"`"#,
+                r#"The value for `build_system.build-backend` should be `"uv_build"`, not `"{}"`"#,
                 self.build_system.build_backend.clone().unwrap_or_default()
             ));
         }
@@ -189,7 +189,7 @@ impl PyProjectToml {
             warnings.push(expected());
             return warnings;
         };
-        if uv_requirement.name.as_str() != "uv" {
+        if uv_requirement.name.as_str() != "uv-build" {
             warnings.push(expected());
             return warnings;
         }
@@ -221,10 +221,13 @@ impl PyProjectToml {
 
         if !bounded {
             warnings.push(format!(
-                "`build_system.requires = [\"{uv_requirement}\"]` is missing an \
-                upper bound on the uv version such as `<{next_breaking}`. \
-                Without bounding the uv version, the source distribution will break \
-                when a future, breaking version of uv is released.",
+                "`build_system.requires = [\"{}\"]` is missing an \
+                upper bound on the uv_build version such as `<{next_breaking}`. \
+                Without bounding the uv_build version, the source distribution will break \
+                when a future, breaking version of uv_build is released.",
+                // Use an underscore consistently, to avoid confusing users between a package name with dash and a
+                // module name with underscore
+                uv_requirement.to_string().replace("uv-build", "uv_build")
             ));
         }
 
@@ -940,8 +943,8 @@ mod tests {
             {payload}
 
             [build-system]
-            requires = ["uv>=0.4.15,<5"]
-            build-backend = "uv"
+            requires = ["uv_build>=0.4.15,<5"]
+            build-backend = "uv_build"
         "#
         }
     }
@@ -1023,8 +1026,8 @@ mod tests {
             foo-bar = "foo:bar"
 
             [build-system]
-            requires = ["uv>=0.4.15,<5"]
-            build-backend = "uv"
+            requires = ["uv_build>=0.4.15,<5"]
+            build-backend = "uv_build"
         "#
         };
 
@@ -1150,8 +1153,8 @@ mod tests {
             foo-bar = "foo:bar"
 
             [build-system]
-            requires = ["uv>=0.4.15,<5"]
-            build-backend = "uv"
+            requires = ["uv_build>=0.4.15,<5"]
+            build-backend = "uv_build"
         "#
         };
 
@@ -1231,13 +1234,13 @@ mod tests {
             version = "0.1.0"
 
             [build-system]
-            requires = ["uv"]
-            build-backend = "uv"
+            requires = ["uv_build"]
+            build-backend = "uv_build"
         "#};
         let pyproject_toml = PyProjectToml::parse(contents).unwrap();
         assert_snapshot!(
             pyproject_toml.check_build_system("0.4.15+test").join("\n"),
-            @r###"`build_system.requires = ["uv"]` is missing an upper bound on the uv version such as `<0.5`. Without bounding the uv version, the source distribution will break when a future, breaking version of uv is released."###
+            @r###"`build_system.requires = ["uv_build"]` is missing an upper bound on the uv_build version such as `<0.5`. Without bounding the uv_build version, the source distribution will break when a future, breaking version of uv_build is released."###
         );
     }
 
@@ -1249,8 +1252,8 @@ mod tests {
             version = "0.1.0"
 
             [build-system]
-            requires = ["uv>=0.4.15,<5", "wheel"]
-            build-backend = "uv"
+            requires = ["uv_build>=0.4.15,<5", "wheel"]
+            build-backend = "uv_build"
         "#};
         let pyproject_toml = PyProjectToml::parse(contents).unwrap();
         assert_snapshot!(
@@ -1268,7 +1271,7 @@ mod tests {
 
             [build-system]
             requires = ["setuptools"]
-            build-backend = "uv"
+            build-backend = "uv_build"
         "#};
         let pyproject_toml = PyProjectToml::parse(contents).unwrap();
         assert_snapshot!(
@@ -1285,13 +1288,13 @@ mod tests {
             version = "0.1.0"
 
             [build-system]
-            requires = ["uv>=0.4.15,<5"]
+            requires = ["uv_build>=0.4.15,<5"]
             build-backend = "setuptools"
         "#};
         let pyproject_toml = PyProjectToml::parse(contents).unwrap();
         assert_snapshot!(
             pyproject_toml.check_build_system("0.4.15+test").join("\n"),
-            @r###"The value for `build_system.build-backend` should be `"uv"`, not `"setuptools"`"###
+            @r###"The value for `build_system.build-backend` should be `"uv_build"`, not `"setuptools"`"###
         );
     }
 

crates/uv-build/Cargo.toml

@@ -0,0 +1,19 @@
+[package]
+name = "uv-build"
+version = "0.5.31"
+edition.workspace = true
+rust-version.workspace = true
+homepage.workspace = true
+documentation.workspace = true
+repository.workspace = true
+authors.workspace = true
+license.workspace = true
+
+[dependencies]
+uv-build-backend = { workspace = true }
+uv-version = { workspace = true }
+
+anyhow = { workspace = true }
+
+[lints]
+workspace = true