chore: docs and remove uv pinning as it's not installed

henryiii · henryiii · commit 09bd9ba9c1e0 · 2024-06-08T01:40:55.000-04:00
Signed-off-by: Henry Schreiner &lt;henryschreineriii@gmail.com&gt;
diff --git a/bin/generate_schema.py b/bin/generate_schema.py
@@ -48,19 +48,21 @@
     type: string_array
   build-frontend:
     default: default
-    description: Set the tool to use to build, either "pip" (default for now) or "build"
+    description: Set the tool to use to build, either "pip" (default for now), "build", or "build[uv]"
     oneOf:
-      - enum: [pip, build, default]
+      - enum: [pip, build, "build[uv]", default]
       - type: string
         pattern: '^pip; ?args:'
       - type: string
         pattern: '^build; ?args:'
+      - type: string
+        pattern: '^build\[uv\]; ?args:'
       - type: object
         additionalProperties: false
         required: [name]
         properties:
           name:
-            enum: [pip, build]
+            enum: [pip, build, "build[uv]"]
           args:
             type: array
             items:
diff --git a/cibuildwheel/resources/cibuildwheel.schema.json b/cibuildwheel/resources/cibuildwheel.schema.json
@@ -96,12 +96,13 @@
     },
     "build-frontend": {
       "default": "default",
-      "description": "Set the tool to use to build, either \"pip\" (default for now) or \"build\"",
+      "description": "Set the tool to use to build, either \"pip\" (default for now), \"build\", or \"build[uv]\"",
       "oneOf": [
         {
           "enum": [
             "pip",
             "build",
+            "build[uv]",
             "default"
           ]
         },
@@ -113,6 +114,10 @@
           "type": "string",
           "pattern": "^build; ?args:"
         },
+        {
+          "type": "string",
+          "pattern": "^build\\[uv\\]; ?args:"
+        },
         {
           "type": "object",
           "additionalProperties": false,
@@ -123,7 +128,8 @@
             "name": {
               "enum": [
                 "pip",
-                "build"
+                "build",
+                "build[uv]"
               ]
             },
             "args": {
diff --git a/cibuildwheel/resources/constraints-python310.txt b/cibuildwheel/resources/constraints-python310.txt
@@ -28,8 +28,6 @@ tomli==2.0.1
     # via build
 typing-extensions==4.12.2
     # via delocate
-uv==0.2.8
-    # via -r cibuildwheel/resources/constraints.in
 virtualenv==20.26.2
     # via -r cibuildwheel/resources/constraints.in
 zipp==3.19.2
diff --git a/cibuildwheel/resources/constraints-python311.txt b/cibuildwheel/resources/constraints-python311.txt
@@ -24,7 +24,5 @@ pyproject-hooks==1.1.0
     # via build
 typing-extensions==4.12.2
     # via delocate
-uv==0.2.8
-    # via -r cibuildwheel/resources/constraints.in
 virtualenv==20.26.2
     # via -r cibuildwheel/resources/constraints.in
diff --git a/cibuildwheel/resources/constraints-python312.txt b/cibuildwheel/resources/constraints-python312.txt
@@ -24,7 +24,5 @@ pyproject-hooks==1.1.0
     # via build
 typing-extensions==4.12.2
     # via delocate
-uv==0.2.8
-    # via -r cibuildwheel/resources/constraints.in
 virtualenv==20.26.2
     # via -r cibuildwheel/resources/constraints.in
diff --git a/cibuildwheel/resources/constraints-python313.txt b/cibuildwheel/resources/constraints-python313.txt
@@ -24,7 +24,5 @@ pyproject-hooks==1.1.0
     # via build
 typing-extensions==4.12.2
     # via delocate
-uv==0.2.8
-    # via -r cibuildwheel/resources/constraints.in
 virtualenv==20.26.2
     # via -r cibuildwheel/resources/constraints.in
diff --git a/cibuildwheel/resources/constraints-python38.txt b/cibuildwheel/resources/constraints-python38.txt
@@ -28,8 +28,6 @@ tomli==2.0.1
     # via build
 typing-extensions==4.12.2
     # via delocate
-uv==0.2.8
-    # via -r cibuildwheel/resources/constraints.in
 virtualenv==20.26.2
     # via -r cibuildwheel/resources/constraints.in
 zipp==3.19.2
diff --git a/cibuildwheel/resources/constraints-python39.txt b/cibuildwheel/resources/constraints-python39.txt
@@ -28,8 +28,6 @@ tomli==2.0.1
     # via build
 typing-extensions==4.12.2
     # via delocate
-uv==0.2.8
-    # via -r cibuildwheel/resources/constraints.in
 virtualenv==20.26.2
     # via -r cibuildwheel/resources/constraints.in
 zipp==3.19.2
diff --git a/cibuildwheel/resources/constraints.in b/cibuildwheel/resources/constraints.in
@@ -2,5 +2,4 @@ pip>=24.1b1 ; python_version >= '3.13'
 pip ; python_version < '3.13'
 build
 delocate
-uv; python_version >= '3.8'
 virtualenv
diff --git a/cibuildwheel/resources/constraints.txt b/cibuildwheel/resources/constraints.txt
@@ -24,7 +24,5 @@ pyproject-hooks==1.1.0
     # via build
 typing-extensions==4.12.2
     # via delocate
-uv==0.2.8
-    # via -r cibuildwheel/resources/constraints.in
 virtualenv==20.26.2
     # via -r cibuildwheel/resources/constraints.in
diff --git a/docs/options.md b/docs/options.md
@@ -624,7 +624,7 @@ This option can also be set using the [command-line option](#command-line) `--pr
 ## Build customization
 
 ### `CIBW_BUILD_FRONTEND` {: #build-frontend}
-> Set the tool to use to build, either "pip" (default for now) or "build"
+> Set the tool to use to build, either "pip" (default for now), "build", or "build[uv]"
 
 Options:
 
@@ -636,17 +636,30 @@ Default: `pip`
 Choose which build frontend to use. Can either be "pip", which will run
 `python -m pip wheel`, or "build", which will run `python -m build --wheel`.
 
+You can also use "build[uv]", which will use an external [uv][] everywhere
+possible, both through `--installer=uv` passed to build, as well as when making
+all build and test environments. This will generally speed up cibuildwheel.
+Make sure you have an external uv on Windows and macOS, either by
+pre-installing it, or installing cibuildwheel with the uv extra,
+`cibuildwheel[uv]`. `uv` will not be used for Python 3.6 or Python 3.7. You
+cannot use uv currently on Windows for ARM or for musllinux on s390x as
+binaries are not provided by uv. Legacy dependencies like setuptools on Python
+< 3.12 and pip are not installed if using uv.
+
+Pyodide ignores this setting, as only "build" is supported.
+
 You can specify extra arguments to pass to `pip wheel` or `build` using the
 optional `args` option.
 
 !!! tip
-    Until v2.0.0, [pip] was the only way to build wheels, and is still the
+    Until v2.0.0, [pip][] was the only way to build wheels, and is still the
     default. However, we expect that at some point in the future, cibuildwheel
-    will change the default to [build], in line with the PyPA's recommendation.
+    will change the default to [build][], in line with the PyPA's recommendation.
     If you want to try `build` before this, you can use this option.
 
 [pip]: https://pip.pypa.io/en/stable/cli/pip_wheel/
 [build]: https://github.com/pypa/build/
+[uv]: https://github.com/astral-sh/uv
 
 #### Examples
 
@@ -661,6 +674,12 @@ optional `args` option.
 
     # supply an extra argument to 'pip wheel'
     CIBW_BUILD_FRONTEND: "pip; args: --no-build-isolation"
+
+    # Use uv and build
+    CIBW_BUILD_FRONTEND: "build[uv]"
+
+    # Use uv and build with an argument
+    CIBW_BUILD_FRONTEND: "build[uv]; args: --no-isolation"
     ```
 
 !!! tab examples "pyproject.toml"
@@ -675,6 +694,12 @@ optional `args` option.
 
     # supply an extra argument to 'pip wheel'
     build-frontend = { name = "pip", args = ["--no-build-isolation"] }
+
+    # Use uv and build
+    build-frontend = "build[uv]"
+
+    # Use uv and build with an argument
+    build-frontend = { name = "build[uv]", args = ["--no-isolation"] }
     ```
 
 ### `CIBW_CONFIG_SETTINGS` {: #config-settings}
