You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/options.md
+6-2Lines changed: 6 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -101,7 +101,7 @@ The complete set of defaults for the current version of cibuildwheel are shown b
101
101
102
102
!!! tip
103
103
Static configuration works across all CI systems, and can be used locally if
104
-
you run `cibuildwheel --plat linux`. This is preferred, but environment
104
+
you run `cibuildwheel --platform linux`. This is preferred, but environment
105
105
variables are better if you need to change per-matrix element
106
106
(`CIBW_BUILD` is often in this category, for example), or if you cannot or do
107
107
not want to change a `pyproject.toml` file. You can specify a different file to
@@ -190,6 +190,10 @@ This option can also be set using the [command-line option](#command-line) `--pl
190
190
191
191
This is even more convenient if you store your cibuildwheel config in [`pyproject.toml`](#configuration-file).
192
192
193
+
You can also run a single identifier with `--only <identifier>`. This will
194
+
not require `--platform` or `--arch`, and will override any build/skip
195
+
configuration.
196
+
193
197
### `CIBW_BUILD`, `CIBW_SKIP` {: #build-skip}
194
198
195
199
> Choose the Python versions to build
@@ -907,7 +911,7 @@ If this option is blank, it will fall though to the next available definition (e
907
911
908
912
If setting a custom image, you'll need to make sure it can be used in the same way as the default images: all necessary Python and pip versions need to be present in `/opt/python/`, and the auditwheel tool needs to be present for cibuildwheel to work. Apart from that, the architecture and relevant shared system libraries need to be compatible to the relevant standard to produce valid manylinux1/manylinux2010/manylinux2014/manylinux_2_24/manylinux_2_28/musllinux_1_1 wheels (see [pypa/manylinux on GitHub](https://github.com/pypa/manylinux), [PEP 513](https://www.python.org/dev/peps/pep-0513/), [PEP 571](https://www.python.org/dev/peps/pep-0571/), [PEP 599](https://www.python.org/dev/peps/pep-0599/), [PEP 600](https://www.python.org/dev/peps/pep-0600/) and [PEP 656](https://www.python.org/dev/peps/pep-0656/) for more details).
909
913
910
-
Auditwheel detects the version of the manylinux / musllinux standard in the image through the `AUDITWHEEL_PLAT` environment variable, as cibuildwheel has no way of detecting the correct `--plat` command line argument to pass to auditwheel for a custom image. If a custom image does not correctly set this `AUDITWHEEL_PLAT` environment variable, the `CIBW_ENVIRONMENT` option can be used to do so (e.g., `CIBW_ENVIRONMENT='AUDITWHEEL_PLAT="manylinux2010_$(uname -m)"'`).
914
+
Auditwheel detects the version of the manylinux / musllinux standard in the image through the `AUDITWHEEL_PLAT` environment variable, as cibuildwheel has no way of detecting the correct `--platform` command line argument to pass to auditwheel for a custom image. If a custom image does not correctly set this `AUDITWHEEL_PLAT` environment variable, the `CIBW_ENVIRONMENT` option can be used to do so (e.g., `CIBW_ENVIRONMENT='AUDITWHEEL_PLAT="manylinux2010_$(uname -m)"'`).
0 commit comments