Bump version: v3.1.4

Author: henryiii

README.md

@@ -97,7 +97,7 @@ jobs:
       - uses: actions/setup-python@v5
 
       - name: Install cibuildwheel
-        run: python -m pip install cibuildwheel==3.1.3
+        run: python -m pip install cibuildwheel==3.1.4
 
       - name: Build wheels
         run: python -m cibuildwheel --output-dir wheelhouse
@@ -227,14 +227,32 @@ Changelog
 
 <!-- [[[cog from readme_changelog import mini_changelog; print(mini_changelog()) ]]] -->
 
+### v3.1.4
+
+_19 August 2025_
+
+- ✨ Add a `--clean-cache` command to clean up our cache (#2489)
+- 🛠 Update Python to 3.14rc2 and other patch version bumps (#2542, #2556)
+- 🛠 Update Pyodide to 0.28.2 (#2562, #2558)
+- 🐛 Fix resolution with `pyodide-build` when `dependency-versions` is set (#2548)
+- 🐛 Set `CMAKE_FIND_ROOT_PATH_MODE_PACKAGE` to `BOTH` on Android (#2547)
+- 🐛 Add `patchelf` dependency for platforms that can build Android wheels (#2552)
+- 🐛 Ignore empty values for `CIBW_ARCHS` like most other environment variables (#2541)
+- 💼 The `color` and `suggest_on_error` argparse options are now default in 3.14rc1+ (#2554)
+- 💼 Use the virtualenv release URL instead of blob URL (should be more robust) (#2555)
+- 🧪 For iOS, lowering to macos-14 is needed for now due to issues with GitHub's runner images (#2557)
+- 🧪 Split out platforms iOS and Android in our tests (#2519)
+- 🧪 Fix and enable doctests (#2546)
+- 📚 Improve our docs on free-threading (#2549)
+
+
 ### v3.1.3
 
 _1 August 2025_
 
 - 🐛 Fix bug where "latest" dependencies couldn't update to pip 25.2 on Windows (#2537)
-- 🛠 Use pytest-rerunfailures to improve some of our iOS/Android tests (#2527, #2539)
-- 🛠 Remove some GraalPy Windows workarounds in our tests (#2501)
-
+- 🧪 Use pytest-rerunfailures to improve some of our iOS/Android tests (#2527, #2539)
+- 🧪 Remove some GraalPy Windows workarounds in our tests (#2501)
 
 
 ### v3.1.2
@@ -272,19 +290,10 @@ _23 July 2025_
 - 🛠 Fixed a typo in the 3.9 MUSL riscv64 identifier (`cp39-musllinux_ricv64` -> `cp39-musllinux_riscv64`) (#2490)
 - 🛠 Mistyping `--only` now shows the correct possibilities, and even suggests near matches on Python 3.14+ (#2499)
 - 🛠 Only support one output from the repair step on linux like other platforms; auditwheel fixed this over four years ago! (#2478)
-- 🛠 We now use pattern matching extensively (#2434)
+- 💼 We now use pattern matching extensively (#2434)
 - 📚 We now have platform maintainers for our special platforms and interpreters! (#2481)
 
-
-
-### v3.0.1
-
-_5 July 2025_
-
-- 🛠 Updates CPython 3.14 prerelease to 3.14.0b3 (#2471)
-- ✨ Adds a CPython 3.14 prerelease iOS build (only when prerelease builds are [enabled](https://cibuildwheel.pypa.io/en/stable/options/#enable)) (#2475)
-
-<!-- [[[end]]] (sum: Fe+mD8YR4+) -->
+<!-- [[[end]]] (sum: loynkRqdzf) -->
 
 ---
 

cibuildwheel/__init__.py

@@ -1 +1 @@
-__version__ = "3.1.3"
+__version__ = "3.1.4"

docs/changelog.md

@@ -4,14 +4,32 @@ title: Changelog
 
 # Changelog
 
+### v3.1.4
+
+_19 August 2025_
+
+- ✨ Add a `--clean-cache` command to clean up our cache (#2489)
+- 🛠 Update Python to 3.14rc2 and other patch version bumps (#2542, #2556)
+- 🛠 Update Pyodide to 0.28.2 (#2562, #2558)
+- 🐛 Fix resolution with `pyodide-build` when `dependency-versions` is set (#2548)
+- 🐛 Set `CMAKE_FIND_ROOT_PATH_MODE_PACKAGE` to `BOTH` on Android (#2547)
+- 🐛 Add `patchelf` dependency for platforms that can build Android wheels (#2552)
+- 🐛 Ignore empty values for `CIBW_ARCHS` like most other environment variables (#2541)
+- 💼 The `color` and `suggest_on_error` argparse options are now default in 3.14rc1+ (#2554)
+- 💼 Use the virtualenv release URL instead of blob URL (should be more robust) (#2555)
+- 🧪 For iOS, lowering to macos-14 is needed for now due to issues with GitHub's runner images (#2557)
+- 🧪 Split out platforms iOS and Android in our tests (#2519)
+- 🧪 Fix and enable doctests (#2546)
+- 📚 Improve our docs on free-threading (#2549)
+
+
 ### v3.1.3
 
 _1 August 2025_
 
 - 🐛 Fix bug where "latest" dependencies couldn't update to pip 25.2 on Windows (#2537)
-- 🛠 Use pytest-rerunfailures to improve some of our iOS/Android tests (#2527, #2539)
-- 🛠 Remove some GraalPy Windows workarounds in our tests (#2501)
-
+- 🧪 Use pytest-rerunfailures to improve some of our iOS/Android tests (#2527, #2539)
+- 🧪 Remove some GraalPy Windows workarounds in our tests (#2501)
 
 
 ### v3.1.2
@@ -49,7 +67,7 @@ _23 July 2025_
 - 🛠 Fixed a typo in the 3.9 MUSL riscv64 identifier (`cp39-musllinux_ricv64` -> `cp39-musllinux_riscv64`) (#2490)
 - 🛠 Mistyping `--only` now shows the correct possibilities, and even suggests near matches on Python 3.14+ (#2499)
 - 🛠 Only support one output from the repair step on linux like other platforms; auditwheel fixed this over four years ago! (#2478)
-- 🛠 We now use pattern matching extensively (#2434)
+- 💼 We now use pattern matching extensively (#2434)
 - 📚 We now have platform maintainers for our special platforms and interpreters! (#2481)
 
 

docs/faq.md

@@ -110,7 +110,7 @@ There are two suggested methods for keeping cibuildwheel up to date that instead
 If you use GitHub Actions for builds, you can use cibuildwheel as an action:
 
 ```yaml
-uses: pypa/[email protected].3
+uses: pypa/[email protected].4
 ```
 
 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.
@@ -132,7 +132,7 @@ The second option, and the only one that supports other CI systems, is using a `
 
 ```bash
 # requirements-cibw.txt
-cibuildwheel==3.1.3
+cibuildwheel==3.1.4
 ```
 
 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:
@@ -297,7 +297,7 @@ Solutions to this vary, but the simplest is to use pipx:
 # most runners have pipx preinstalled, but in case you don't
 python3 -m pip install pipx
 
-pipx run cibuildwheel==3.1.3 --output-dir wheelhouse
+pipx run cibuildwheel==3.1.4 --output-dir wheelhouse
 pipx run twine upload wheelhouse/*.whl
 ```
 

examples/azure-pipelines-minimal.yml

@@ -6,7 +6,7 @@ jobs:
     - bash: |
         set -o errexit
         python3 -m pip install --upgrade pip
-        pip3 install cibuildwheel==3.1.3
+        pip3 install cibuildwheel==3.1.4
       displayName: Install dependencies
     - bash: cibuildwheel --output-dir wheelhouse .
       displayName: Build wheels
@@ -20,7 +20,7 @@ jobs:
     - bash: |
         set -o errexit
         python3 -m pip install --upgrade pip
-        python3 -m pip install cibuildwheel==3.1.3
+        python3 -m pip install cibuildwheel==3.1.4
       displayName: Install dependencies
     - bash: cibuildwheel --output-dir wheelhouse .
       displayName: Build wheels
@@ -34,7 +34,7 @@ jobs:
     - bash: |
         set -o errexit
         python -m pip install --upgrade pip
-        pip install cibuildwheel==3.1.3
+        pip install cibuildwheel==3.1.4
       displayName: Install dependencies
     - bash: cibuildwheel --output-dir wheelhouse .
       displayName: Build wheels

examples/circleci-minimal.yml

@@ -11,7 +11,7 @@ jobs:
       - run:
           name: Build the Linux wheels.
           command: |
-            python3 -m pip install --user cibuildwheel==3.1.3
+            python3 -m pip install --user cibuildwheel==3.1.4
             cibuildwheel --output-dir wheelhouse
       - store_artifacts:
           path: wheelhouse/
@@ -28,7 +28,7 @@ jobs:
       - run:
           name: Build the Linux aarch64 wheels.
           command: |
-            python3 -m pip install --user cibuildwheel==3.1.3
+            python3 -m pip install --user cibuildwheel==3.1.4
             python3 -m cibuildwheel --output-dir wheelhouse
       - store_artifacts:
           path: wheelhouse/
@@ -44,7 +44,7 @@ jobs:
           name: Build the OS X wheels.
           command: |
             sudo softwareupdate --install-rosetta --agree-to-license  # for python<=3.8 or x86_64/universal2 tests
-            pip3 install cibuildwheel==3.1.3
+            pip3 install cibuildwheel==3.1.4
             cibuildwheel --output-dir wheelhouse
       - store_artifacts:
           path: wheelhouse/

examples/cirrus-ci-intel-mac.yml

@@ -1,6 +1,6 @@
 build_and_store_wheels: &BUILD_AND_STORE_WHEELS
   install_cibuildwheel_script:
-    - python -m pip install cibuildwheel==3.1.3
+    - python -m pip install cibuildwheel==3.1.4
   run_cibuildwheel_script:
     - cibuildwheel
   wheels_artifacts:

examples/cirrus-ci-minimal.yml

@@ -1,6 +1,6 @@
 build_and_store_wheels: &BUILD_AND_STORE_WHEELS
   install_cibuildwheel_script:
-    - python -m pip install cibuildwheel==3.1.3
+    - python -m pip install cibuildwheel==3.1.4
   run_cibuildwheel_script:
     - cibuildwheel
   wheels_artifacts:

examples/github-deploy.yml

@@ -61,7 +61,7 @@ jobs:
           sudo udevadm trigger --name-match=kvm
 
       - name: Build wheels
-        uses: pypa/[email protected].3
+        uses: pypa/[email protected].4
         env:
           CIBW_PLATFORM: ${{ matrix.platform || 'auto' }}
         # Can also be configured directly, using `with:`

examples/github-minimal.yml

@@ -15,7 +15,7 @@ jobs:
       - uses: actions/checkout@v5
 
       - name: Build wheels
-        uses: pypa/[email protected].3
+        uses: pypa/[email protected].4
         # env:
         #   CIBW_SOME_OPTION: value
         #   ...