@@ -64,10 +64,12 @@ You can configure cibuildwheel with a config file, such as `pyproject.toml`.
6464Options have the same names as the environment variable overrides, but are
6565placed in ` [tool.cibuildwheel] ` and are lower case, with dashes, following
6666common [ TOML] ( https://toml.io ) practice. Anything placed in subsections
67- named after a platform will only affect those platforms. Lists can be used
68- instead of strings for items that are naturally a list. Multiline strings also
69- work just like in the environment variables. Environment variables will take
70- precedence if defined.
67+ named after a platform will only affect those platforms. Platform-specific
68+ values replace the corresponding global value for that platform; table options
69+ are not merged key by key. Lists can be used instead of strings for items that
70+ are naturally a list. Multiline strings also work just like in the environment
71+ variables. Environment variable overrides, such as ` CIBW_TEST_COMMAND ` and
72+ ` CIBW_TEST_COMMAND_LINUX ` , will take precedence if defined.
7173
7274The example above using environment variables could have been written like this:
7375
@@ -178,7 +180,7 @@ on Python 3.11, and will have `environment = {FOO="BAZ", "PYTHON"="MONTY", "HAM"
178180In the TOML configuration, you can choose how tables and lists are inherited.
179181By default, all values are overridden completely (` "none" ` ) but sometimes you'd
180182rather ` "append" ` or ` "prepend" ` to an existing list or table. You can do this
181- with the ` inherit ` table in overrides. For example, if you want to add an environment
183+ with the ` inherit ` table in overrides. For example, if you want to add an environment
182184variable for CPython 3.11, without ` inherit ` you'd have to repeat all the
183185original environment variables in the override. With ` inherit ` , it's just:
184186
0 commit comments