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

Signed-off-by: Henry Schreiner <[email protected]>

Author: henryiii

bin/generate_schema.py

@@ -50,7 +50,7 @@
     default: default
     description: Set the tool to use to build, either "pip" (default for now) or "build"
     oneOf:
-      - enum: [pip, build, default]
+      - enum: [pip, build, "build[uv]", default]
       - type: string
         pattern: '^pip; ?args:'
       - type: string

cibuildwheel/resources/cibuildwheel.schema.json

@@ -102,6 +102,7 @@
           "enum": [
             "pip",
             "build",
+            "build[uv]",
             "default"
           ]
         },

cibuildwheel/resources/constraints-pyodide312.txt

@@ -102,12 +102,12 @@ typer==0.12.3
     #   pyodide-cli
 types-requests==2.32.0.20240602
     # via pyodide-build
-typing-extensions==4.12.1
+typing-extensions==4.12.2
     # via
     #   pydantic
     #   pydantic-core
     #   typer
-unearth==0.15.3
+unearth==0.15.4
     # via pyodide-build
 urllib3==2.2.1
     # via

cibuildwheel/resources/constraints-python310.txt

@@ -26,11 +26,9 @@ pyproject-hooks==1.1.0
     # via build
 tomli==2.0.1
     # via build
-typing-extensions==4.12.1
+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.1
+zipp==3.19.2
     # via importlib-metadata

cibuildwheel/resources/constraints-python311.txt

@@ -22,9 +22,7 @@ platformdirs==4.2.2
     # via virtualenv
 pyproject-hooks==1.1.0
     # via build
-typing-extensions==4.12.1
+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

cibuildwheel/resources/constraints-python312.txt

@@ -22,9 +22,7 @@ platformdirs==4.2.2
     # via virtualenv
 pyproject-hooks==1.1.0
     # via build
-typing-extensions==4.12.1
+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

cibuildwheel/resources/constraints-python313.txt

@@ -22,9 +22,7 @@ platformdirs==4.2.2
     # via virtualenv
 pyproject-hooks==1.1.0
     # via build
-typing-extensions==4.12.1
+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

cibuildwheel/resources/constraints-python38.txt

@@ -26,11 +26,9 @@ pyproject-hooks==1.1.0
     # via build
 tomli==2.0.1
     # via build
-typing-extensions==4.12.1
+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.1
+zipp==3.19.2
     # via importlib-metadata

cibuildwheel/resources/constraints-python39.txt

@@ -26,11 +26,9 @@ pyproject-hooks==1.1.0
     # via build
 tomli==2.0.1
     # via build
-typing-extensions==4.12.1
+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.1
+zipp==3.19.2
     # via importlib-metadata

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

cibuildwheel/resources/constraints.txt

@@ -22,9 +22,7 @@ platformdirs==4.2.2
     # via virtualenv
 pyproject-hooks==1.1.0
     # via build
-typing-extensions==4.12.1
+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

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}