Skip to content

Commit 9c8ab10

Browse files
committed
Document how to pass the confvals
Signed-off-by: Cristian Le <[email protected]>
1 parent 3b5a6c1 commit 9c8ab10

File tree

1 file changed

+49
-0
lines changed

1 file changed

+49
-0
lines changed

docs/reference/configs.md

+49
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,54 @@
11
# Configurations
22

3+
The following are the available configurations in `pyproject.toml` for the
4+
`[tool.scikit-build]` table. These can be passed in one of the following ways
5+
6+
````{tab} pyproject.toml
7+
8+
```toml
9+
[tool.scikit-build]
10+
build.verbose = true
11+
```
12+
13+
````
14+
15+
`````{tab} config-settings
16+
17+
````{tab} pip
18+
19+
```console
20+
$ pip install . --config-settings=build.verbose=true
21+
```
22+
23+
````
24+
25+
````{tab} build
26+
27+
```console
28+
$ pipx run build --wheel -Cbuild.verbose=true
29+
```
30+
31+
````
32+
33+
````{tab} cibuildwheel
34+
35+
```toml
36+
[tool.cibuildwheel.config-settings]
37+
"build.verbose" = true
38+
```
39+
40+
````
41+
42+
`````
43+
44+
````{tab} Environment
45+
46+
```console
47+
$ export SKBUILD_BUILD_VERBOSE="true"
48+
```
49+
50+
````
51+
352
<!-- [[[cog
453
from scikit_build_core.settings.skbuild_docs_sphinx import mk_skbuild_docs
554

0 commit comments

Comments
 (0)