Skip to content

Commit 061ea62

Browse files
committed
Add docs
1 parent 297e4a6 commit 061ea62

File tree

1 file changed

+17
-1
lines changed

1 file changed

+17
-1
lines changed

docs/options.md

+17-1
Original file line numberDiff line numberDiff line change
@@ -504,9 +504,19 @@ This option can also be set using the [command-line option](#command-line) `--pr
504504
### `CIBW_BUILD_FRONTEND` {: #build-frontend}
505505
> Set the tool to use to build, either "pip" (default for now) or "build"
506506
507-
Choose which build backend to use. Can either be "pip", which will run
507+
Options:
508+
509+
- `pip[;args: ...]`
510+
- `build[;args: ...]`
511+
512+
Default: `pip`
513+
514+
Choose which build frontend to use. Can either be "pip", which will run
508515
`python -m pip wheel`, or "build", which will run `python -m build --wheel`.
509516

517+
You can specify extra arguments to pass to `pip wheel` or `build` using the
518+
optional `args` option.
519+
510520
!!! tip
511521
Until v2.0.0, [pip] was the only way to build wheels, and is still the
512522
default. However, we expect that at some point in the future, cibuildwheel
@@ -526,6 +536,9 @@ Choose which build backend to use. Can either be "pip", which will run
526536

527537
# Ensure pip is used even if the default changes in the future
528538
CIBW_BUILD_FRONTEND: "pip"
539+
540+
# supply an extra argument to 'pip wheel'
541+
CIBW_BUILD_FRONTEND: "pip; args: --no-build-isolation"
529542
```
530543

531544
!!! tab examples "pyproject.toml"
@@ -537,6 +550,9 @@ Choose which build backend to use. Can either be "pip", which will run
537550

538551
# Ensure pip is used even if the default changes in the future
539552
build-frontend = "pip"
553+
554+
# supply an extra argument to 'pip wheel'
555+
build-frontend = { name = "pip", args = ["--no-build-isolation"] }
540556
```
541557

542558
### `CIBW_CONFIG_SETTINGS` {: #config-settings}

0 commit comments

Comments
 (0)