Bump version: v3.1.1

Update platforms.md

Fixed typo

README.md

@@ -97,7 +97,7 @@ jobs:
       - uses: actions/setup-python@v5
 
       - name: Install cibuildwheel
-        run: python -m pip install cibuildwheel==3.1.0
+        run: python -m pip install cibuildwheel==3.1.1
 
       - name: Build wheels
         run: python -m cibuildwheel --output-dir wheelhouse
@@ -227,6 +227,13 @@ Changelog
 
 <!-- [[[cog from readme_changelog import mini_changelog; print(mini_changelog()) ]]] -->
 
+### v3.1.1
+
+_24 July 2025_
+
+- 🐛 Fix a bug showing an incorrect wheel count at the end of execution, and misrepresenting test-only runs in the GitHub Action summary (#2512)
+- 📚 Docs fix (#2510)
+
 ### v3.1.0
 
 _23 July 2025_
@@ -297,14 +304,7 @@ _26 April 2025_
 
 - 🛠 Dependency updates, including Python 3.13.3 (#2371)
 
-### v2.23.2
-
-_24 March 2025_
-
-- 🐛 Workaround an issue with pyodide builds when running cibuildwheel with a Python that was installed via UV (#2328 via #2331)
-- 🛠 Dependency updates, including a manylinux update that fixes an ['undefined symbol' error](https://github.com/pypa/manylinux/issues/1760) in gcc-toolset (#2334)
-
-<!-- [[[end]]] (sum: HkLT9ZhhtV) -->
+<!-- [[[end]]] (sum: K97aJ+f0EX) -->
 
 ---
 

cibuildwheel/__init__.py

@@ -1 +1 @@
-__version__ = "3.1.0"
+__version__ = "3.1.1"

cibuildwheel/logger.py

@@ -242,11 +242,11 @@ class Logger:
             github_summary = self._github_step_summary(duration=duration, options=options)
             Path(summary_path).write_text(filter_ansi_codes(github_summary), encoding="utf-8")
 
-        n = len(self.summary)
-        s = "s" if n > 1 else ""
+        n_wheels = len([info for info in self.summary if not info.filename])
+        s = "s" if n_wheels > 1 else ""
         duration_str = humanize.naturaldelta(duration)
         print()
-        self._start_fold_group(f"{n} wheel{s} produced in {duration_str}")
+        self._start_fold_group(f"{n_wheels} wheel{s} produced in {duration_str}")
         for build_info in self.summary:
             print(" ", build_info)
         self._end_fold_group()
@@ -320,7 +320,7 @@ class Logger:
         n_wheels = len([b for b in self.summary if b.filename])
         wheel_rows = "\n".join(
             "<tr>"
-            f"<td nowrap>{'<samp>' + b.filename.name + '</samp>' if b.filename else '*Build only*'}</td>"
+            f"<td nowrap>{'<samp>' + b.filename.name + '</samp>' if b.filename else '*Test only*'}</td>"
             f"<td nowrap>{b.size or 'N/A'}</td>"
             f"<td nowrap><samp>{b.identifier}</samp></td>"
             f"<td nowrap>{humanize.naturaldelta(b.duration)}</td>"

docs/changelog.md

@@ -4,6 +4,13 @@ title: Changelog
 
 # Changelog
 
+### v3.1.1
+
+_24 July 2025_
+
+- 🐛 Fix a bug showing an incorrect wheel count at the end of execution, and misrepresenting test-only runs in the GitHub Action summary (#2512)
+- 📚 Docs fix (#2510)
+
 ### v3.1.0
 
 _23 July 2025_

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/cibuildwheel@v3.1.0
+uses: pypa/cibuildwheel@v3.1.1
 ```
 
 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.0
+cibuildwheel==3.1.1
 ```
 
 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.0 --output-dir wheelhouse
+pipx run cibuildwheel==3.1.1 --output-dir wheelhouse
 pipx run twine upload wheelhouse/*.whl
 ```
 

docs/platforms.md

@@ -265,7 +265,7 @@ iOS is effectively 2 platforms - physical devices, and simulators. While the API
 
 * `arm64_iphoneos` (for physical iOS devices);
 * `arm64_iphonesimulator` (for iOS simulators running on Apple Silicon macOS machines); and
-* `x64_64_iphonesimulator` (for iOS simulators running on Intel macOS machines).
+* `x86_64_iphonesimulator` (for iOS simulators running on Intel macOS machines).
 
 By default, cibuildwheel will build all wheels for the CPU architecture of the build machine. You can build all wheels for all architectures by specifying `--archs all`.
 

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.0
+        pip3 install cibuildwheel==3.1.1
       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.0
+        python3 -m pip install cibuildwheel==3.1.1
       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.0
+        pip install cibuildwheel==3.1.1
       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.0
+            python3 -m pip install --user cibuildwheel==3.1.1
             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.0
+            python3 -m pip install --user cibuildwheel==3.1.1
             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.0
+            pip3 install cibuildwheel==3.1.1
             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.0
+    - python -m pip install cibuildwheel==3.1.1
   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.0
+    - python -m pip install cibuildwheel==3.1.1
   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/cibuildwheel@v3.1.0
+        uses: pypa/cibuildwheel@v3.1.1
         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@v4
 
       - name: Build wheels
-        uses: pypa/cibuildwheel@v3.1.0
+        uses: pypa/cibuildwheel@v3.1.1
         # env:
         #   CIBW_SOME_OPTION: value
         #   ...

examples/github-pipx.yml

@@ -15,7 +15,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Build wheels
-        run: pipx run cibuildwheel==3.1.0
+        run: pipx run cibuildwheel==3.1.1
 
       - uses: actions/upload-artifact@v4
         with:

examples/github-with-qemu.yml

@@ -21,7 +21,7 @@ jobs:
           platforms: all
 
       - name: Build wheels
-        uses: pypa/cibuildwheel@v3.1.0
+        uses: pypa/cibuildwheel@v3.1.1
         env:
           # configure cibuildwheel on Linux to build native archs ('auto'),
           # and to split the remaining architectures between the x86_64 and

examples/gitlab-minimal.yml

@@ -12,7 +12,7 @@ linux:
     DOCKER_TLS_CERTDIR: ""
   script:
     - curl -sSL https://get.docker.com/ | sh
-    - python -m pip install cibuildwheel==3.1.0
+    - python -m pip install cibuildwheel==3.1.1
     - cibuildwheel --output-dir wheelhouse
   artifacts:
     paths:
@@ -23,7 +23,7 @@ windows:
   before_script:
     - choco install python -y --allow-downgrade --version 3.12.4
     - choco install git.install -y
-    - py -m pip install cibuildwheel==3.1.0
+    - py -m pip install cibuildwheel==3.1.1
   script:
     - py -m cibuildwheel --output-dir wheelhouse --platform windows
   artifacts:
@@ -35,7 +35,7 @@ windows:
 macos:
   image: macos-14-xcode-15
   before_script:
-    - python3 -m pip install cibuildwheel==3.1.0
+    - python3 -m pip install cibuildwheel==3.1.1
   script:
     - python3 -m cibuildwheel --output-dir wheelhouse
   artifacts:

examples/gitlab-with-qemu.yml

@@ -14,7 +14,7 @@ linux:
     - curl -sSL https://get.docker.com/ | sh
     # Warning: This is extremely slow, be careful with how many wheels you build
     - docker run --rm --privileged multiarch/qemu-user-static --reset -p yes
-    - python -m pip install cibuildwheel==3.1.0
+    - python -m pip install cibuildwheel==3.1.1
     # Assuming your CI runner's default architecture is x86_64...
     - cibuildwheel --output-dir wheelhouse --platform linux --archs aarch64
   artifacts:

examples/travis-ci-deploy.yml

@@ -20,7 +20,7 @@ jobs:
         - ln -s /c/Python312/python.exe /c/Python312/python3.exe
 
 install:
-  - python3 -m pip install cibuildwheel==3.1.0
+  - python3 -m pip install cibuildwheel==3.1.1
 
 script:
   # build the wheels, put them into './dist'

examples/travis-ci-minimal.yml

@@ -26,7 +26,7 @@ jobs:
         - ln -s /c/Python312/python.exe /c/Python312/python3.exe
 
 install:
-  - python3 -m pip install cibuildwheel==3.1.0
+  - python3 -m pip install cibuildwheel==3.1.1
 
 script:
   # build the wheels, put them into './wheelhouse'

examples/travis-ci-test-and-deploy.yml

@@ -52,7 +52,7 @@ jobs:
     - stage: deploy
       name: Build and deploy Linux wheels
       services: docker
-      install: python3 -m pip install cibuildwheel==3.1.0 twine
+      install: python3 -m pip install cibuildwheel==3.1.1 twine
       script: python3 -m cibuildwheel --output-dir wheelhouse
       after_success: python3 -m twine upload --skip-existing wheelhouse/*.whl
     # Deploy on windows
@@ -60,7 +60,7 @@ jobs:
       name: Build and deploy Windows wheels
       os: windows
       language: shell
-      install: python3 -m pip install cibuildwheel==3.1.0 twine
+      install: python3 -m pip install cibuildwheel==3.1.1 twine
       script: python3 -m cibuildwheel --output-dir wheelhouse
       after_success: python3 -m twine upload --skip-existing wheelhouse/*.whl
 

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "cibuildwheel"
-version = "3.1.0"
+version = "3.1.1"
 description = "Build Python wheels on CI with minimal configuration."
 readme = "README.md"
 license = "BSD-2-Clause"

unit_test/wheel_print_test.py

@@ -25,7 +25,7 @@ def test_printout_wheels(capsys):
 
     assert "id1" in captured.out
     assert "id2" in captured.out
-    assert "wheels produced in" in captured.out
+    assert "1 wheel produced in" in captured.out
     assert "SHA256=" in captured.out