From 42075f1dd822d703d50c46d38999cc15e940b94a Mon Sep 17 00:00:00 2001 From: Joe Rickerby Date: Sun, 5 Jan 2025 14:37:57 +0000 Subject: [PATCH] Write docs for inline dependency-versions --- docs/options.md | 21 ++++++++++++++++++--- 1 file changed, 18 insertions(+), 3 deletions(-) diff --git a/docs/options.md b/docs/options.md index a1452e17a..74c91cef0 100644 --- a/docs/options.md +++ b/docs/options.md @@ -1353,9 +1353,10 @@ Options can be supplied after the name. ### `CIBW_DEPENDENCY_VERSIONS` {: #dependency-versions} -> Specify how cibuildwheel controls the versions of the tools it uses -Options: `pinned` `latest` `` +> Control the versions of the tools cibuildwheel uses + +Options: `pinned` `latest` `inline: SPECIFIER...` `` Default: `pinned` @@ -1370,7 +1371,8 @@ fixes that can't wait for a new cibuildwheel release. To control the versions of dependencies yourself, you can supply a [pip constraints](https://pip.pypa.io/en/stable/user_guide/#constraints-files) file -here and it will be used instead. +here and it will be used instead. Alternatively, you can list constraint +specifiers inline with the `inline: SPECIFIER...` syntax. !!! note If you need different dependencies for each python version, provide them @@ -1401,6 +1403,12 @@ Platform-specific environment variables are also available:
# Use your own pip constraints file CIBW_DEPENDENCY_VERSIONS: ./constraints.txt + + # Specify requirements inline + CIBW_DEPENDENCY_VERSIONS: "inline: auditwheel==6.2.0" + + # Choose a specific pyodide-build version + CIBW_DEPENDENCY_VERSIONS_PYODIDE: "inline: pyodide-build==0.29.1" ``` !!! tab examples "pyproject.toml" @@ -1415,6 +1423,13 @@ Platform-specific environment variables are also available:
# Use your own pip constraints file dependency-versions = "./constraints.txt" + + # Specify requirements inline + dependency-versions = { inline = ["auditwheel==6.2.0"] } + + [tool.cibuildwheel.pyodide] + # Choose a specific pyodide-build version + dependency-versions = { inline = ["pyodide-build==0.29.1"] } ```