Skip to content

Commit adba99c

Browse files
committed
Bump version: v4.3.0
1 parent 8a0d481 commit adba99c

13 files changed

Lines changed: 51 additions & 77 deletions

‎README.md‎

Lines changed: 17 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ jobs:
9999
- uses: actions/setup-python@v6
100100

101101
- name: Install cibuildwheel
102-
run: python -m pip install cibuildwheel==4.2.1
102+
run: python -m pip install cibuildwheel==4.3.0
103103

104104
- name: Build wheels
105105
run: python -m cibuildwheel --output-dir wheelhouse
@@ -241,6 +241,21 @@ Changelog
241241

242242
<!-- [[[cog from readme_changelog import mini_changelog; print(mini_changelog()) ]]] -->
243243

244+
### v4.3.0
245+
246+
_5 October 2026_
247+
248+
- ✨ Extends [option inheritance](https://cibuildwheel.pypa.io/en/stable/configuration/#inherit) to every configuration layer, so global and platform-specific settings can append or prepend to existing values, including cibuildwheel's defaults. Environment variables can also extend earlier settings using `CIBW_INHERIT`. (#2928)
249+
- ✨ Adds PyPy 3.12 support and updates PyPy 3.11 to v8.0.0, available with the `pypy` [`enable`](https://cibuildwheel.pypa.io/en/stable/options/#enable) flag (#2998)
250+
- ✨ Adds GraalPy 3.13 (v25.3) support on Linux, Windows, and macOS arm64, available with the `graalpy` [`enable`](https://cibuildwheel.pypa.io/en/stable/options/#enable) flag (#2982)
251+
- ✨ Adds [`log-fold-mode`](https://cibuildwheel.pypa.io/en/stable/options/#log-fold-mode) to override CI log folding, including `CIBW_LOG_FOLD_MODE=disabled` to keep build steps expanded (#2972)
252+
- ✨ Adds a `python-path` input to the GitHub Action to choose the Python interpreter used to run cibuildwheel, and falls back to system `python3` on runner architectures unsupported by `setup-python`, such as native riscv64 (#2990)
253+
- 🐛 Fixes Windows command execution when paths or arguments contain shell metacharacters, including dependency specifiers containing `<` or `>` (#2978)
254+
- 🛠 Improves readability of logged commands whose arguments contain quotes (#2993)
255+
- 🛠 Updates Pyodide to 0.27.8, 0.29.5, and 314.0.7, and updates its build tooling, including auditwheel-emscripten 0.3.0 (#2996)
256+
- 🛠 Updates dependencies and container pins, including CPython 3.15.0rc3 (#2986, #3003)
257+
- 📚 Corrects references to `--archs` in CLI help, error messages, and documentation (#2992)
258+
244259
### v4.2.1
245260

246261
_5 September 2026_
@@ -296,63 +311,7 @@ _12 June 2026_
296311
- 📚 Adds an FAQ section on caching cibuildwheel's downloaded tools with `CIBW_CACHE_PATH` (#2842)
297312
- 📚 Documentation improvements: clarifies which shell is used for command options, clarifies environment variable precedence, and fixes a dead Pyodide env info link (#2904, #2905, #2911)
298313

299-
### v4.0.0
300-
301-
_7 June 2026_
302-
303-
See @henryiii's [release post](https://iscinumpy.dev/post/cibuildwheel-4-0-0/) for more info on new features!
304-
305-
- 🌟 Adds wheel auditing with `abi3audit` as a default after the repair step, with new [`audit-requires`](https://cibuildwheel.pypa.io/en/stable/options/#audit-requires) and [`audit-command`](https://cibuildwheel.pypa.io/en/stable/options/#audit-command) options (#2805)
306-
- 🌟 Adds `pyemscripten` platform tag support (PEP 783), updates Pyodide to 314.0.0a2, and adds a `pyodide-eol` [`enable`](https://cibuildwheel.pypa.io/en/stable/options/#enable) flag for building end-of-life Pyodide versions (#2812, #2848)
307-
- 🌟 Sets up `delvewheel` as the default [`repair-wheel-command`](https://cibuildwheel.pypa.io/en/stable/options/#repair-wheel-command) for Windows, so extension module DLLs are now bundled automatically. Skip by setting it to empty if not needed. (#2831)
308-
- ✨ Adds CPython 3.15 support, under the [`enable` option](https://cibuildwheel.pypa.io/en/stable/options/#enable) `cpython-prerelease`. This version of cibuildwheel uses 3.15.0b2. (#2833, #2850)
309-
310-
_While CPython is in beta, the ABI can change, so your wheels might not be compatible with the final release. For this reason, we don't recommend distributing wheels until RC1, at which point 3.15 will be available in cibuildwheel without the flag._
311-
312-
- ✨ Adds CPython 3.15 support for iOS and Android (#2857, #2858)
313-
- ✨ Adds Android improvements for building NumPy and related packages, including auditwheel support, pkg-config and Fortran configuration, and the [`xbuild-files`](https://cibuildwheel.pypa.io/en/stable/options/#xbuild-files) option (#2695)
314-
- ✨ Adds `CIBUILDWHEEL_BUILD_IDENTIFIER` environment variable set to the current build identifier (e.g. `cp311-manylinux_x86_64`) during per-build steps (#2872)
315-
- ✨ Adds `{project}` and `{package}` placeholders to [`config-settings`](https://cibuildwheel.pypa.io/en/stable/options/#config-settings) (#2827)
316-
- ⚠️ Drops support for Python 3.8 (#2686)
317-
- ⚠️ Removes the experimental CPython 3.13 free-threading builds and the `cpython-freethreading` [`enable`](https://cibuildwheel.pypa.io/en/stable/options/#enable) option. CPython 3.14+ free-threading support remains available without the enable flag. (#2684)
318-
- ⚠️ Drops support for Cirrus CI, which is shutting down June 1, 2026 (#2817)
319-
- ⚠️ Drops GraalPy 3.11 (gp311) support, as agreed in #2741, and removes GraalPy 24-only workarounds (#2895)
320-
- 🔐 Adds SHA256 verification for direct downloads of Python interpreters, virtualenv, and python-build-standalone assets (#2873)
321-
- 🔐 Adds tarfile extraction filter for safe archive extraction (#2856)
322-
- 🐛 Fixes `UV_PYTHON` not being set for [`before-build`](https://cibuildwheel.pypa.io/en/stable/options/#before-build) on Linux when using `uv` as the [`build-frontend`](https://cibuildwheel.pypa.io/en/stable/options/#build-frontend) (#2830)
323-
- 🐛 Fixes detection of musl libc when downloading python-build-standalone, which previously always selected the gnu asset on musl hosts like Alpine (#2889)
324-
- 🐛 Fixes [`config-settings`](https://cibuildwheel.pypa.io/en/stable/options/#config-settings) expansion when `{project}` or `{package}` contains spaces or backslashes (#2886)
325-
- 🐛 Prevents deadlock when `linux32` fails and forwards platform args to the sanity check (#2880, #2888)
326-
- 🐛 Fixes container resource leaks on start failure and during teardown (#2879, #2887)
327-
- 🐛 Removes potential partial cache-population in case of error (#2892)
328-
- 🐛 Raises a clear error when `ANDROID_API_LEVEL` is not an integer (#2891)
329-
- 🐛 Replaces assert with proper exception in python-build-standalone (#2859)
330-
- 🐛 Uses ConfigurationError when `package_dir` is outside cwd instead of a generic Exception (#2898)
331-
- 🛠 Updates dependencies and container pins (#2893, #2882, #2874, #2868, #2862, #2884, #2845, #2837, #2818, #2810, #2838, #2813)
332-
- 🛠 Updates Android to Python 3.13.13 and 3.14.4 (#2821)
333-
- 🛠 Applies Pyodide-specific patches to the Emscripten toolchain installation (#2800)
334-
- 🛠 Uses `python -V -V` for Windows build diagnostics (#2832)
335-
- 🛠 Simplifies pinned container image lookup (#2897)
336-
- 🛠 Minor fixups across error messages, OCI container, and options (#2860)
337-
- 💼 Adds PEP 723 metadata for `bin/` scripts and drops the `bin` dependency group (#2819)
338-
- 💼 Improves Azure test reliability with retries and caching (#2890)
339-
- 💼 Fixes Windows GitLab CI test running (#2870)
340-
- 💼 Updates CI action pins and dev dependencies (#2902, #2867, #2851, #2843, #2826, #2823, #2820, #2807)
341-
- 💼 Adds agent and copilot setup files (#2861)
342-
- 💼 Uses `if TYPE_CHECKING:` blocks (#2866, #2864)
343-
- 🧪 Fixes Android tests using the `uv` frontend (#2809)
344-
- 🧪 Fixes the update-dependencies workflow to use `uv` to run `nox` (#2808)
345-
- 🧪 Adds unit tests for `OCIContainer._get_platform_args` (#2878)
346-
- 📚 Updates documentation for delvewheel as the default Windows [`repair-wheel-command`](https://cibuildwheel.pypa.io/en/stable/options/#repair-wheel-command), including the build diagram, schema defaults, and legal note (#2877, #2853, #2891)
347-
- 📚 Documents platform-specific [`before-build`](https://cibuildwheel.pypa.io/en/stable/options/#before-build) configuration (#2834)
348-
- 📚 Updates the "How it works" diagram with details of Android, iOS, and Pyodide builds (#2816)
349-
- 📚 Adds Pyodide icon and regenerates working examples data for Android, iOS, and Pyodide (#2815, #2811)
350-
- 📚 Adds intersphinx support for external documentation linking (#2871)
351-
- 📚 Adds instructions for building CUDA wheels and fixes manylinux container references in FAQ (#2896, #2900)
352-
- 📚 Links back to source in docs (#2806)
353-
- 📚 Removes outdated numpy info (#2855)
354-
355-
<!-- [[[end]]] (sum: 0zxqpn7F3B) -->
314+
<!-- [[[end]]] (sum: X2rbVg9Z07) -->
356315

357316
---
358317

‎cibuildwheel/__init__.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
__version__ = "4.2.1"
1+
__version__ = "4.3.0"

‎docs/changelog.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,21 @@ ref: changelog
55

66
# Changelog
77

8+
### v4.3.0
9+
10+
_5 October 2026_
11+
12+
- ✨ Extends [option inheritance](https://cibuildwheel.pypa.io/en/stable/configuration/#inherit) to every configuration layer, so global and platform-specific settings can append or prepend to existing values, including cibuildwheel's defaults. Environment variables can also extend earlier settings using `CIBW_INHERIT`. (#2928)
13+
- ✨ Adds PyPy 3.12 support and updates PyPy 3.11 to v8.0.0, available with the `pypy` [`enable`](https://cibuildwheel.pypa.io/en/stable/options/#enable) flag (#2998)
14+
- ✨ Adds GraalPy 3.13 (v25.3) support on Linux, Windows, and macOS arm64, available with the `graalpy` [`enable`](https://cibuildwheel.pypa.io/en/stable/options/#enable) flag (#2982)
15+
- ✨ Adds [`log-fold-mode`](https://cibuildwheel.pypa.io/en/stable/options/#log-fold-mode) to override CI log folding, including `CIBW_LOG_FOLD_MODE=disabled` to keep build steps expanded (#2972)
16+
- ✨ Adds a `python-path` input to the GitHub Action to choose the Python interpreter used to run cibuildwheel, and falls back to system `python3` on runner architectures unsupported by `setup-python`, such as native riscv64 (#2990)
17+
- 🐛 Fixes Windows command execution when paths or arguments contain shell metacharacters, including dependency specifiers containing `<` or `>` (#2978)
18+
- 🛠 Improves readability of logged commands whose arguments contain quotes (#2993)
19+
- 🛠 Updates Pyodide to 0.27.8, 0.29.5, and 314.0.7, and updates its build tooling, including auditwheel-emscripten 0.3.0 (#2996)
20+
- 🛠 Updates dependencies and container pins, including CPython 3.15.0rc3 (#2986, #3003)
21+
- 📚 Corrects references to `--archs` in CLI help, error messages, and documentation (#2992)
22+
823
### v4.2.1
924

1025
_5 September 2026_

‎docs/faq.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -158,7 +158,7 @@ There are two suggested methods for keeping cibuildwheel up to date that instead
158158
If you use GitHub Actions for builds, you can use cibuildwheel as an action:
159159

160160
```yaml
161-
uses: pypa/cibuildwheel@v4.2.1
161+
uses: pypa/cibuildwheel@v4.3.0
162162
```
163163
164164
This is a composite step that just runs cibuildwheel using pipx. You can set command-line options as `with:` parameters, and use `env:` as normal.
@@ -183,7 +183,7 @@ The second option, and the only one that supports other CI systems, is using a `
183183

184184
```bash
185185
# requirements-cibw.txt
186-
cibuildwheel==4.2.1
186+
cibuildwheel==4.3.0
187187
```
188188

189189
Then your install step would have `python -m pip install -r requirements-cibw.txt` in it. Your `.github/dependabot.yml` file could look like this:
@@ -402,7 +402,7 @@ Solutions to this vary, but the simplest is to use pipx:
402402
# most runners have pipx preinstalled, but in case you don't
403403
python3 -m pip install pipx
404404
405-
pipx run cibuildwheel==4.2.1 --output-dir wheelhouse
405+
pipx run cibuildwheel==4.3.0 --output-dir wheelhouse
406406
pipx run twine upload wheelhouse/*.whl
407407
```
408408

‎examples/azure-pipelines-minimal.yml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ jobs:
66
- bash: |
77
set -o errexit
88
python3 -m pip install --upgrade pip
9-
pip3 install cibuildwheel==4.2.1
9+
pip3 install cibuildwheel==4.3.0
1010
displayName: Install dependencies
1111
- bash: cibuildwheel --output-dir wheelhouse .
1212
displayName: Build wheels
@@ -20,7 +20,7 @@ jobs:
2020
- bash: |
2121
set -o errexit
2222
python3 -m pip install --upgrade pip
23-
python3 -m pip install cibuildwheel==4.2.1
23+
python3 -m pip install cibuildwheel==4.3.0
2424
displayName: Install dependencies
2525
- bash: cibuildwheel --output-dir wheelhouse .
2626
displayName: Build wheels
@@ -34,7 +34,7 @@ jobs:
3434
- bash: |
3535
set -o errexit
3636
python -m pip install --upgrade pip
37-
pip install cibuildwheel==4.2.1
37+
pip install cibuildwheel==4.3.0
3838
displayName: Install dependencies
3939
- bash: cibuildwheel --output-dir wheelhouse .
4040
displayName: Build wheels

‎examples/circleci-minimal.yml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ jobs:
1111
- run:
1212
name: Build the Linux wheels.
1313
command: |
14-
python3 -m pip install --user cibuildwheel==4.2.1
14+
python3 -m pip install --user cibuildwheel==4.3.0
1515
cibuildwheel --output-dir wheelhouse
1616
- store_artifacts:
1717
path: wheelhouse/
@@ -28,7 +28,7 @@ jobs:
2828
- run:
2929
name: Build the Linux aarch64 wheels.
3030
command: |
31-
python3 -m pip install --user cibuildwheel==4.2.1
31+
python3 -m pip install --user cibuildwheel==4.3.0
3232
python3 -m cibuildwheel --output-dir wheelhouse
3333
- store_artifacts:
3434
path: wheelhouse/
@@ -44,7 +44,7 @@ jobs:
4444
name: Build the OS X wheels.
4545
command: |
4646
sudo softwareupdate --install-rosetta --agree-to-license # for x86_64/universal2 tests
47-
pip3 install cibuildwheel==4.2.1
47+
pip3 install cibuildwheel==4.3.0
4848
cibuildwheel --output-dir wheelhouse
4949
- store_artifacts:
5050
path: wheelhouse/

‎examples/github-deploy.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ jobs:
5353
persist-credentials: false
5454

5555
- name: Build wheels
56-
uses: pypa/cibuildwheel@v4.2.1
56+
uses: pypa/cibuildwheel@v4.3.0
5757
env:
5858
CIBW_PLATFORM: ${{ matrix.platform || 'auto' }}
5959
CIBW_ARCHS: ${{ matrix.archs || 'auto' }}

‎examples/github-minimal.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ jobs:
1717
persist-credentials: false
1818

1919
- name: Build wheels
20-
uses: pypa/cibuildwheel@v4.2.1
20+
uses: pypa/cibuildwheel@v4.3.0
2121
# env:
2222
# CIBW_SOME_OPTION: value
2323
# ...

‎examples/github-pipx.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ jobs:
1717
persist-credentials: false
1818

1919
- name: Build wheels
20-
run: pipx run cibuildwheel==4.2.1
20+
run: pipx run cibuildwheel==4.3.0
2121

2222
- uses: actions/upload-artifact@v4
2323
with:

‎examples/github-with-qemu.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ jobs:
2323
platforms: all
2424

2525
- name: Build wheels
26-
uses: pypa/cibuildwheel@v4.2.1
26+
uses: pypa/cibuildwheel@v4.3.0
2727
env:
2828
# configure cibuildwheel on Linux to build native archs ('auto'),
2929
# and to split the remaining architectures between the x86_64 and

0 commit comments

Comments
 (0)