Bump version: v2.12.2

Merge pull request #1476 from henryiii/henryiii/chore/ruff_ex
chore: ruff and typing updates
2023-04-18 21:11:25 +01:00 · 2023-04-18 20:58:15 +01:00 · 2023-04-18 13:06:17 -04:00 · 2023-04-18 12:38:21 -04:00 · 2023-04-18 12:01:08 -04:00 · 2023-04-18 12:00:35 -04:00
88 changed files with 1254 additions and 937 deletions
@@ -34,7 +34,7 @@ jobs:
        name: artifact
        path: dist

-    - uses: pypa/gh-action-pypi-publish@v1.5.1
+    - uses: pypa/gh-action-pypi-publish@v1.8.5
      with:
        user: __token__
        password: ${{ secrets.pypi_password }}
@@ -37,7 +37,7 @@ jobs:
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
-        os: [ubuntu-18.04, windows-latest, macos-11]
+        os: [ubuntu-20.04, windows-latest, macos-11]
        python_version: ['3.11']
    timeout-minutes: 180
    steps:
@@ -56,7 +56,6 @@ jobs:
        echo "deb https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/xUbuntu_${VERSION_ID}/ /" | sudo tee /etc/apt/sources.list.d/devel:kubic:libcontainers:stable.list
        curl -sSfL "https://download.opensuse.org/repositories/devel:/kubic:/libcontainers:/stable/xUbuntu_${VERSION_ID}/Release.key" | sudo apt-key add -
        sudo apt-get update
-        sudo apt-get -y upgrade
        sudo apt-get -y install podman

    - name: Install dependencies
@@ -18,13 +18,13 @@ jobs:
  update-dependencies:
    name: Update dependencies
    if: github.repository_owner == 'pypa' || github.event_name != 'schedule'
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-20.04
    steps:
    - uses: actions/checkout@v3

-    - uses: wntrblm/nox@2022.8.7
+    - uses: wntrblm/nox@2022.11.21
      with:
-        python-versions: "3.6, 3.7, 3.8, 3.9, 3.10, 3.11-dev"
+        python-versions: "3.6, 3.7, 3.8, 3.9, 3.10, 3.11"

    - name: "Run update: dependencies"
      run: nox --force-color -s update_constraints
@@ -44,7 +44,7 @@ jobs:

    - name: Create Pull Request
      if: github.ref == 'refs/heads/main' && github.repository == 'pypa/cibuildwheel'
-      uses: peter-evans/create-pull-request@v4
+      uses: peter-evans/create-pull-request@v5
      with:
        commit-message: Update dependencies
        title: '[Bot] Update dependencies'
@@ -26,7 +26,6 @@ windows:
    - choco install python -y --version 3.8.6
  script:
    - py -m pip install -e ".[dev]" pytest-custom-exit-code
-    - py -m cibuildwheel --output-dir wheelhouse --platform windows
    - py bin\run_tests.py
  tags:
    - windows
@@ -1,7 +1,7 @@
 repos:

 - repo: https://github.com/pre-commit/pre-commit-hooks
-  rev: v4.3.0
+  rev: v4.4.0
  hooks:
  - id: check-case-conflict
  - id: check-merge-conflict
@@ -13,41 +13,25 @@ repos:
  - id: mixed-line-ending
  - id: trailing-whitespace

- repo: https://github.com/asottile/pyupgrade
-  rev: v3.1.0
-  hooks:
-  - id: pyupgrade
-    args: ["--py37-plus"]
-    exclude: ^cibuildwheel/resources/.*py$
-
-# Autoremoves unused imports
- repo: https://github.com/hadialqattan/pycln
-  rev: v2.1.1
-  hooks:
-  - id: pycln
-    args: [--all]
-    stages: [manual]
-
- repo: https://github.com/PyCQA/isort
-  rev: 5.10.1
-  hooks:
-  - id: isort
-    args: ["-a", "from __future__ import annotations"]
-    exclude: ^cibuildwheel/resources/.*py$
-
 - repo: https://github.com/psf/black
-  rev: 22.10.0
+  rev: 23.3.0
  hooks:
  - id: black

+- repo: https://github.com/charliermarsh/ruff-pre-commit
+  rev: v0.0.261
+  hooks:
+  - id: ruff
+    args: ["--fix", "--show-fixes"]
+
 - repo: https://github.com/asottile/setup-cfg-fmt
-  rev: v2.1.0
+  rev: v2.2.0
  hooks:
  - id: setup-cfg-fmt
    args: [--include-version-classifiers, --max-py-version=3.11]

 - repo: https://github.com/pre-commit/mirrors-mypy
-  rev: v0.982
+  rev: v1.2.0
  hooks:
  - id: mypy
    name: mypy 3.7 on cibuildwheel/
@@ -55,49 +39,25 @@ repos:
    args: ["--python-version=3.7"]
    additional_dependencies: &mypy-dependencies
      - nox
-      - packaging>=21.0
+      - packaging~=21.0
      - pygithub
      - rich
      - tomli
      - tomli_w
      - types-certifi
      - types-click
-      - types-dataclasses
      - types-jinja2
      - types-pyyaml
      - types-requests
      - bracex
-      - dataclasses
  - id: mypy
-    name: mypy 3.10
-    args: ["--python-version=3.10"]
+    name: mypy 3.11
+    exclude: ^cibuildwheel/resources/.*py$
+    args: ["--python-version=3.11"]
    additional_dependencies: *mypy-dependencies

- repo: https://github.com/asottile/yesqa
-  rev: v1.4.0
-  hooks:
-  - id: yesqa
-    additional_dependencies: &flake8-dependencies
-    - flake8-bugbear
-
- repo: https://github.com/PyCQA/flake8
-  rev: 5.0.4
-  hooks:
-  - id: flake8
-    exclude: ^cibuildwheel/resources/
-    additional_dependencies: *flake8-dependencies
-
- repo: https://github.com/pre-commit/pygrep-hooks
-  rev: v1.9.0
-  hooks:
-  - id: python-check-blanket-noqa
-    stages: [manual]
-  - id: python-no-log-warn
-  - id: python-no-eval
-  - id: python-use-type-annotations
-
 - repo: https://github.com/shellcheck-py/shellcheck-py
-  rev: v0.8.0.4
+  rev: v0.9.0.2
  hooks:
  - id: shellcheck

@@ -117,7 +77,7 @@ repos:
    files: ^docs/changelog.md$

 - repo: https://github.com/codespell-project/codespell
-  rev: v2.2.2
+  rev: v2.2.4
  hooks:
  - id: codespell
    args: ["-L", "sur"]
@@ -1,11 +1,11 @@
 This is a summary of the Python versions and platforms covered by the different CI platforms:

-|         | 3.7                   | 3.8                      | 3.9      | 3.10      | 3.11           |
-|---------|-----------------------|--------------------------|----------|-----------|----------------|
-| Linux   | AppVeyor¹ / Travis CI | Azure Pipelines / GitLab | CircleCI | Cirrus CI | GitHub Actions |
-| macOS   | AppVeyor¹ / Travis CI | Azure Pipelines          | CircleCI | Cirrus CI | GitHub Actions |
-| Windows | AppVeyor¹ / Travis CI | Azure Pipelines          |          | Cirrus CI | GitHub Actions |
+|         | 3.7       | 3.8                                   | 3.9       | 3.10      | 3.11           |
+|---------|-----------|---------------------------------------|-----------|-----------|----------------|
+| Linux   | Travis CI | AppVeyor¹ / Azure Pipelines / GitLab¹ | CircleCI¹ | Cirrus CI | GitHub Actions |
+| macOS   | Travis CI | AppVeyor¹ / Azure Pipelines           | CircleCI¹ | Cirrus CI | GitHub Actions |
+| Windows | Travis CI | AppVeyor¹ / Azure Pipelines / GitLab¹ |           | Cirrus CI | GitHub Actions |

-> ¹ AppVeyor only runs the "basic" test to reduce load.
+> ¹ Runs a reduced set of tests to reduce CI load

 Non-x86 architectures are covered on Travis CI using Python 3.7.
@@ -32,12 +32,13 @@ What does it do?
 | CPython 3.10  | ✅ | ✅  | ✅  | ✅  | ✅² | ✅ | ✅  | ✅ | ✅  | ✅  |
 | CPython 3.11  | ✅ | ✅  | ✅  | ✅  | ✅² | ✅ | ✅  | ✅ | ✅  | ✅  |
 | PyPy 3.7 v7.3 | ✅ | N/A | ✅  | N/A | N/A | ✅¹ | ✅¹  | ✅¹ | N/A | N/A |
-| PyPy 3.8 v7.3 | ✅ | N/A | ✅  | N/A | N/A | ✅¹ | ✅¹  | ✅¹ | N/A | N/A |
-| PyPy 3.9 v7.3 | ✅ | N/A | ✅  | N/A | N/A | ✅¹ | ✅¹  | ✅¹ | N/A | N/A |
+| PyPy 3.8 v7.3 | ✅ | ✅⁴ | ✅  | N/A | N/A | ✅¹ | ✅¹  | ✅¹ | N/A | N/A |
+| PyPy 3.9 v7.3 | ✅ | ✅⁴ | ✅  | N/A | N/A | ✅¹ | ✅¹  | ✅¹ | N/A | N/A |

 <sup>¹ PyPy is only supported for manylinux wheels.</sup><br>
 <sup>² Windows arm64 support is experimental.</sup><br>
 <sup>³ Alpine 3.14 and very briefly 3.15's default python3 [was not able to load](https://github.com/pypa/cibuildwheel/issues/934) musllinux wheels. This has been fixed; please upgrade the python package if using Alpine from before the fix.</sup><br>
+<sup>⁴ Cross-compilation not supported with PyPy - to build these wheels you need to run cibuildwheel on an Apple Silicon machine.</sup><br>

 - Builds manylinux, musllinux, macOS 10.9+, and Windows wheels for CPython and PyPy
 - Works on GitHub Actions, Azure Pipelines, Travis CI, AppVeyor, CircleCI, GitLab CI, and Cirrus CI
@@ -93,7 +94,7 @@ jobs:
      - uses: actions/setup-python@v3

      - name: Install cibuildwheel
-        run: python -m pip install cibuildwheel==2.11.2
+        run: python -m pip install cibuildwheel==2.12.2

      - name: Build wheels
        run: python -m cibuildwheel --output-dir wheelhouse
@@ -158,25 +159,25 @@ Here are some repos that use cibuildwheel.
 |-----------------------------------|----|----|:------|
 | [scikit-learn][]                  | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | The machine learning library. A complex but clean config using many of cibuildwheel's features to build a large project with Cython and C++ extensions.  |
 | [NumPy][]                         | ![github icon][] ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | The fundamental package for scientific computing with Python. |
-| [Tornado][]                       | ![travisci icon][] | ![apple icon][] ![linux icon][] | Tornado is a Python web framework and asynchronous networking library, originally developed at FriendFeed. |
 | [pytorch-fairseq][]               | ![github icon][] | ![apple icon][] ![linux icon][] | Facebook AI Research Sequence-to-Sequence Toolkit written in Python. |
+| [Tornado][]                       | ![travisci icon][] | ![apple icon][] ![linux icon][] | Tornado is a Python web framework and asynchronous networking library, originally developed at FriendFeed. |
 | [Matplotlib][]                    | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | The venerable Matplotlib, a Python library with C++ portions |
 | [NCNN][]                          | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | ncnn is a high-performance neural network inference framework optimized for the mobile platform |
 | [Kivy][]                          | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Open source UI framework written in Python, running on Windows, Linux, macOS, Android and iOS |
 | [Prophet][]                       | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Tool for producing high quality forecasts for time series data that has multiple seasonality with linear or non-linear growth. |
 | [MyPy][]                          | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | The compiled version of MyPy using MyPyC. |
-| [pydantic][]                      | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Data parsing and validation using Python type hints |
+| [MemRay][]                        | ![github icon][] | ![linux icon][] | Memray is a memory profiler for Python |

 [scikit-learn]: https://github.com/scikit-learn/scikit-learn
 [NumPy]: https://github.com/numpy/numpy
-[Tornado]: https://github.com/tornadoweb/tornado
 [pytorch-fairseq]: https://github.com/pytorch/fairseq
+[Tornado]: https://github.com/tornadoweb/tornado
 [Matplotlib]: https://github.com/matplotlib/matplotlib
 [NCNN]: https://github.com/Tencent/ncnn
 [Kivy]: https://github.com/kivy/kivy
 [Prophet]: https://github.com/facebook/prophet
 [MyPy]: https://github.com/mypyc/mypy_mypyc-wheels
-[pydantic]: https://github.com/samuelcolvin/pydantic
+[MemRay]: https://github.com/bloomberg/memray

 [appveyor icon]: docs/data/readme_icons/appveyor.svg
 [github icon]: docs/data/readme_icons/github.svg
@@ -209,50 +210,43 @@ Changelog

 <!-- this section was generated by bin/update_readme_changelog.py -- do not edit manually -->

-### v2.11.2
+### v2.12.2

-_26 October 2022_
+_18 April 2023_

- 🛠 Updates CPython 3.11 to 3.11.0 - final release (#1327)
- 🛠 Simplify the default macOS repair command (#1322)
- 🛠 Fix the default `MACOSX_DEPLOYMENT_TARGET` on arm64 (#1312)
- 🛠 Hide irrelevant pip warnings on linux (#1311)
- 🐛 Fix a bug that caused the stdout and stderr of commands in containers to be in the wrong order Previously, stdout could appear after stderr. (#1324)
- 📚 Added [a FAQ entry](https://cibuildwheel.readthedocs.io/en/stable/faq/#macos-building-cpython-38-wheels-on-arm64) describing how to perform native builds of CPython 3.8 wheels on Apple Silicon. (#1323)
- 📚 Other docs improvements
+- 🐛 Fix a bug that caused an extra empty config-setting to be passed to the backend when CIBW_BUILD_FRONTEND is set to `build`. (#1474)
+- 🐛 Fix a crash that occurred when overwriting an existing wheel on Windows. (#1464)
+- 🛠 Pinned version updates, including CPython 3.10.11, 3.11.3, pip 23.1 and wheel 0.40.0.

-### v2.11.1
+### v2.12.1

-_13 October 2022_
+_11 March 2023_

- 🛠 Updates to the latest manylinux images, and updates CPython 3.10 to 3.10.8.
+- 🐛 Fix a bug that prevented the use of CIBW_CONFIG_SETTINGS with the 'pip' build backend. (#1430)

-### v2.11.0
+### v2.12.0

-_13 October 2022_
+_16 Jan 2023_

- 🌟 Adds support for cross-compiling Windows ARM64 wheels. To use this feature, add `ARM64` to the [CIBW_ARCHS](https://cibuildwheel.readthedocs.io/en/stable/options/#archs) option on a Windows Intel runner. (#1144)
- ✨ Adds support for building Linux aarch64 wheels on Circle CI. (#1307)
- ✨ Adds support for building Windows wheels on Gitlab CI. (#1295)
- ✨ Adds support for building Linux aarch64 wheels under emulation on Gitlab CI. (#1295)
- ✨ Adds the ability to test `cp38-macosx_arm64` wheels on a native arm64 runner. To do this, you'll need to preinstall the (experimental) [universal2 version of CPython 3.8](https://www.python.org/ftp/python/3.8.10/python-3.8.10-macos11.pkg) on your arm64 runner before invoking cibuildwheel. Note: it is not recommended to build x86_64 wheels with this setup, your wheels will have limited compatibility wrt macOS versions. (#1283)
- 🛠 Improved error messages when using custom Docker images and Python cannot be found at the correct path. (#1298)
- 📚 Sample configs for Azure Pipelines and Travis CI updated (#1296)
- 📚 Other docs improvements - including more information about using Homebrew for build dependencies (#1290)
+- ✨ Adds support for PyPy arm64 wheels. This means that you can build PyPy wheels for Apple Silicon machines. Cross-compilation is not supported for these wheels, so you'll have to build on an Apple Silicon machine. (#1372)
+- 🛠 Pinned version updates, including PyPy to v7.3.11 and setuptools to 66.0.0.

-### v2.10.2
+### v2.11.4

-_25 September 2022_
+_24 Dec 2022_

- 🐛 Fix a bug that caused `win32` identifiers to fail when used with `--only`. (#1282)
- 🐛 Fix computation of `auto`/`auto64`/`auto32` archs when targeting a different platform to the one that you're running cibuildwheel on. (#1266)
- 📚 Fix an mistake in the 'how it works' diagram. (#1274)
+- 🐛 Fix a bug that caused missing wheels on Windows when a test was skipped using CIBW_TEST_SKIP (#1377)
+- 🛠 Updates CPython 3.11 to 3.11.1 (#1371)
+- 🛠 Updates PyPy to 7.3.10, except on macOS which remains on 7.3.9 due to a bug on that platform. (#1371)
+- 📚 Added a reference to abi3audit to the docs (#1347)

-### v2.10.1
+### v2.11.3

-_18 September 2022_
+_5 Dec 2022_

- 🐛 Fix a bug that stopped environment variables specified in TOML from being expanded. (#1273)
+- ✨ Improves the 'build options' log output that's printed at the start of each run (#1352)
+- ✨ Added a friendly error message to a common misconfiguration of the `CIBW_TEST_COMMAND` option - not specifying path using the `{project}` placeholder (#1336)
+- 🛠 The GitHub Action now uses Powershell on Windows to avoid occasional incompabilities with bash (#1346)

 <!-- END bin/update_readme_changelog.py -->

@@ -37,9 +37,23 @@ runs:
        --python '${{ steps.python.outputs.python-path }}'
        --spec '${{ github.action_path }}'
        cibuildwheel
-        ${{ inputs.package-dir }}
-        --output-dir ${{ inputs.output-dir }}
+        "${{ inputs.package-dir }}"
+        --output-dir "${{ inputs.output-dir }}"
        --config-file "${{ inputs.config-file }}"
        --only "${{ inputs.only }}"
        2>&1
      shell: bash
+      if: runner.os != 'Windows'
+
+    # Windows needs powershell to interact nicely with Meson
+    - run: >
+        pipx run
+        --python "${{ steps.python.outputs.python-path }}"
+        --spec "${{ github.action_path }}"
+        cibuildwheel
+        "${{ inputs.package-dir }}"
+        --output-dir '"${{ inputs.output-dir }}"'
+        --config-file '"${{ inputs.config-file }}"'
+        --only '"${{ inputs.only }}"'
+      shell: pwsh
+      if: runner.os == 'Windows'
@@ -1,18 +1,18 @@
 environment:
  matrix:
    - APPVEYOR_BUILD_WORKER_IMAGE: Ubuntu
-      APPVEYOR_JOB_NAME: "python37-x64-ubuntu"
+      APPVEYOR_JOB_NAME: "python38-x64-ubuntu"
    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
-      APPVEYOR_JOB_NAME: "python37-x64-vs2015"
-    - APPVEYOR_BUILD_WORKER_IMAGE: macos-mojave
-      APPVEYOR_JOB_NAME: "python37-x64-macos-mojave"
+      APPVEYOR_JOB_NAME: "python38-x64-vs2015"
+    - APPVEYOR_BUILD_WORKER_IMAGE: macos
+      APPVEYOR_JOB_NAME: "python38-x64-macos"

-stack: python 3.7
+stack: python 3.8

 build: off

 init:
- cmd: set PATH=C:\Python37;C:\Python37\Scripts;%PATH%
+- cmd: set PATH=C:\Python38;C:\Python38\Scripts;%PATH%
 - ps: |
      $BRANCH = if ($env:APPVEYOR_PULL_REQUEST_HEAD_REPO_BRANCH) { $env:APPVEYOR_PULL_REQUEST_HEAD_REPO_BRANCH } else { $env:APPVEYOR_REPO_BRANCH }
      if (-not ($BRANCH -eq 'main' -or $BRANCH.ToLower().StartsWith('appveyor-'))) {
@@ -68,7 +68,7 @@ def bump_version() -> None:
        sys.exit(1)

    # fmt: off
-    print(              'Current version:', current_version)  # noqa: E201 whitespace
+    print(              'Current version:', current_version)
    new_version = input('    New version: ').strip()
    # fmt: on

@@ -15,8 +15,8 @@ the results without the `--online` setting.
 from __future__ import annotations

 import ast
+from collections.abc import Iterable, Iterator
 from pathlib import Path
-from typing import Iterator

 import click
 import yaml
@@ -97,7 +97,7 @@ class MaybeRemote:
        with open(filename, "w") as f:
            yaml.safe_dump(self.contents, f, default_flow_style=False)

-    def on_each(self, repos: list[str]) -> Iterator[tuple[str, str, str | None]]:
+    def on_each(self, repos: Iterable[str]) -> Iterator[tuple[str, str, str | None]]:
        for repo in repos:
            print(f"[bold]{repo}:")
            for filename in sorted(self.contents, reverse=True):
@@ -16,6 +16,7 @@ import functools
 import textwrap
 import urllib.request
 import xml.dom.minidom
+from collections.abc import Iterable, Mapping, Sequence
 from datetime import datetime
 from io import StringIO
 from pathlib import Path
@@ -42,7 +43,7 @@ ICONS = (
 class Project:
    NAME: int = 0

-    def __init__(self, config: dict[str, Any], github: Github | None = None):
+    def __init__(self, config: Mapping[str, Any], github: Github | None = None):
        try:
            self.name: str = config["name"]
            self.gh: str = config["gh"]
@@ -149,7 +150,7 @@ def path_for_icon(icon_name: str, relative_to: Path | None = None) -> Path:


 def get_projects(
-    config: list[dict[str, Any]],
+    config: Iterable[Mapping[str, Any]],
    *,
    online: bool = True,
    auth: str | None = None,
@@ -163,7 +164,7 @@ def get_projects(
    return sorted((Project(item, github) for item in config), reverse=online)


-def render_projects(projects: list[Project], *, dest_path: Path, include_info: bool = True):
+def render_projects(projects: Sequence[Project], *, dest_path: Path, include_info: bool = True):
    io = StringIO()
    print = functools.partial(builtins.print, file=io)

@@ -191,7 +192,7 @@ def render_projects(projects: list[Project], *, dest_path: Path, include_info: b
 def insert_projects_table(
    file: Path,
    *,
-    projects: list[Project],
+    projects: Sequence[Project],
    input_filename: str,
    include_info: bool = True,
 ):
@@ -243,7 +244,7 @@ def projects(
            README_FILE, projects=projects[:10], input_filename=input.name, include_info=False
        )
        insert_projects_table(
-            DOCS_PAGE, projects=projects, input_filename=input.name, include_info=True
+            DOCS_PAGE, projects=projects, input_filename=input.name, include_info=False
        )


@@ -6,6 +6,7 @@ import copy
 import difflib
 import logging
 import sys
+from collections.abc import Mapping, MutableMapping
 from pathlib import Path
 from typing import Any, Union

@@ -65,7 +66,6 @@ AnyConfig = Union[ConfigWinCP, ConfigWinPP, ConfigMacOS]

 class WindowsVersions:
    def __init__(self, arch_str: ArchStr) -> None:
-
        response = requests.get("https://api.nuget.org/v3/index.json")
        response.raise_for_status()
        api_info = response.json()
@@ -88,14 +88,13 @@ class WindowsVersions:
        self.version_dict = {Version(v): v for v in cp_info["versions"]}

    def update_version_windows(self, spec: Specifier) -> ConfigWinCP | None:
-
        # Specifier.filter selects all non pre-releases that match the spec,
        # unless there are only pre-releases, then it selects pre-releases
        # instead (like pip)
        unsorted_versions = spec.filter(self.version_dict)
        versions = sorted(unsorted_versions, reverse=True)

-        log.debug(f"Windows {self.arch} {spec} has {', '.join(str(v) for v in versions)}")
+        log.debug("Windows %s %s has %s", self.arch, spec, ", ".join(str(v) for v in versions))

        if not versions:
            return None
@@ -111,7 +110,6 @@ class WindowsVersions:

 class PyPyVersions:
    def __init__(self, arch_str: ArchStr):
-
        response = requests.get("https://downloads.python.org/pypy/versions.json")
        response.raise_for_status()

@@ -127,7 +125,7 @@ class PyPyVersions:
        ]
        self.arch = arch_str

-    def get_arch_file(self, release: dict[str, Any]) -> str:
+    def get_arch_file(self, release: Mapping[str, Any]) -> str:
        urls: list[str] = [
            rf["download_url"]
            for rf in release["files"]
@@ -159,8 +157,8 @@ class PyPyVersions:
        )

    def update_version_macos(self, spec: Specifier) -> ConfigMacOS:
-        if self.arch != "64":
-            msg = "Other archs not supported yet on macOS"
+        if self.arch not in {"64", "ARM64"}:
+            msg = f"'{self.arch}' arch not supported yet on macOS"
            raise RuntimeError(msg)

        releases = [r for r in self.releases if spec.contains(r["python_version"])]
@@ -172,12 +170,14 @@ class PyPyVersions:

        release = releases[-1]
        version = release["python_version"]
-        identifier = f"pp{version.major}{version.minor}-macosx_x86_64"
+        arch = "x86_64" if self.arch == "64" else self.arch.lower()
+        identifier = f"pp{version.major}{version.minor}-macosx_{arch}"

+        arch = "x64" if self.arch == "64" else self.arch.lower()
        (url,) = (
            rf["download_url"]
            for rf in release["files"]
-            if "" in rf["platform"] == "darwin" and rf["arch"] == "x64"
+            if "" in rf["platform"] == "darwin" and rf["arch"] == arch
        )

        return ConfigMacOS(
@@ -189,7 +189,6 @@ class PyPyVersions:

 class CPythonVersions:
    def __init__(self) -> None:
-
        response = requests.get(
            "https://www.python.org/api/v2/downloads/release/?is_published=true"
        )
@@ -208,7 +207,6 @@ class CPythonVersions:
    def update_version_macos(
        self, identifier: str, version: Version, spec: Specifier
    ) -> ConfigMacOS | None:
-
        # see note above on Specifier.filter
        unsorted_versions = spec.filter(self.versions_dict)
        sorted_versions = sorted(unsorted_versions, reverse=True)
@@ -251,21 +249,25 @@ class AllVersions:

        self.macos_cpython = CPythonVersions()
        self.macos_pypy = PyPyVersions("64")
+        self.macos_pypy_arm64 = PyPyVersions("ARM64")

-    def update_config(self, config: dict[str, str]) -> None:
+    def update_config(self, config: MutableMapping[str, str]) -> None:
        identifier = config["identifier"]
        version = Version(config["version"])
        spec = Specifier(f"=={version.major}.{version.minor}.*")
-        log.info(f"Reading in '{identifier}' -> {spec} @ {version}")
+        log.info("Reading in %r -> %s @ %s", str(identifier), spec, version)
        orig_config = copy.copy(config)
        config_update: AnyConfig | None = None

        # We need to use ** in update due to MyPy (probably a bug)
-        if "macos" in identifier:
+        if "macosx" in identifier:
            if identifier.startswith("cp"):
                config_update = self.macos_cpython.update_version_macos(identifier, version, spec)
            elif identifier.startswith("pp"):
-                config_update = self.macos_pypy.update_version_macos(spec)
+                if "macosx_x86_64" in identifier:
+                    config_update = self.macos_pypy.update_version_macos(spec)
+                elif "macosx_arm64" in identifier:
+                    config_update = self.macos_pypy_arm64.update_version_macos(spec)
        elif "win32" in identifier:
            if identifier.startswith("cp"):
                config_update = self.windows_32.update_version_windows(spec)
@@ -274,15 +276,14 @@ class AllVersions:
                config_update = self.windows_64.update_version_windows(spec)
            elif identifier.startswith("pp"):
                config_update = self.windows_pypy_64.update_version_windows(spec)
-        elif "win_arm64" in identifier:
-            if identifier.startswith("cp"):
-                config_update = self.windows_arm64.update_version_windows(spec)
+        elif "win_arm64" in identifier and identifier.startswith("cp"):
+            config_update = self.windows_arm64.update_version_windows(spec)

        assert config_update is not None, f"{identifier} not found!"
        config.update(**config_update)

        if config != orig_config:
-            log.info(f"  Updated {orig_config} to {config}")
+            log.info("  Updated %s to %s", orig_config, config)


@click.command()
@@ -291,7 +292,6 @@ class AllVersions:
    "--level", default="INFO", type=click.Choice(["WARNING", "INFO", "DEBUG"], case_sensitive=False)
 )
 def update_pythons(force: bool, level: str) -> None:
-
    logging.basicConfig(
        level="INFO",
        format="%(message)s",
@@ -54,14 +54,14 @@ def git_ls_remote_versions(url) -> list[VersionTuple]:
        try:
            version = Version(version_string)
            if version.is_devrelease:
-                log.info(f"Ignoring development release '{version}'")
+                log.info("Ignoring development release %r", str(version))
                continue
            if version.is_prerelease:
-                log.info(f"Ignoring pre-release '{version}'")
+                log.info("Ignoring pre-release %r", str(version))
                continue
            versions.append(VersionTuple(version, version_string))
        except InvalidVersion:
-            log.warning(f"Ignoring ref '{ref}'")
+            log.warning("Ignoring ref %r", ref)
    versions.sort(reverse=True)
    return versions

@@ -72,7 +72,6 @@ def git_ls_remote_versions(url) -> list[VersionTuple]:
    "--level", default="INFO", type=click.Choice(["WARNING", "INFO", "DEBUG"], case_sensitive=False)
 )
 def update_virtualenv(force: bool, level: str) -> None:
-
    logging.basicConfig(
        level="INFO",
        format="%(message)s",
@@ -1,3 +1,3 @@
 from __future__ import annotations

-__version__ = "2.11.2"
+__version__ = "2.12.2"
@@ -7,6 +7,7 @@ import sys
 import tarfile
 import textwrap
 import typing
+from collections.abc import Iterable, Sequence, Set
 from pathlib import Path
 from tempfile import mkdtemp

@@ -18,13 +19,20 @@ import cibuildwheel.windows
 from cibuildwheel.architecture import Architecture, allowed_architectures_check
 from cibuildwheel.logger import log
 from cibuildwheel.options import CommandLineArguments, Options, compute_options
-from cibuildwheel.typing import PLATFORMS, PlatformName, assert_never
+from cibuildwheel.typing import (
+    PLATFORMS,
+    GenericPythonConfiguration,
+    PlatformName,
+    assert_never,
+)
 from cibuildwheel.util import (
    CIBW_CACHE_PATH,
    BuildSelector,
+    CIProvider,
    Unbuffered,
    chdir,
    detect_ci_provider,
+    fix_ansi_codes_for_github_actions,
 )


@@ -165,71 +173,103 @@ def main() -> None:
            log.warning(f"Can't delete temporary folder '{temp_dir}'")


-def build_in_directory(args: CommandLineArguments) -> None:
+def _compute_platform_only(only: str) -> PlatformName:
+    if "linux_" in only:
+        return "linux"
+    if "macosx_" in only:
+        return "macos"
+    if "win_" in only or "win32" in only:
+        return "windows"
+    print(
+        f"Invalid --only='{only}', must be a build selector with a known platform",
+        file=sys.stderr,
+    )
+    sys.exit(2)
+
+
+def _compute_platform_ci() -> PlatformName:
+    if detect_ci_provider() is None:
+        print(
+            textwrap.dedent(
+                """
+                cibuildwheel: Unable to detect platform. cibuildwheel should run on your CI server;
+                Travis CI, AppVeyor, Azure Pipelines, GitHub Actions, CircleCI, Gitlab, and Cirrus CI
+                are supported. You can run on your development machine or other CI providers
+                using the --platform argument. Check --help output for more information.
+                """
+            ),
+            file=sys.stderr,
+        )
+        sys.exit(2)
+    if sys.platform.startswith("linux"):
+        return "linux"
+    elif sys.platform == "darwin":
+        return "macos"
+    elif sys.platform == "win32":
+        return "windows"
+    else:
+        print(
+            'cibuildwheel: Unable to detect platform from "sys.platform" in a CI environment. You can run '
+            "cibuildwheel using the --platform argument. Check --help output for more information.",
+            file=sys.stderr,
+        )
+        sys.exit(2)
+
+
+def _compute_platform(args: CommandLineArguments) -> PlatformName:
    platform_option_value = args.platform or os.environ.get("CIBW_PLATFORM", "auto")
-    platform: PlatformName
+
+    if args.only and args.platform is not None:
+        print(
+            "--platform cannot be specified with --only, it is computed from --only",
+            file=sys.stderr,
+        )
+        sys.exit(2)
+    if args.only and args.archs is not None:
+        print(
+            "--arch cannot be specified with --only, it is computed from --only",
+            file=sys.stderr,
+        )
+        sys.exit(2)
+
+    if platform_option_value not in PLATFORMS | {"auto"}:
+        print(f"cibuildwheel: Unsupported platform: {platform_option_value}", file=sys.stderr)
+        sys.exit(2)

    if args.only:
-        if "linux_" in args.only:
-            platform = "linux"
-        elif "macosx_" in args.only:
-            platform = "macos"
-        elif "win_" in args.only or "win32" in args.only:
-            platform = "windows"
-        else:
-            print(
-                f"Invalid --only='{args.only}', must be a build selector with a known platform",
-                file=sys.stderr,
-            )
-            sys.exit(2)
-        if args.platform is not None:
-            print(
-                "--platform cannot be specified with --only, it is computed from --only",
-                file=sys.stderr,
-            )
-            sys.exit(2)
-        if args.archs is not None:
-            print(
-                "--arch cannot be specified with --only, it is computed from --only",
-                file=sys.stderr,
-            )
-            sys.exit(2)
+        return _compute_platform_only(args.only)
    elif platform_option_value != "auto":
-        if platform_option_value not in PLATFORMS:
-            print(f"cibuildwheel: Unsupported platform: {platform_option_value}", file=sys.stderr)
-            sys.exit(2)
+        return typing.cast(PlatformName, platform_option_value)

-        platform = typing.cast(PlatformName, platform_option_value)
-    else:
-        ci_provider = detect_ci_provider()
-        if ci_provider is None:
-            print(
-                textwrap.dedent(
-                    """
-                    cibuildwheel: Unable to detect platform. cibuildwheel should run on your CI server;
-                    Travis CI, AppVeyor, Azure Pipelines, GitHub Actions, CircleCI, Gitlab, and Cirrus CI
-                    are supported. You can run on your development machine or other CI providers
-                    using the --platform argument. Check --help output for more information.
-                    """
-                ),
-                file=sys.stderr,
-            )
-            sys.exit(2)
-        if sys.platform.startswith("linux"):
-            platform = "linux"
-        elif sys.platform == "darwin":
-            platform = "macos"
-        elif sys.platform == "win32":
-            platform = "windows"
-        else:
-            print(
-                'cibuildwheel: Unable to detect platform from "sys.platform" in a CI environment. You can run '
-                "cibuildwheel using the --platform argument. Check --help output for more information.",
-                file=sys.stderr,
-            )
-            sys.exit(2)
+    return _compute_platform_ci()

-    options = compute_options(platform=platform, command_line_arguments=args)
+
+class PlatformModule(typing.Protocol):
+    # note that as per PEP544, the self argument is ignored when the protocol
+    # is applied to a module
+    def get_python_configurations(
+        self, build_selector: BuildSelector, architectures: Set[Architecture]
+    ) -> Sequence[GenericPythonConfiguration]:
+        ...
+
+    def build(self, options: Options, tmp_path: Path) -> None:
+        ...
+
+
+# pylint: disable-next=inconsistent-return-statements
+def get_platform_module(platform: PlatformName) -> PlatformModule:
+    if platform == "linux":
+        return cibuildwheel.linux
+    if platform == "windows":
+        return cibuildwheel.windows
+    if platform == "macos":
+        return cibuildwheel.macos
+    assert_never(platform)  # noqa: RET503
+
+
+def build_in_directory(args: CommandLineArguments) -> None:
+    platform: PlatformName = _compute_platform(args)
+    options = compute_options(platform=platform, command_line_arguments=args, env=os.environ)

    package_dir = options.globals.package_dir
    package_files = {"setup.py", "setup.cfg", "pyproject.toml"}
@@ -240,8 +280,9 @@ def build_in_directory(args: CommandLineArguments) -> None:
        print(msg, file=sys.stderr)
        sys.exit(2)

+    platform_module = get_platform_module(platform)
    identifiers = get_build_identifiers(
-        platform=platform,
+        platform_module=platform_module,
        build_selector=options.globals.build_selector,
        architectures=options.globals.architectures,
    )
@@ -287,14 +328,7 @@ def build_in_directory(args: CommandLineArguments) -> None:
        with cibuildwheel.util.print_new_wheels(
            "\n{n} wheels produced in {m:.0f} minutes:", output_dir
        ):
-            if platform == "linux":
-                cibuildwheel.linux.build(options, tmp_path)
-            elif platform == "windows":
-                cibuildwheel.windows.build(options, tmp_path)
-            elif platform == "macos":
-                cibuildwheel.macos.build(options, tmp_path)
-            else:
-                assert_never(platform)
+            platform_module.build(options, tmp_path)
    finally:
        # avoid https://github.com/python/cpython/issues/86962 by performing
        # cleanup manually
@@ -303,7 +337,7 @@ def build_in_directory(args: CommandLineArguments) -> None:
            log.warning(f"Can't delete temporary folder '{tmp_path}'")


-def print_preamble(platform: str, options: Options, identifiers: list[str]) -> None:
+def print_preamble(platform: str, options: Options, identifiers: Sequence[str]) -> None:
    print(
        textwrap.dedent(
            """
@@ -318,9 +352,13 @@ def print_preamble(platform: str, options: Options, identifiers: list[str]) -> N
    print(f"cibuildwheel version {cibuildwheel.__version__}\n")

    print("Build options:")
-    print(f"  platform: {platform!r}")
-    print(textwrap.indent(options.summary(identifiers), "  "))
+    print(f"  platform: {platform}")
+    options_summary = textwrap.indent(options.summary(identifiers), "  ")
+    if detect_ci_provider() == CIProvider.github_actions:
+        options_summary = fix_ansi_codes_for_github_actions(options_summary)
+    print(options_summary)

+    print()
    print(f"Cache folder: {CIBW_CACHE_PATH}")

    warnings = detect_warnings(options=options, identifiers=identifiers)
@@ -333,33 +371,13 @@ def print_preamble(platform: str, options: Options, identifiers: list[str]) -> N


 def get_build_identifiers(
-    platform: PlatformName, build_selector: BuildSelector, architectures: set[Architecture]
+    platform_module: PlatformModule, build_selector: BuildSelector, architectures: Set[Architecture]
 ) -> list[str]:
-    python_configurations: (
-        list[cibuildwheel.linux.PythonConfiguration]
-        | list[cibuildwheel.windows.PythonConfiguration]
-        | list[cibuildwheel.macos.PythonConfiguration]
-    )
-
-    if platform == "linux":
-        python_configurations = cibuildwheel.linux.get_python_configurations(
-            build_selector, architectures
-        )
-    elif platform == "windows":
-        python_configurations = cibuildwheel.windows.get_python_configurations(
-            build_selector, architectures
-        )
-    elif platform == "macos":
-        python_configurations = cibuildwheel.macos.get_python_configurations(
-            build_selector, architectures
-        )
-    else:
-        assert_never(platform)
-
+    python_configurations = platform_module.get_python_configurations(build_selector, architectures)
    return [config.identifier for config in python_configurations]


-def detect_warnings(*, options: Options, identifiers: list[str]) -> list[str]:
+def detect_warnings(*, options: Options, identifiers: Iterable[str]) -> list[str]:
    warnings = []

    # warn about deprecated {python} and {pip}
@@ -4,6 +4,7 @@ import functools
 import platform as platform_module
 import re
 import sys
+from collections.abc import Set
 from enum import Enum

 from .typing import Final, Literal, PlatformName, assert_never
@@ -43,6 +44,9 @@ class Architecture(Enum):
    def __lt__(self, other: Architecture) -> bool:
        return self.value < other.value

+    def __str__(self) -> str:
+        return self.name
+
    @staticmethod
    def parse_config(config: str, platform: PlatformName) -> set[Architecture]:
        result = set()
@@ -129,9 +133,8 @@ class Architecture(Enum):

 def allowed_architectures_check(
    platform: PlatformName,
-    architectures: set[Architecture],
+    architectures: Set[Architecture],
 ) -> None:
-
    allowed_architectures = Architecture.all_archs(platform)

    msg = f"{PRETTY_NAMES[platform]} only supports {sorted(allowed_architectures)} at the moment."
@@ -1,8 +1,9 @@
 from __future__ import annotations

 import subprocess
+from collections.abc import Iterable, Mapping, Sequence
 from dataclasses import dataclass
-from typing import Callable, Dict, List, Sequence
+from typing import Callable, Dict, List  # noqa: TID251

 import bashlex

@@ -10,7 +11,7 @@ import bashlex
 EnvironmentExecutor = Callable[[List[str], Dict[str, str]], str]


-def local_environment_executor(command: list[str], env: dict[str, str]) -> str:
+def local_environment_executor(command: Sequence[str], env: Mapping[str, str]) -> str:
    return subprocess.run(command, env=env, text=True, stdout=subprocess.PIPE, check=True).stdout


@@ -22,7 +23,7 @@ class NodeExecutionContext:


 def evaluate(
-    value: str, environment: dict[str, str], executor: EnvironmentExecutor | None = None
+    value: str, environment: Mapping[str, str], executor: EnvironmentExecutor | None = None
 ) -> str:
    if not value:
        # empty string evaluates to empty string
@@ -40,7 +41,9 @@ def evaluate(
    return evaluate_node(
        value_word_node,
        context=NodeExecutionContext(
-            environment=environment, input=value, executor=executor or local_environment_executor
+            environment=dict(environment),
+            input=value,
+            executor=executor or local_environment_executor,
        ),
    )

@@ -105,7 +108,7 @@ def evaluate_nodes_as_compound_command(


 def evaluate_nodes_as_simple_command(
-    nodes: list[bashlex.ast.node], context: NodeExecutionContext
+    nodes: Iterable[bashlex.ast.node], context: NodeExecutionContext
 ) -> str:
    command = [evaluate_node(part, context=context) for part in nodes]
    return context.executor(command, context.environment)
@@ -1,7 +1,8 @@
 from __future__ import annotations

 import dataclasses
-from typing import Any, Mapping, Sequence
+from collections.abc import Mapping, Sequence
+from typing import Any

 import bashlex
 import bashlex.errors
@@ -54,7 +55,7 @@ class EnvironmentAssignment(Protocol):
    def evaluated_value(
        self,
        *,
-        environment: dict[str, str],
+        environment: Mapping[str, str],
        executor: bashlex_eval.EnvironmentExecutor | None = None,
    ) -> str:
        """Returns the value of this assignment, as evaluated in the environment"""
@@ -70,7 +71,7 @@ class EnvironmentAssignmentRaw:
        self.value = value

    def __repr__(self) -> str:
-        return f"{self.name}: {self.value}"
+        return f"{self.name}={self.value}"

    def evaluated_value(self, **_: Any) -> str:
        return self.value
@@ -91,7 +92,7 @@ class EnvironmentAssignmentBash:

    def evaluated_value(
        self,
-        environment: dict[str, str],
+        environment: Mapping[str, str],
        executor: bashlex_eval.EnvironmentExecutor | None = None,
    ) -> str:
        return bashlex_eval.evaluate(self.value, environment=environment, executor=executor)
@@ -117,7 +118,7 @@ class ParsedEnvironment:
        prev_environment: Mapping[str, str],
        executor: bashlex_eval.EnvironmentExecutor | None = None,
    ) -> dict[str, str]:
-        environment = dict(**prev_environment)
+        environment = {**prev_environment}

        for assignment in self.assignments:
            value = assignment.evaluated_value(environment=environment, executor=executor)
@@ -131,6 +132,9 @@ class ParsedEnvironment:
    def __repr__(self) -> str:
        return f"{self.__class__.__name__}({[repr(a) for a in self.assignments]!r})"

+    def options_summary(self) -> Any:
+        return self.assignments
+

 def parse_environment(env_string: str) -> ParsedEnvironment:
    env_items = split_env_items(env_string)
@@ -4,6 +4,7 @@ These are utilities for the `/bin` scripts, not for the `cibuildwheel` program.

 from __future__ import annotations

+from collections.abc import Mapping, Sequence
 from io import StringIO

 from .typing import Protocol
@@ -16,7 +17,9 @@ class Printable(Protocol):
        ...


-def dump_python_configurations(inp: dict[str, dict[str, list[dict[str, Printable]]]]) -> str:
+def dump_python_configurations(
+    inp: Mapping[str, Mapping[str, Sequence[Mapping[str, Printable]]]]
+) -> str:
    output = StringIO()
    for header, values in inp.items():
        output.write(f"[{header}]\n")
@@ -1,7 +1,9 @@
 from __future__ import annotations

+import typing
+from collections.abc import Callable
 from threading import RLock
-from typing import Any, Callable, Generic, TypeVar, overload
+from typing import Any, Generic, TypeVar

 __all__ = ["cached_property"]

@@ -24,11 +26,11 @@ class cached_property(Generic[_T]):
            msg = f"Cannot assign the same cached_property to two different names ({self.attrname!r} and {name!r})."
            raise TypeError(msg)

-    @overload
+    @typing.overload
    def __get__(self, instance: None, owner: type[Any] | None = ...) -> cached_property[_T]:
        ...

-    @overload
+    @typing.overload
    def __get__(self, instance: object, owner: type[Any] | None = ...) -> _T:
        ...

@@ -3,9 +3,10 @@ from __future__ import annotations
 import subprocess
 import sys
 import textwrap
+from collections.abc import Iterable, Iterator, Sequence, Set
 from dataclasses import dataclass
 from pathlib import Path, PurePath, PurePosixPath
-from typing import Iterator, Tuple
+from typing import Tuple

 from .architecture import Architecture
 from .logger import log
@@ -16,11 +17,13 @@ from .util import (
    AlreadyBuiltWheelError,
    BuildSelector,
    NonPlatformWheelError,
+    build_frontend_or_default,
    find_compatible_wheel,
    get_build_verbosity_extra_flags,
    prepare_command,
    read_python_configs,
    split_config_settings,
+    test_fail_cwd_file,
    unwrap,
 )

@@ -45,9 +48,8 @@ class BuildStep:

 def get_python_configurations(
    build_selector: BuildSelector,
-    architectures: set[Architecture],
+    architectures: Set[Architecture],
 ) -> list[PythonConfiguration]:
-
    full_python_configs = read_python_configs("linux")

    python_configurations = [PythonConfiguration(**item) for item in full_python_configs]
@@ -111,7 +113,7 @@ def get_build_steps(


 def check_all_python_exist(
-    *, platform_configs: list[PythonConfiguration], container: OCIContainer
+    *, platform_configs: Iterable[PythonConfiguration], container: OCIContainer
 ) -> None:
    exist = True
    messages = []
@@ -136,7 +138,7 @@ def check_all_python_exist(
 def build_in_container(
    *,
    options: Options,
-    platform_configs: list[PythonConfiguration],
+    platform_configs: Sequence[PythonConfiguration],
    container: OCIContainer,
    container_project_path: PurePath,
    container_package_dir: PurePath,
@@ -174,6 +176,7 @@ def build_in_container(
    for config in platform_configs:
        log.build_start(config.identifier)
        build_options = options.build_options(config.identifier)
+        build_frontend = build_frontend_or_default(build_options.build_frontend)

        dependency_constraint_flags: list[PathOrStr] = []

@@ -223,7 +226,6 @@ def build_in_container(
            )
            repaired_wheels = [compatible_wheel]
        else:
-
            if build_options.before_build:
                log.step("Running before_build...")
                before_build_prepared = prepare_command(
@@ -240,11 +242,10 @@ def build_in_container(
            container.call(["rm", "-rf", built_wheel_dir])
            container.call(["mkdir", "-p", built_wheel_dir])

-            verbosity_flags = get_build_verbosity_extra_flags(build_options.build_verbosity)
-            extra_flags = split_config_settings(build_options.config_settings)
+            extra_flags = split_config_settings(build_options.config_settings, build_frontend)

-            if build_options.build_frontend == "pip":
-                extra_flags += verbosity_flags
+            if build_frontend == "pip":
+                extra_flags += get_build_verbosity_extra_flags(build_options.build_verbosity)
                container.call(
                    [
                        "python",
@@ -258,9 +259,10 @@ def build_in_container(
                    ],
                    env=env,
                )
-            elif build_options.build_frontend == "build":
-                verbosity_setting = " ".join(verbosity_flags)
-                extra_flags += (f"--config-setting={verbosity_setting}",)
+            elif build_frontend == "build":
+                if not 0 <= build_options.build_verbosity < 2:
+                    msg = f"build_verbosity {build_options.build_verbosity} is not supported for build frontend. Ignoring."
+                    log.warning(msg)
                container.call(
                    [
                        "python",
@@ -274,7 +276,7 @@ def build_in_container(
                    env=env,
                )
            else:
-                assert_never(build_options.build_frontend)
+                assert_never(build_frontend)

            built_wheel = container.glob(built_wheel_dir, "*.whl")[0]

@@ -306,9 +308,11 @@ def build_in_container(
            # set up a virtual environment to install and test from, to make sure
            # there are no dependencies that were pulled in at build time.
            container.call(["pip", "install", "virtualenv", *dependency_constraint_flags], env=env)
-            venv_dir = (
-                PurePath(container.call(["mktemp", "-d"], capture_output=True).strip()) / "venv"
+
+            testing_temp_dir = PurePosixPath(
+                container.call(["mktemp", "-d"], capture_output=True).strip()
            )
+            venv_dir = testing_temp_dir / "venv"

            container.call(["python", "-m", "virtualenv", "--no-download", venv_dir], env=env)

@@ -345,10 +349,14 @@ def build_in_container(
                project=container_project_path,
                package=container_package_dir,
            )
-            container.call(["sh", "-c", test_command_prepared], cwd="/root", env=virtualenv_env)
+            test_cwd = testing_temp_dir / "test_cwd"
+            container.call(["mkdir", "-p", test_cwd])
+            container.copy_into(test_fail_cwd_file, test_cwd / "test_fail.py")
+
+            container.call(["sh", "-c", test_command_prepared], cwd=test_cwd, env=virtualenv_env)

            # clean up test environment
-            container.call(["rm", "-rf", venv_dir])
+            container.call(["rm", "-rf", testing_temp_dir])

        # move repaired wheels to output
        if compatible_wheel is None:
@@ -366,7 +374,7 @@ def build_in_container(
    log.step_end()


-def build(options: Options, tmp_path: Path) -> None:  # pylint: disable=unused-argument
+def build(options: Options, tmp_path: Path) -> None:  # noqa: ARG001
    try:
        # check the container engine is installed
        subprocess.run(
@@ -414,7 +422,6 @@ def build(options: Options, tmp_path: Path) -> None:  # pylint: disable=unused-a
                cwd=container_project_path,
                engine=options.globals.container_engine,
            ) as container:
-
                build_in_container(
                    options=options,
                    platform_configs=build_step.platform_configs,
@@ -431,7 +438,7 @@ def build(options: Options, tmp_path: Path) -> None:  # pylint: disable=unused-a
            sys.exit(1)


-def _matches_prepared_command(error_cmd: list[str], command_template: str) -> bool:
+def _matches_prepared_command(error_cmd: Sequence[str], command_template: str) -> bool:
    if len(error_cmd) < 3 or error_cmd[0:2] != ["sh", "-c"]:
        return False
    command_prefix = command_template.split("{", maxsplit=1)[0].strip()
@@ -439,7 +446,6 @@ def _matches_prepared_command(error_cmd: list[str], command_template: str) -> bo


 def troubleshoot(options: Options, error: Exception) -> None:
-
    if isinstance(error, subprocess.CalledProcessError) and (
        error.cmd[0:4] == ["python", "-m", "pip", "wheel"]
        or error.cmd[0:3] == ["python", "-m", "build"]
@@ -126,6 +126,10 @@ class Logger:
        self.step_end(success=False)
        self.error(error)

+    def quiet(self, message: str) -> None:
+        c = self.colors
+        print(f"{c.gray}{message}{c.end}", file=sys.stderr)
+
    def notice(self, message: str) -> None:
        if self.fold_mode == "github":
            print(f"::notice::{message}\n", file=sys.stderr)
@@ -228,6 +232,7 @@ class Colors:
        self.bright_red = "\033[91m" if enabled else ""
        self.bright_green = "\033[92m" if enabled else ""
        self.white = "\033[37m\033[97m" if enabled else ""
+        self.gray = "\033[38;5;244m" if enabled else ""

        self.bg_grey = "\033[48;5;235m" if enabled else ""

@@ -8,9 +8,11 @@ import re
 import shutil
 import subprocess
 import sys
+import typing
+from collections.abc import Sequence, Set
 from dataclasses import dataclass
 from pathlib import Path
-from typing import Sequence, Tuple, cast
+from typing import Tuple

 from filelock import FileLock

@@ -25,6 +27,7 @@ from .util import (
    BuildFrontend,
    BuildSelector,
    NonPlatformWheelError,
+    build_frontend_or_default,
    call,
    detect_ci_provider,
    download,
@@ -36,6 +39,7 @@ from .util import (
    read_python_configs,
    shell,
    split_config_settings,
+    test_fail_cwd_file,
    unwrap,
    virtualenv,
 )
@@ -52,7 +56,7 @@ def get_macos_version() -> tuple[int, int]:
    """
    version_str, _, _ = platform.mac_ver()
    version = tuple(map(int, version_str.split(".")[:2]))
-    return cast(Tuple[int, int], version)
+    return typing.cast(Tuple[int, int], version)


 def get_macos_sdks() -> list[str]:
@@ -68,9 +72,8 @@ class PythonConfiguration:


 def get_python_configurations(
-    build_selector: BuildSelector, architectures: set[Architecture]
+    build_selector: BuildSelector, architectures: Set[Architecture]
 ) -> list[PythonConfiguration]:
-
    full_python_configs = read_python_configs("macos")

    python_configurations = [PythonConfiguration(**item) for item in full_python_configs]
@@ -83,7 +86,31 @@ def get_python_configurations(
    ]

    # skip builds as required by BUILD/SKIP
-    return [c for c in python_configurations if build_selector(c.identifier)]
+    python_configurations = [c for c in python_configurations if build_selector(c.identifier)]
+
+    # filter-out some cross-compilation configs with PyPy:
+    # can't build arm64 on x86_64
+    # rosetta allows to build x86_64 on arm64
+    if platform.machine() == "x86_64":
+        python_configurations_before = set(python_configurations)
+        python_configurations = [
+            c
+            for c in python_configurations
+            if not (c.identifier.startswith("pp") and c.identifier.endswith("arm64"))
+        ]
+        removed_elements = python_configurations_before - set(python_configurations)
+        if removed_elements:
+            ids = ", ".join(c.identifier for c in removed_elements)
+            log.quiet(
+                unwrap(
+                    f"""
+                    Note: {ids}  {'was' if len(removed_elements) == 1 else 'were'}
+                    selected, but can't be built on x86_64 so will be skipped automatically.
+                    """
+                )
+            )
+
+    return python_configurations


 def install_cpython(tmp: Path, version: str, url: str) -> Path:
@@ -306,6 +333,7 @@ def build(options: Options, tmp_path: Path) -> None:

        for config in python_configurations:
            build_options = options.build_options(config.identifier)
+            build_frontend = build_frontend_or_default(build_options.build_frontend)
            log.build_start(config.identifier)

            identifier_tmp_dir = tmp_path / config.identifier
@@ -328,7 +356,7 @@ def build(options: Options, tmp_path: Path) -> None:
                config,
                dependency_constraint_flags,
                build_options.environment,
-                build_options.build_frontend,
+                build_frontend,
            )

            compatible_wheel = find_compatible_wheel(built_wheels, config.identifier)
@@ -349,11 +377,10 @@ def build(options: Options, tmp_path: Path) -> None:
                log.step("Building wheel...")
                built_wheel_dir.mkdir()

-                verbosity_flags = get_build_verbosity_extra_flags(build_options.build_verbosity)
-                extra_flags = split_config_settings(build_options.config_settings)
+                extra_flags = split_config_settings(build_options.config_settings, build_frontend)

-                if build_options.build_frontend == "pip":
-                    extra_flags += verbosity_flags
+                if build_frontend == "pip":
+                    extra_flags += get_build_verbosity_extra_flags(build_options.build_verbosity)
                    # Path.resolve() is needed. Without it pip wheel may try to fetch package from pypi.org
                    # see https://github.com/pypa/cibuildwheel/pull/369
                    call(
@@ -367,9 +394,10 @@ def build(options: Options, tmp_path: Path) -> None:
                        *extra_flags,
                        env=env,
                    )
-                elif build_options.build_frontend == "build":
-                    verbosity_setting = " ".join(verbosity_flags)
-                    extra_flags += (f"--config-setting={verbosity_setting}",)
+                elif build_frontend == "build":
+                    if not 0 <= build_options.build_verbosity < 2:
+                        msg = f"build_verbosity {build_options.build_verbosity} is not supported for build frontend. Ignoring."
+                        log.warning(msg)
                    build_env = env.copy()
                    if build_options.dependency_constraints:
                        constraint_path = (
@@ -390,7 +418,7 @@ def build(options: Options, tmp_path: Path) -> None:
                        env=build_env,
                    )
                else:
-                    assert_never(build_options.build_frontend)
+                    assert_never(build_frontend)

                built_wheel = next(built_wheel_dir.glob("*.whl"))

@@ -563,7 +591,7 @@ def build(options: Options, tmp_path: Path) -> None:
                            "pip", "install", *build_options.test_requires, env=virtualenv_env
                        )

-                    # run the tests from $HOME, with an absolute path in the command
+                    # run the tests from a temp dir, with an absolute path in the command
                    # (this ensures that Python runs the tests against the installed wheel
                    # and not the repo code)
                    test_command_prepared = prepare_command(
@@ -571,9 +599,12 @@ def build(options: Options, tmp_path: Path) -> None:
                        project=Path(".").resolve(),
                        package=build_options.package_dir.resolve(),
                    )
-                    shell_with_arch(
-                        test_command_prepared, cwd=os.environ["HOME"], env=virtualenv_env
-                    )
+
+                    test_cwd = identifier_tmp_dir / "test_cwd"
+                    test_cwd.mkdir(exist_ok=True)
+                    (test_cwd / "test_fail.py").write_text(test_fail_cwd_file.read_text())
+
+                    shell_with_arch(test_command_prepared, cwd=test_cwd, env=virtualenv_env)

            # we're all done here; move it to output (overwrite existing)
            if compatible_wheel is None:
@@ -8,10 +8,12 @@ import shlex
 import shutil
 import subprocess
 import sys
+import typing
 import uuid
+from collections.abc import Mapping, Sequence
 from pathlib import Path, PurePath, PurePosixPath
 from types import TracebackType
-from typing import IO, Dict, Sequence, cast
+from typing import IO, Dict

 from cibuildwheel.util import CIProvider, detect_ci_provider

@@ -68,7 +70,6 @@ class OCIContainer:
        self.engine = engine

    def __enter__(self) -> OCIContainer:
-
        self.name = f"cibuildwheel-{uuid.uuid4()}"

        # work-around for Travis-CI PPC64le Docker runs since 2021:
@@ -108,7 +109,8 @@ class OCIContainer:
            stdout=subprocess.PIPE,
        )

-        assert self.process.stdin and self.process.stdout
+        assert self.process.stdin
+        assert self.process.stdout
        self.bash_stdin = self.process.stdin
        self.bash_stdout = self.process.stdout

@@ -129,7 +131,6 @@ class OCIContainer:
        exc_val: BaseException | None,
        exc_tb: TracebackType | None,
    ) -> None:
-
        self.bash_stdin.write(b"exit 0\n")
        self.bash_stdin.flush()
        self.process.wait(timeout=30)
@@ -167,6 +168,7 @@ class OCIContainer:
                cwd=from_path,
            )
        else:
+            exec_process: subprocess.Popen[bytes]
            with subprocess.Popen(
                [
                    self.engine,
@@ -179,10 +181,10 @@ class OCIContainer:
                ],
                stdin=subprocess.PIPE,
            ) as exec_process:
-                exec_process.stdin = cast(IO[bytes], exec_process.stdin)
-
+                assert exec_process.stdin
                with open(from_path, "rb") as from_file:
-                    shutil.copyfileobj(from_file, exec_process.stdin)
+                    # Bug in mypy, https://github.com/python/mypy/issues/15031
+                    shutil.copyfileobj(from_file, exec_process.stdin)  # type: ignore[misc]

                exec_process.stdin.close()
                exec_process.wait()
@@ -239,11 +241,10 @@ class OCIContainer:
    def call(
        self,
        args: Sequence[PathOrStr],
-        env: dict[str, str] | None = None,
+        env: Mapping[str, str] | None = None,
        capture_output: bool = False,
        cwd: PathOrStr | None = None,
    ) -> str:
-
        if cwd is None:
            # Podman does not start the a container in a specific working dir
            # so we always need to specify it when making calls.
@@ -330,9 +331,9 @@ class OCIContainer:
                capture_output=True,
            )
        )
-        return cast(Dict[str, str], env)
+        return typing.cast(Dict[str, str], env)

-    def environment_executor(self, command: list[str], environment: dict[str, str]) -> str:
+    def environment_executor(self, command: Sequence[str], environment: dict[str, str]) -> str:
        # used as an EnvironmentExecutor to evaluate commands and capture output
        return self.call(command, env=environment, capture_output=True)

@@ -1,16 +1,19 @@
 from __future__ import annotations

+import collections
 import configparser
 import contextlib
 import dataclasses
 import difflib
 import functools
-import os
 import shlex
 import sys
+import textwrap
 import traceback
+import typing
+from collections.abc import Callable, Generator, Iterable, Iterator, Mapping, Set
 from pathlib import Path
-from typing import Any, Callable, Dict, Generator, Iterator, List, Mapping, Union, cast
+from typing import Any, Dict, List, Union

 if sys.version_info >= (3, 11):
    import tomllib
@@ -21,6 +24,7 @@ from packaging.specifiers import SpecifierSet

 from .architecture import Architecture
 from .environment import EnvironmentParseError, ParsedEnvironment, parse_environment
+from .logger import log
 from .oci_container import ContainerEngine
 from .projectfiles import get_requires_python_str
 from .typing import PLATFORMS, Literal, NotRequired, PlatformName, TypedDict
@@ -52,6 +56,20 @@ class CommandLineArguments:
    allow_empty: bool
    prerelease_pythons: bool

+    @staticmethod
+    def defaults() -> CommandLineArguments:
+        return CommandLineArguments(
+            platform="auto",
+            allow_empty=False,
+            archs=None,
+            only=None,
+            config_file="",
+            output_dir=Path("wheelhouse"),
+            package_dir=Path("."),
+            prerelease_pythons=False,
+            print_build_identifiers=False,
+        )
+

@dataclasses.dataclass(frozen=True)
 class GlobalOptions:
@@ -78,7 +96,7 @@ class BuildOptions:
    test_requires: list[str]
    test_extras: str
    build_verbosity: int
-    build_frontend: BuildFrontend
+    build_frontend: BuildFrontend | Literal["default"]
    config_settings: str

    @property
@@ -145,7 +163,7 @@ def _dig_first(*pairs: tuple[Mapping[str, Setting], str], ignore_empty: bool = F
        if key in dict_like:
            value = dict_like[key]

-            if ignore_empty and value == "":
+            if ignore_empty and value == "":  # noqa: PLC1901
                continue

            return value
@@ -176,9 +194,11 @@ class OptionsReader:
        config_file_path: Path | None = None,
        *,
        platform: PlatformName,
-        disallow: dict[str, set[str]] | None = None,
+        env: Mapping[str, str],
+        disallow: Mapping[str, Set[str]] | None = None,
    ) -> None:
        self.platform = platform
+        self.env = env
        self.disallow = disallow or {}

        # Open defaults.toml, loading both global and platform sections
@@ -319,8 +339,8 @@ class OptionsReader:
        # get the option from the environment, then the config file, then finally the default.
        # platform-specific options are preferred, if they're allowed.
        result = _dig_first(
-            (os.environ if env_plat else {}, plat_envvar),  # type: ignore[arg-type]
-            (os.environ, envvar),
+            (self.env if env_plat else {}, plat_envvar),
+            (self.env, envvar),
            *[(o.options, name) for o in active_config_overrides],
            (self.config_platform_options, name),
            (self.config_options, name),
@@ -362,13 +382,21 @@ def _inner_fmt(k: str, v: Any, table: TableFmt) -> Iterator[str]:


 class Options:
-    def __init__(self, platform: PlatformName, command_line_arguments: CommandLineArguments):
+    def __init__(
+        self,
+        platform: PlatformName,
+        command_line_arguments: CommandLineArguments,
+        env: Mapping[str, str],
+        read_config_file: bool = True,
+    ):
        self.platform = platform
        self.command_line_arguments = command_line_arguments
+        self.env = env

        self.reader = OptionsReader(
-            self.config_file_path,
+            self.config_file_path if read_config_file else None,
            platform=platform,
+            env=env,
            disallow=DISALLOWED_OPTIONS,
        )

@@ -402,13 +430,13 @@ class Options:
        test_skip = self.reader.get("test-skip", env_plat=False, sep=" ")

        prerelease_pythons = args.prerelease_pythons or strtobool(
-            os.environ.get("CIBW_PRERELEASE_PYTHONS", "0")
+            self.env.get("CIBW_PRERELEASE_PYTHONS", "0")
        )

        # This is not supported in tool.cibuildwheel, as it comes from a standard location.
        # Passing this in as an environment variable will override pyproject.toml, setup.cfg, or setup.py
        requires_python_str: str | None = (
-            os.environ.get("CIBW_PROJECT_REQUIRES_PYTHON") or self.package_requires_python_str
+            self.env.get("CIBW_PROJECT_REQUIRES_PYTHON") or self.package_requires_python_str
        )
        requires_python = None if requires_python_str is None else SpecifierSet(requires_python_str)

@@ -436,7 +464,7 @@ class Options:
            print(msg, file=sys.stderr)
            sys.exit(2)

-        container_engine = cast(ContainerEngine, container_engine_str)
+        container_engine = typing.cast(ContainerEngine, container_engine_str)

        return GlobalOptions(
            package_dir=package_dir,
@@ -473,11 +501,13 @@ class Options:
            test_extras = self.reader.get("test-extras", sep=",")
            build_verbosity_str = self.reader.get("build-verbosity")

-            build_frontend: BuildFrontend
+            build_frontend: BuildFrontend | Literal["default"]
            if build_frontend_str == "build":
                build_frontend = "build"
            elif build_frontend_str == "pip":
                build_frontend = "pip"
+            elif build_frontend_str == "default":
+                build_frontend = "default"
            else:
                msg = f"cibuildwheel: Unrecognised build frontend {build_frontend_str!r}, only 'pip' and 'build' are supported"
                print(msg, file=sys.stderr)
@@ -497,7 +527,7 @@ class Options:
            if self.platform == "linux":
                for env_var_name in environment_pass:
                    with contextlib.suppress(KeyError):
-                        environment.add(env_var_name, os.environ[env_var_name])
+                        environment.add(env_var_name, self.env[env_var_name])

            if dependency_versions == "pinned":
                dependency_constraints: None | (
@@ -571,7 +601,7 @@ class Options:
                config_settings=config_settings,
            )

-    def check_for_invalid_configuration(self, identifiers: list[str]) -> None:
+    def check_for_invalid_configuration(self, identifiers: Iterable[str]) -> None:
        if self.platform in {"macos", "windows"}:
            before_all_values = {self.build_options(i).before_all for i in identifiers}

@@ -594,37 +624,119 @@ class Options:
        deprecated_selectors("CIBW_SKIP", build_selector.skip_config)
        deprecated_selectors("CIBW_TEST_SKIP", test_selector.skip_config)

-    def summary(self, identifiers: list[str]) -> str:
-        lines = [
-            f"{option_name}: {option_value!r}"
-            for option_name, option_value in sorted(dataclasses.asdict(self.globals).items())
-        ]
+    @cached_property
+    def defaults(self) -> Options:
+        return Options(
+            platform=self.platform,
+            command_line_arguments=CommandLineArguments.defaults(),
+            env={},
+            read_config_file=False,
+        )

-        build_option_defaults = self.build_options(identifier=None)
+    def summary(self, identifiers: Iterable[str]) -> str:
+        lines = []
+        global_option_names = sorted(f.name for f in dataclasses.fields(self.globals))
+
+        for option_name in global_option_names:
+            option_value = getattr(self.globals, option_name)
+            default_value = getattr(self.defaults.globals, option_name)
+            lines.append(self.option_summary(option_name, option_value, default_value))
+
+        build_options = self.build_options(identifier=None)
+        build_options_defaults = self.defaults.build_options(identifier=None)
        build_options_for_identifier = {
            identifier: self.build_options(identifier) for identifier in identifiers
        }

-        for option_name, default_value in sorted(dataclasses.asdict(build_option_defaults).items()):
+        build_option_names = sorted(f.name for f in dataclasses.fields(build_options))
+
+        for option_name in build_option_names:
            if option_name == "globals":
                continue

-            lines.append(f"{option_name}: {default_value!r}")
+            option_value = getattr(build_options, option_name)
+            default_value = getattr(build_options_defaults, option_name)
+            overrides = {
+                i: getattr(build_options_for_identifier[i], option_name) for i in identifiers
+            }

-            # if any identifiers have an overridden value, print that too
-            for identifier in identifiers:
-                option_value = getattr(build_options_for_identifier[identifier], option_name)
-                if option_value != default_value:
-                    lines.append(f"  {identifier}: {option_value!r}")
+            lines.append(
+                self.option_summary(option_name, option_value, default_value, overrides=overrides)
+            )

        return "\n".join(lines)

+    def option_summary(
+        self,
+        option_name: str,
+        option_value: Any,
+        default_value: Any,
+        overrides: Mapping[str, Any] | None = None,
+    ) -> str:
+        """
+        Return a summary of the option value, including any overrides, with
+        ANSI 'dim' color if it's the default.
+        """
+        value_str = self.option_summary_value(option_value)
+        default_value_str = self.option_summary_value(default_value)
+        overrides_value_strs = {
+            k: self.option_summary_value(v) for k, v in (overrides or {}).items()
+        }
+        # if the override value is the same as the non-overridden value, don't print it
+        overrides_value_strs = {k: v for k, v in overrides_value_strs.items() if v != value_str}
+
+        has_been_set = (value_str != default_value_str) or overrides_value_strs
+        c = log.colors
+
+        result = c.gray if not has_been_set else ""
+        result += f"{option_name}: "
+
+        if overrides_value_strs:
+            overrides_groups = collections.defaultdict(list)
+            for k, v in overrides_value_strs.items():
+                overrides_groups[v].append(k)
+
+            result += "\n  *: "
+            result += self.indent_if_multiline(value_str, "    ")
+
+            for override_value_str, identifiers in overrides_groups.items():
+                result += f"\n  {', '.join(identifiers)}: "
+                result += self.indent_if_multiline(override_value_str, "    ")
+        else:
+            result += self.indent_if_multiline(value_str, "  ")
+
+        result += c.end
+
+        return result
+
+    def indent_if_multiline(self, value: str, indent: str) -> str:
+        if "\n" in value:
+            return "\n" + textwrap.indent(value.strip(), indent)
+        else:
+            return value
+
+    def option_summary_value(self, option_value: Any) -> str:
+        if hasattr(option_value, "options_summary"):
+            option_value = option_value.options_summary()
+
+        if isinstance(option_value, list):
+            return "".join(f"{el}\n" for el in option_value)
+
+        if isinstance(option_value, set):
+            return ", ".join(str(el) for el in sorted(option_value))
+
+        if isinstance(option_value, dict):
+            return "".join(f"{k}: {v}\n" for k, v in option_value.items())
+
+        return str(option_value)
+

 def compute_options(
    platform: PlatformName,
    command_line_arguments: CommandLineArguments,
+    env: Mapping[str, str],
 ) -> Options:
-    options = Options(platform=platform, command_line_arguments=command_line_arguments)
+    options = Options(platform=platform, command_line_arguments=command_line_arguments, env=env)
    options.check_for_deprecated_options()
    return options

@@ -37,13 +37,14 @@ class Analyzer(ast.NodeVisitor):

    def visit_keyword(self, node: ast.keyword) -> None:
        self.generic_visit(node)
-        if node.arg == "python_requires":
-            # Must not be nested in an if or other structure
-            # This will be Module -> Expr -> Call -> keyword
-            if not hasattr(node.parent.parent.parent, "parent") and isinstance(  # type: ignore[attr-defined]
-                node.value, Constant
-            ):
-                self.requires_python = get_constant(node.value)
+        # Must not be nested in an if or other structure
+        # This will be Module -> Expr -> Call -> keyword
+        if (
+            node.arg == "python_requires"
+            and not hasattr(node.parent.parent.parent, "parent")  # type: ignore[attr-defined]
+            and isinstance(node.value, Constant)
+        ):
+            self.requires_python = get_constant(node.value)


 def setup_py_python_requires(content: str) -> str | None:
@@ -73,8 +74,8 @@ def get_requires_python_str(package_dir: Path) -> str | None:
        with contextlib.suppress(KeyError, IndexError, TypeError):
            return str(config["options"]["python_requires"])

-    with contextlib.suppress(FileNotFoundError):
-        with (package_dir / "setup.py").open(encoding="utf8") as f2:
-            return setup_py_python_requires(f2.read())
+    setup_py = package_dir / "setup.py"
+    with contextlib.suppress(FileNotFoundError), setup_py.open(encoding="utf8") as f2:
+        return setup_py_python_requires(f2.read())

    return None
@@ -81,15 +81,17 @@ python_configurations = [
  { identifier = "cp39-macosx_x86_64", version = "3.9", url = "https://www.python.org/ftp/python/3.9.13/python-3.9.13-macos11.pkg" },
  { identifier = "cp39-macosx_arm64", version = "3.9", url = "https://www.python.org/ftp/python/3.9.13/python-3.9.13-macos11.pkg" },
  { identifier = "cp39-macosx_universal2", version = "3.9", url = "https://www.python.org/ftp/python/3.9.13/python-3.9.13-macos11.pkg" },
-  { identifier = "cp310-macosx_x86_64", version = "3.10", url = "https://www.python.org/ftp/python/3.10.8/python-3.10.8-macos11.pkg" },
-  { identifier = "cp310-macosx_arm64", version = "3.10", url = "https://www.python.org/ftp/python/3.10.8/python-3.10.8-macos11.pkg" },
-  { identifier = "cp310-macosx_universal2", version = "3.10", url = "https://www.python.org/ftp/python/3.10.8/python-3.10.8-macos11.pkg" },
-  { identifier = "cp311-macosx_x86_64", version = "3.11", url = "https://www.python.org/ftp/python/3.11.0/python-3.11.0-macos11.pkg" },
-  { identifier = "cp311-macosx_arm64", version = "3.11", url = "https://www.python.org/ftp/python/3.11.0/python-3.11.0-macos11.pkg" },
-  { identifier = "cp311-macosx_universal2", version = "3.11", url = "https://www.python.org/ftp/python/3.11.0/python-3.11.0-macos11.pkg" },
+  { identifier = "cp310-macosx_x86_64", version = "3.10", url = "https://www.python.org/ftp/python/3.10.11/python-3.10.11-macos11.pkg" },
+  { identifier = "cp310-macosx_arm64", version = "3.10", url = "https://www.python.org/ftp/python/3.10.11/python-3.10.11-macos11.pkg" },
+  { identifier = "cp310-macosx_universal2", version = "3.10", url = "https://www.python.org/ftp/python/3.10.11/python-3.10.11-macos11.pkg" },
+  { identifier = "cp311-macosx_x86_64", version = "3.11", url = "https://www.python.org/ftp/python/3.11.3/python-3.11.3-macos11.pkg" },
+  { identifier = "cp311-macosx_arm64", version = "3.11", url = "https://www.python.org/ftp/python/3.11.3/python-3.11.3-macos11.pkg" },
+  { identifier = "cp311-macosx_universal2", version = "3.11", url = "https://www.python.org/ftp/python/3.11.3/python-3.11.3-macos11.pkg" },
  { identifier = "pp37-macosx_x86_64", version = "3.7", url = "https://downloads.python.org/pypy/pypy3.7-v7.3.9-osx64.tar.bz2" },
-  { identifier = "pp38-macosx_x86_64", version = "3.8", url = "https://downloads.python.org/pypy/pypy3.8-v7.3.9-osx64.tar.bz2" },
-  { identifier = "pp39-macosx_x86_64", version = "3.9", url = "https://downloads.python.org/pypy/pypy3.9-v7.3.9-osx64.tar.bz2" },
+  { identifier = "pp38-macosx_x86_64", version = "3.8", url = "https://downloads.python.org/pypy/pypy3.8-v7.3.11-macos_x86_64.tar.bz2" },
+  { identifier = "pp38-macosx_arm64", version = "3.8", url = "https://downloads.python.org/pypy/pypy3.8-v7.3.11-macos_arm64.tar.bz2" },
+  { identifier = "pp39-macosx_x86_64", version = "3.9", url = "https://downloads.python.org/pypy/pypy3.9-v7.3.11-macos_x86_64.tar.bz2" },
+  { identifier = "pp39-macosx_arm64", version = "3.9", url = "https://downloads.python.org/pypy/pypy3.9-v7.3.11-macos_arm64.tar.bz2" },
 ]

 [windows]
@@ -102,14 +104,14 @@ python_configurations = [
  { identifier = "cp38-win_amd64", version = "3.8.10", arch = "64" },
  { identifier = "cp39-win32", version = "3.9.13", arch = "32" },
  { identifier = "cp39-win_amd64", version = "3.9.13", arch = "64" },
-  { identifier = "cp310-win32", version = "3.10.8", arch = "32" },
-  { identifier = "cp310-win_amd64", version = "3.10.8", arch = "64" },
-  { identifier = "cp311-win32", version = "3.11.0", arch = "32" },
-  { identifier = "cp311-win_amd64", version = "3.11.0", arch = "64" },
+  { identifier = "cp310-win32", version = "3.10.11", arch = "32" },
+  { identifier = "cp310-win_amd64", version = "3.10.11", arch = "64" },
+  { identifier = "cp311-win32", version = "3.11.3", arch = "32" },
+  { identifier = "cp311-win_amd64", version = "3.11.3", arch = "64" },
  { identifier = "cp39-win_arm64", version = "3.9.10", arch = "ARM64" },
-  { identifier = "cp310-win_arm64", version = "3.10.8", arch = "ARM64" },
-  { identifier = "cp311-win_arm64", version = "3.11.0", arch = "ARM64" },
+  { identifier = "cp310-win_arm64", version = "3.10.11", arch = "ARM64" },
+  { identifier = "cp311-win_arm64", version = "3.11.3", arch = "ARM64" },
  { identifier = "pp37-win_amd64", version = "3.7", arch = "64", url = "https://downloads.python.org/pypy/pypy3.7-v7.3.9-win64.zip" },
-  { identifier = "pp38-win_amd64", version = "3.8", arch = "64", url = "https://downloads.python.org/pypy/pypy3.8-v7.3.9-win64.zip" },
-  { identifier = "pp39-win_amd64", version = "3.9", arch = "64", url = "https://downloads.python.org/pypy/pypy3.9-v7.3.9-win64.zip" },
+  { identifier = "pp38-win_amd64", version = "3.8", arch = "64", url = "https://downloads.python.org/pypy/pypy3.8-v7.3.11-win64.zip" },
+  { identifier = "pp39-win_amd64", version = "3.9", arch = "64", url = "https://downloads.python.org/pypy/pypy3.9-v7.3.11-win64.zip" },
 ]
@@ -1,28 +1,28 @@
 #
-# This file is autogenerated by pip-compile with python 3.10
-# To update, run:
+# This file is autogenerated by pip-compile with Python 3.10
+# by the following command:
 #
 #    nox -s update_constraints-3.10
 #
-delocate==0.10.2
+delocate==0.10.4
    # via -r cibuildwheel/resources/constraints.in
 distlib==0.3.6
    # via virtualenv
-filelock==3.8.0
+filelock==3.11.0
    # via virtualenv
-platformdirs==2.5.2
-    # via virtualenv
-typing-extensions==4.4.0
+packaging==23.1
    # via delocate
-virtualenv==20.16.5
+platformdirs==3.2.0
+    # via virtualenv
+typing-extensions==4.5.0
+    # via delocate
+virtualenv==20.21.0
+    # via -r cibuildwheel/resources/constraints.in
+wheel==0.40.0
    # via -r cibuildwheel/resources/constraints.in
-wheel==0.37.1
-    # via
-    #   -r cibuildwheel/resources/constraints.in
-    #   delocate

 # The following packages are considered to be unsafe in a requirements file:
-pip==22.3
+pip==23.1
    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.5.0
+setuptools==67.6.1
    # via -r cibuildwheel/resources/constraints.in
@@ -1,28 +1,28 @@
 #
-# This file is autogenerated by pip-compile with python 3.11
-# To update, run:
+# This file is autogenerated by pip-compile with Python 3.11
+# by the following command:
 #
 #    nox -s update_constraints-3.11
 #
-delocate==0.10.2
+delocate==0.10.4
    # via -r cibuildwheel/resources/constraints.in
 distlib==0.3.6
    # via virtualenv
-filelock==3.8.0
+filelock==3.11.0
    # via virtualenv
-platformdirs==2.5.2
-    # via virtualenv
-typing-extensions==4.4.0
+packaging==23.1
    # via delocate
-virtualenv==20.16.5
+platformdirs==3.2.0
+    # via virtualenv
+typing-extensions==4.5.0
+    # via delocate
+virtualenv==20.21.0
+    # via -r cibuildwheel/resources/constraints.in
+wheel==0.40.0
    # via -r cibuildwheel/resources/constraints.in
-wheel==0.37.1
-    # via
-    #   -r cibuildwheel/resources/constraints.in
-    #   delocate

 # The following packages are considered to be unsafe in a requirements file:
-pip==22.3
+pip==23.1
    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.5.0
+setuptools==67.6.1
    # via -r cibuildwheel/resources/constraints.in
@@ -20,7 +20,7 @@ typing-extensions==4.1.1
    # via
    #   delocate
    #   importlib-metadata
-virtualenv==20.16.5
+virtualenv==20.17.1
    # via -r cibuildwheel/resources/constraints.in
 wheel==0.37.1
    # via
@@ -1,34 +1,35 @@
 #
-# This file is autogenerated by pip-compile with python 3.7
-# To update, run:
+# This file is autogenerated by pip-compile with Python 3.7
+# by the following command:
 #
 #    nox -s update_constraints-3.7
 #
-delocate==0.10.2
+delocate==0.10.4
    # via -r cibuildwheel/resources/constraints.in
 distlib==0.3.6
    # via virtualenv
-filelock==3.8.0
+filelock==3.11.0
    # via virtualenv
-importlib-metadata==5.0.0
+importlib-metadata==6.4.1
    # via virtualenv
-platformdirs==2.5.2
+packaging==23.1
+    # via delocate
+platformdirs==3.2.0
    # via virtualenv
-typing-extensions==4.4.0
+typing-extensions==4.5.0
    # via
    #   delocate
    #   importlib-metadata
-virtualenv==20.16.5
+    #   platformdirs
+virtualenv==20.21.0
    # via -r cibuildwheel/resources/constraints.in
-wheel==0.37.1
-    # via
-    #   -r cibuildwheel/resources/constraints.in
-    #   delocate
-zipp==3.10.0
+wheel==0.40.0
+    # via -r cibuildwheel/resources/constraints.in
+zipp==3.15.0
    # via importlib-metadata

 # The following packages are considered to be unsafe in a requirements file:
-pip==22.3
+pip==23.1
    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.5.0
+setuptools==67.6.1
    # via -r cibuildwheel/resources/constraints.in
@@ -1,28 +1,28 @@
 #
-# This file is autogenerated by pip-compile with python 3.8
-# To update, run:
+# This file is autogenerated by pip-compile with Python 3.8
+# by the following command:
 #
 #    nox -s update_constraints-3.8
 #
-delocate==0.10.2
+delocate==0.10.4
    # via -r cibuildwheel/resources/constraints.in
 distlib==0.3.6
    # via virtualenv
-filelock==3.8.0
+filelock==3.11.0
    # via virtualenv
-platformdirs==2.5.2
-    # via virtualenv
-typing-extensions==4.4.0
+packaging==23.1
    # via delocate
-virtualenv==20.16.5
+platformdirs==3.2.0
+    # via virtualenv
+typing-extensions==4.5.0
+    # via delocate
+virtualenv==20.21.0
+    # via -r cibuildwheel/resources/constraints.in
+wheel==0.40.0
    # via -r cibuildwheel/resources/constraints.in
-wheel==0.37.1
-    # via
-    #   -r cibuildwheel/resources/constraints.in
-    #   delocate

 # The following packages are considered to be unsafe in a requirements file:
-pip==22.3
+pip==23.1
    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.5.0
+setuptools==67.6.1
    # via -r cibuildwheel/resources/constraints.in
@@ -1,28 +1,28 @@
 #
-# This file is autogenerated by pip-compile with python 3.9
-# To update, run:
+# This file is autogenerated by pip-compile with Python 3.9
+# by the following command:
 #
 #    nox -s update_constraints-3.9
 #
-delocate==0.10.2
+delocate==0.10.4
    # via -r cibuildwheel/resources/constraints.in
 distlib==0.3.6
    # via virtualenv
-filelock==3.8.0
+filelock==3.11.0
    # via virtualenv
-platformdirs==2.5.2
-    # via virtualenv
-typing-extensions==4.4.0
+packaging==23.1
    # via delocate
-virtualenv==20.16.5
+platformdirs==3.2.0
+    # via virtualenv
+typing-extensions==4.5.0
+    # via delocate
+virtualenv==20.21.0
+    # via -r cibuildwheel/resources/constraints.in
+wheel==0.40.0
    # via -r cibuildwheel/resources/constraints.in
-wheel==0.37.1
-    # via
-    #   -r cibuildwheel/resources/constraints.in
-    #   delocate

 # The following packages are considered to be unsafe in a requirements file:
-pip==22.3
+pip==23.1
    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.5.0
+setuptools==67.6.1
    # via -r cibuildwheel/resources/constraints.in
@@ -1,28 +1,28 @@
 #
-# This file is autogenerated by pip-compile with python 3.11
-# To update, run:
+# This file is autogenerated by pip-compile with Python 3.11
+# by the following command:
 #
 #    nox -s update_constraints-3.11
 #
-delocate==0.10.2
+delocate==0.10.4
    # via -r cibuildwheel/resources/constraints.in
 distlib==0.3.6
    # via virtualenv
-filelock==3.8.0
+filelock==3.11.0
    # via virtualenv
-platformdirs==2.5.2
-    # via virtualenv
-typing-extensions==4.4.0
+packaging==23.1
    # via delocate
-virtualenv==20.16.5
+platformdirs==3.2.0
+    # via virtualenv
+typing-extensions==4.5.0
+    # via delocate
+virtualenv==20.21.0
+    # via -r cibuildwheel/resources/constraints.in
+wheel==0.40.0
    # via -r cibuildwheel/resources/constraints.in
-wheel==0.37.1
-    # via
-    #   -r cibuildwheel/resources/constraints.in
-    #   delocate

 # The following packages are considered to be unsafe in a requirements file:
-pip==22.3
+pip==23.1
    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.5.0
+setuptools==67.6.1
    # via -r cibuildwheel/resources/constraints.in
@@ -4,7 +4,7 @@ skip = ""
 test-skip = ""

 archs = ["auto"]
-build-frontend = "pip"
+build-frontend = "default"
 config-settings = {}
 dependency-versions = "pinned"
 environment = {}
@@ -1,49 +1,49 @@
 [x86_64]
-manylinux1 = quay.io/pypa/manylinux1_x86_64:2022-10-15-7701e25
+manylinux1 = quay.io/pypa/manylinux1_x86_64:2023-04-16-36ed6a7
 manylinux2010 = quay.io/pypa/manylinux2010_x86_64:2022-08-05-4535177
-manylinux2014 = quay.io/pypa/manylinux2014_x86_64:2022-10-25-fbea779
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_x86_64:2022-10-25-fbea779
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_x86_64:2022-10-25-fbea779
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_x86_64:2022-10-25-fbea779
+manylinux2014 = quay.io/pypa/manylinux2014_x86_64:2023-04-16-157f52a
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_x86_64:2022-12-26-0d38463
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_x86_64:2023-04-16-157f52a
+musllinux_1_1 = quay.io/pypa/musllinux_1_1_x86_64:2023-04-16-157f52a

 [i686]
-manylinux1 = quay.io/pypa/manylinux1_i686:2022-10-15-7701e25
+manylinux1 = quay.io/pypa/manylinux1_i686:2023-04-16-36ed6a7
 manylinux2010 = quay.io/pypa/manylinux2010_i686:2022-08-05-4535177
-manylinux2014 = quay.io/pypa/manylinux2014_i686:2022-10-25-fbea779
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_i686:2022-10-25-fbea779
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_i686:2022-10-25-fbea779
+manylinux2014 = quay.io/pypa/manylinux2014_i686:2023-04-16-157f52a
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_i686:2022-12-26-0d38463
+musllinux_1_1 = quay.io/pypa/musllinux_1_1_i686:2023-04-16-157f52a

 [pypy_x86_64]
 manylinux2010 = quay.io/pypa/manylinux2010_x86_64:2022-08-05-4535177
-manylinux2014 = quay.io/pypa/manylinux2014_x86_64:2022-10-25-fbea779
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_x86_64:2022-10-25-fbea779
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_x86_64:2022-10-25-fbea779
+manylinux2014 = quay.io/pypa/manylinux2014_x86_64:2023-04-16-157f52a
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_x86_64:2022-12-26-0d38463
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_x86_64:2023-04-16-157f52a

 [pypy_i686]
 manylinux2010 = quay.io/pypa/manylinux2010_i686:2022-08-05-4535177
-manylinux2014 = quay.io/pypa/manylinux2014_i686:2022-10-25-fbea779
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_i686:2022-10-25-fbea779
+manylinux2014 = quay.io/pypa/manylinux2014_i686:2023-04-16-157f52a
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_i686:2022-12-26-0d38463

 [aarch64]
-manylinux2014 = quay.io/pypa/manylinux2014_aarch64:2022-10-25-fbea779
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_aarch64:2022-10-25-fbea779
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_aarch64:2022-10-25-fbea779
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_aarch64:2022-10-25-fbea779
+manylinux2014 = quay.io/pypa/manylinux2014_aarch64:2023-04-16-157f52a
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_aarch64:2022-12-26-0d38463
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_aarch64:2023-04-16-157f52a
+musllinux_1_1 = quay.io/pypa/musllinux_1_1_aarch64:2023-04-16-157f52a

 [ppc64le]
-manylinux2014 = quay.io/pypa/manylinux2014_ppc64le:2022-10-25-fbea779
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_ppc64le:2022-10-25-fbea779
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_ppc64le:2022-10-25-fbea779
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_ppc64le:2022-10-25-fbea779
+manylinux2014 = quay.io/pypa/manylinux2014_ppc64le:2023-04-16-157f52a
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_ppc64le:2022-12-26-0d38463
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_ppc64le:2023-04-16-157f52a
+musllinux_1_1 = quay.io/pypa/musllinux_1_1_ppc64le:2023-04-16-157f52a

 [s390x]
-manylinux2014 = quay.io/pypa/manylinux2014_s390x:2022-10-25-fbea779
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_s390x:2022-10-25-fbea779
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_s390x:2022-10-25-fbea779
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_s390x:2022-10-25-fbea779
+manylinux2014 = quay.io/pypa/manylinux2014_s390x:2023-04-16-157f52a
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_s390x:2022-12-26-0d38463
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_s390x:2023-04-16-157f52a
+musllinux_1_1 = quay.io/pypa/musllinux_1_1_s390x:2023-04-16-157f52a

 [pypy_aarch64]
-manylinux2014 = quay.io/pypa/manylinux2014_aarch64:2022-10-25-fbea779
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_aarch64:2022-10-25-fbea779
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_aarch64:2022-10-25-fbea779
+manylinux2014 = quay.io/pypa/manylinux2014_aarch64:2023-04-16-157f52a
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_aarch64:2022-12-26-0d38463
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_aarch64:2023-04-16-157f52a

@@ -0,0 +1,17 @@
+# this file is copied to the testing cwd, to raise the below error message if
+# pytest/unittest is run from there.
+
+import unittest
+
+
+class TestStringMethods(unittest.TestCase):
+    def test_fail(self):
+        self.fail(
+            "cibuildwheel executes tests from a different working directory to "
+            "your project. This ensures only your wheel is imported, preventing "
+            "Python from accessing files that haven't been packaged into the "
+            "wheel. Please specify a path to your tests when invoking pytest "
+            "using the {project} placeholder, e.g. `pytest {project}` or "
+            "`pytest {project}/tests`. cibuildwheel will replace {project} with "
+            "the path to your project."
+        )
@@ -1,2 +1,2 @@
-version = "20.16.5"
-url = "https://github.com/pypa/get-virtualenv/blob/20.16.5/public/virtualenv.pyz?raw=true"
+version = "20.21.0"
+url = "https://github.com/pypa/get-virtualenv/blob/20.21.0/public/virtualenv.pyz?raw=true"
@@ -42,3 +42,9 @@ else:

 PlatformName = Literal["linux", "macos", "windows"]
 PLATFORMS: Final[set[PlatformName]] = {"linux", "macos", "windows"}
+
+
+class GenericPythonConfiguration(Protocol):
+    @property
+    def identifier(self) -> str:
+        ...
@@ -11,23 +11,15 @@ import subprocess
 import sys
 import textwrap
 import time
+import typing
 import urllib.request
+from collections.abc import Generator, Iterable, Mapping, Sequence
 from dataclasses import dataclass
 from enum import Enum
 from functools import lru_cache
 from pathlib import Path, PurePath
 from time import sleep
-from typing import (
-    Any,
-    ClassVar,
-    Generator,
-    Iterable,
-    Sequence,
-    TextIO,
-    TypeVar,
-    cast,
-    overload,
-)
+from typing import Any, ClassVar, TextIO, TypeVar

 import bracex
 import certifi
@@ -67,8 +59,19 @@ resources_dir: Final[Path] = Path(__file__).parent / "resources"

 install_certifi_script: Final[Path] = resources_dir / "install_certifi.py"

+test_fail_cwd_file: Final[Path] = resources_dir / "testing_temp_dir_file.py"
+
 BuildFrontend = Literal["pip", "build"]

+
+def build_frontend_or_default(
+    setting: BuildFrontend | Literal["default"], default: BuildFrontend = "pip"
+) -> BuildFrontend:
+    if setting == "default":
+        return default
+    return setting
+
+
 MANYLINUX_ARCHS: Final[tuple[str, ...]] = (
    "x86_64",
    "i686",
@@ -96,20 +99,20 @@ CIBW_CACHE_PATH: Final[Path] = Path(
 IS_WIN: Final[bool] = sys.platform.startswith("win")


-@overload
+@typing.overload
 def call(
    *args: PathOrStr,
-    env: dict[str, str] | None = None,
+    env: Mapping[str, str] | None = None,
    cwd: PathOrStr | None = None,
    capture_stdout: Literal[False] = ...,
 ) -> None:
    ...


-@overload
+@typing.overload
 def call(
    *args: PathOrStr,
-    env: dict[str, str] | None = None,
+    env: Mapping[str, str] | None = None,
    cwd: PathOrStr | None = None,
    capture_stdout: Literal[True],
 ) -> str:
@@ -118,7 +121,7 @@ def call(

 def call(
    *args: PathOrStr,
-    env: dict[str, str] | None = None,
+    env: Mapping[str, str] | None = None,
    cwd: PathOrStr | None = None,
    capture_stdout: bool = False,
 ) -> str | None:
@@ -138,10 +141,12 @@ def call(
    result = subprocess.run(args_, check=True, shell=IS_WIN, env=env, cwd=cwd, **kwargs)
    if not capture_stdout:
        return None
-    return cast(str, result.stdout)
+    return typing.cast(str, result.stdout)


-def shell(*commands: str, env: dict[str, str] | None = None, cwd: PathOrStr | None = None) -> None:
+def shell(
+    *commands: str, env: Mapping[str, str] | None = None, cwd: PathOrStr | None = None
+) -> None:
    command = " ".join(commands)
    print(f"+ {command}")
    subprocess.run(command, env=env, cwd=cwd, shell=True, check=True)
@@ -206,9 +211,10 @@ def get_build_verbosity_extra_flags(level: int) -> list[str]:
        return []


-def split_config_settings(config_settings: str) -> list[str]:
+def split_config_settings(config_settings: str, frontend: Literal["pip", "build"]) -> list[str]:
    config_settings_list = shlex.split(config_settings)
-    return [f"--config-setting={setting}" for setting in config_settings_list]
+    s = "s" if frontend == "pip" else ""
+    return [f"--config-setting{s}={setting}" for setting in config_settings_list]


 def read_python_configs(config: PlatformName) -> list[dict[str, str]]:
@@ -270,6 +276,14 @@ class BuildSelector:

        return should_build and not should_skip

+    def options_summary(self) -> Any:
+        return {
+            "build_config": self.build_config,
+            "skip_config": self.skip_config,
+            "requires_python": str(self.requires_python),
+            "prerelease_pythons": self.prerelease_pythons,
+        }
+

@dataclass(frozen=True)
 class TestSelector:
@@ -283,6 +297,9 @@ class TestSelector:
        should_skip = selector_matches(self.skip_config, build_id)
        return not should_skip

+    def options_summary(self) -> Any:
+        return {"skip_config": self.skip_config}
+

 # Taken from https://stackoverflow.com/a/107717
 class Unbuffered:
@@ -356,6 +373,12 @@ class DependencyConstraints:

        return self.base_file_path == o.base_file_path

+    def options_summary(self) -> Any:
+        if self == DependencyConstraints.with_defaults():
+            return "pinned"
+        else:
+            return self.base_file_path.name
+

 class NonPlatformWheelError(Exception):
    def __init__(self) -> None:
@@ -478,7 +501,7 @@ def print_new_wheels(msg: str, output_dir: Path) -> Generator[None, None, None]:
    )


-def get_pip_version(env: dict[str, str]) -> str:
+def get_pip_version(env: Mapping[str, str]) -> str:
    versions_output_text = call(
        "python", "-m", "pip", "freeze", "--all", capture_stdout=True, env=env
    )
@@ -524,8 +547,8 @@ def _parse_constraints_for_virtualenv(
        constraint_path = Path(dependency_constraint_flags[1])
        assert constraint_path.exists()
        with constraint_path.open(encoding="utf-8") as constraint_file:
-            for line in constraint_file:
-                line = line.strip()
+            for line_ in constraint_file:
+                line = line_.strip()
                if not line:
                    continue
                if line.startswith("#"):
@@ -587,7 +610,7 @@ def virtualenv(
    else:
        paths = [str(venv_path / "bin")]
    env = os.environ.copy()
-    env["PATH"] = os.pathsep.join(paths + [env["PATH"]])
+    env["PATH"] = os.pathsep.join([*paths, env["PATH"]])
    return env


@@ -629,7 +652,7 @@ def find_compatible_wheel(wheels: Sequence[T], identifier: str) -> T | None:
                    continue
            else:
                # Windows should exactly match
-                if not tag.platform == platform:
+                if tag.platform != platform:
                    continue

            # If all the filters above pass, then the wheel is a previously built compatible wheel.
@@ -655,3 +678,31 @@ def chdir(new_path: Path | str) -> Generator[None, None, None]:
        yield
    finally:
        os.chdir(cwd)
+
+
+def fix_ansi_codes_for_github_actions(text: str) -> str:
+    """
+    Github Actions forgets the current ANSI style on every new line. This
+    function repeats the current ANSI style on every new line.
+    """
+    ansi_code_regex = re.compile(r"(\033\[[0-9;]*m)")
+    ansi_codes: list[str] = []
+    output = ""
+
+    for line in text.splitlines(keepends=True):
+        # add the current ANSI codes to the beginning of the line
+        output += "".join(ansi_codes) + line
+
+        # split the line at each ANSI code
+        parts = ansi_code_regex.split(line)
+        # if there are any ANSI codes, save them
+        if len(parts) > 1:
+            # iterate over the ANSI codes in this line
+            for code in parts[1::2]:
+                if code == "\033[0m":
+                    # reset the list of ANSI codes when the clear code is found
+                    ansi_codes = []
+                else:
+                    ansi_codes.append(code)
+
+    return output
@@ -6,10 +6,11 @@ import shutil
 import subprocess
 import sys
 import textwrap
+from collections.abc import MutableMapping, Sequence, Set
+from contextlib import suppress
 from dataclasses import dataclass
 from functools import lru_cache
 from pathlib import Path
-from typing import Sequence
 from zipfile import ZipFile

 from filelock import FileLock
@@ -26,6 +27,7 @@ from .util import (
    BuildFrontend,
    BuildSelector,
    NonPlatformWheelError,
+    build_frontend_or_default,
    call,
    download,
    find_compatible_wheel,
@@ -35,6 +37,7 @@ from .util import (
    read_python_configs,
    shell,
    split_config_settings,
+    test_fail_cwd_file,
    unwrap,
    virtualenv,
 )
@@ -70,9 +73,8 @@ class PythonConfiguration:

 def get_python_configurations(
    build_selector: BuildSelector,
-    architectures: set[Architecture],
+    architectures: Set[Architecture],
 ) -> list[PythonConfiguration]:
-
    full_python_configs = read_python_configs("windows")

    python_configurations = [PythonConfiguration(**item) for item in full_python_configs]
@@ -115,7 +117,8 @@ def install_cpython(version: str, arch: str) -> Path:


 def install_pypy(tmp: Path, arch: str, url: str) -> Path:
-    assert arch == "64" and "win64" in url
+    assert arch == "64"
+    assert "win64" in url
    # Inside the PyPy zip file is a directory with the same name
    zip_filename = url.rsplit("/", 1)[-1]
    extension = ".zip"
@@ -134,7 +137,7 @@ def setup_setuptools_cross_compile(
    tmp: Path,
    python_configuration: PythonConfiguration,
    python_libs_base: Path,
-    env: dict[str, str],
+    env: MutableMapping[str, str],
 ) -> None:
    distutils_cfg = tmp / "extra-setup.cfg"
    env["DIST_EXTRA_CONFIG"] = str(distutils_cfg)
@@ -177,13 +180,12 @@ def setup_setuptools_cross_compile(
    env["SETUPTOOLS_USE_DISTUTILS"] = "local"


-# these cross-compile setup functions have the same signature by design
-# pylint: disable=unused-argument
+# These cross-compile setup functions have the same signature by design
 def setup_rust_cross_compile(
-    tmp: Path,
+    tmp: Path,  # noqa: ARG001
    python_configuration: PythonConfiguration,
-    python_libs_base: Path,
-    env: dict[str, str],
+    python_libs_base: Path,  # noqa: ARG001
+    env: MutableMapping[str, str],
 ) -> None:
    # Assume that MSVC will be used, because we already know that we are
    # cross-compiling. MinGW users can set CARGO_BUILD_TARGET themselves
@@ -366,6 +368,7 @@ def build(options: Options, tmp_path: Path) -> None:

        for config in python_configurations:
            build_options = options.build_options(config.identifier)
+            build_frontend = build_frontend_or_default(build_options.build_frontend)
            log.build_start(config.identifier)

            identifier_tmp_dir = tmp_path / config.identifier
@@ -386,7 +389,7 @@ def build(options: Options, tmp_path: Path) -> None:
                config,
                dependency_constraint_flags,
                build_options.environment,
-                build_options.build_frontend,
+                build_frontend,
            )

            compatible_wheel = find_compatible_wheel(built_wheels, config.identifier)
@@ -410,11 +413,10 @@ def build(options: Options, tmp_path: Path) -> None:
                log.step("Building wheel...")
                built_wheel_dir.mkdir()

-                verbosity_flags = get_build_verbosity_extra_flags(build_options.build_verbosity)
-                extra_flags = split_config_settings(build_options.config_settings)
+                extra_flags = split_config_settings(build_options.config_settings, build_frontend)

-                if build_options.build_frontend == "pip":
-                    extra_flags += verbosity_flags
+                if build_frontend == "pip":
+                    extra_flags += get_build_verbosity_extra_flags(build_options.build_verbosity)
                    # Path.resolve() is needed. Without it pip wheel may try to fetch package from pypi.org
                    # see https://github.com/pypa/cibuildwheel/pull/369
                    call(
@@ -428,9 +430,10 @@ def build(options: Options, tmp_path: Path) -> None:
                        *extra_flags,
                        env=env,
                    )
-                elif build_options.build_frontend == "build":
-                    verbosity_setting = " ".join(verbosity_flags)
-                    extra_flags += (f"--config-setting={verbosity_setting}",)
+                elif build_frontend == "build":
+                    if not 0 <= build_options.build_verbosity < 2:
+                        msg = f"build_verbosity {build_options.build_verbosity} is not supported for build frontend. Ignoring."
+                        log.warning(msg)
                    build_env = env.copy()
                    if build_options.dependency_constraints:
                        constraints_path = (
@@ -461,7 +464,7 @@ def build(options: Options, tmp_path: Path) -> None:
                            env=build_env,
                        )
                else:
-                    assert_never(build_options.build_frontend)
+                    assert_never(build_frontend)

                built_wheel = next(built_wheel_dir.glob("*.whl"))

@@ -487,20 +490,19 @@ def build(options: Options, tmp_path: Path) -> None:
                if repaired_wheel.name in {wheel.name for wheel in built_wheels}:
                    raise AlreadyBuiltWheelError(repaired_wheel.name)

-            if build_options.test_command and options.globals.test_selector(config.identifier):
-                if config.arch == "ARM64" != platform_module.machine():
-                    log.warning(
-                        unwrap(
-                            """
+            test_selected = options.globals.test_selector(config.identifier)
+            if test_selected and config.arch == "ARM64" != platform_module.machine():
+                log.warning(
+                    unwrap(
+                        """
                            While arm64 wheels can be built on other platforms, they cannot
                            be tested. An arm64 runner is required. To silence this warning,
                            set `CIBW_TEST_SKIP: *-win_arm64`.
                            """
-                        )
                    )
-                    # skip this test
-                    continue
-
+                )
+                # skip this test
+            elif test_selected and build_options.test_command:
                log.step("Testing wheel...")
                # set up a virtual environment to install and test from, to make sure
                # there are no dependencies that were pulled in at build time.
@@ -542,7 +544,7 @@ def build(options: Options, tmp_path: Path) -> None:
                if build_options.test_requires:
                    call("pip", "install", *build_options.test_requires, env=virtualenv_env)

-                # run the tests from c:\, with an absolute path in the command
+                # run the tests from a temp dir, with an absolute path in the command
                # (this ensures that Python runs the tests against the installed wheel
                # and not the repo code)
                test_command_prepared = prepare_command(
@@ -550,10 +552,17 @@ def build(options: Options, tmp_path: Path) -> None:
                    project=Path(".").resolve(),
                    package=options.globals.package_dir.resolve(),
                )
-                shell(test_command_prepared, cwd="c:\\", env=virtualenv_env)
+                test_cwd = identifier_tmp_dir / "test_cwd"
+                test_cwd.mkdir()
+                (test_cwd / "test_fail.py").write_text(test_fail_cwd_file.read_text())
+
+                shell(test_command_prepared, cwd=test_cwd, env=virtualenv_env)

            # we're all done here; move it to output (remove if already exists)
            if compatible_wheel is None:
+                with suppress(FileNotFoundError):
+                    (build_options.output_dir / repaired_wheel.name).unlink()
+
                shutil.move(str(repaired_wheel), build_options.output_dir)
                built_wheels.append(build_options.output_dir / repaired_wheel.name)

@@ -4,6 +4,44 @@ title: Changelog

 # Changelog

+### v2.12.2
+
+_18 April 2023_
+
+- 🐛 Fix a bug that caused an extra empty config-setting to be passed to the backend when CIBW_BUILD_FRONTEND is set to `build`. (#1474)
+- 🐛 Fix a crash that occurred when overwriting an existing wheel on Windows. (#1464)
+- 🛠 Pinned version updates, including CPython 3.10.11, 3.11.3, pip 23.1 and wheel 0.40.0.
+
+### v2.12.1
+
+_11 March 2023_
+
+- 🐛 Fix a bug that prevented the use of CIBW_CONFIG_SETTINGS with the 'pip' build backend. (#1430)
+
+### v2.12.0
+
+_16 Jan 2023_
+
+- ✨ Adds support for PyPy arm64 wheels. This means that you can build PyPy wheels for Apple Silicon machines. Cross-compilation is not supported for these wheels, so you'll have to build on an Apple Silicon machine. (#1372)
+- 🛠 Pinned version updates, including PyPy to v7.3.11 and setuptools to 66.0.0.
+
+### v2.11.4
+
+_24 Dec 2022_
+
+- 🐛 Fix a bug that caused missing wheels on Windows when a test was skipped using CIBW_TEST_SKIP (#1377)
+- 🛠 Updates CPython 3.11 to 3.11.1 (#1371)
+- 🛠 Updates PyPy to 7.3.10, except on macOS which remains on 7.3.9 due to a bug on that platform. (#1371)
+- 📚 Added a reference to abi3audit to the docs (#1347)
+
+### v2.11.3
+
+_5 Dec 2022_
+
+- ✨ Improves the 'build options' log output that's printed at the start of each run (#1352)
+- ✨ Added a friendly error message to a common misconfiguration of the `CIBW_TEST_COMMAND` option - not specifying path using the `{project}` placeholder (#1336)
+- 🛠 The GitHub Action now uses Powershell on Windows to avoid occasional incompabilities with bash (#1346)
+
 ### v2.11.2

 _26 October 2022_
@@ -401,9 +401,9 @@
 - name: pillow-heif
  gh: bigcat88/pillow_heif
  pypi: pillow-heif
-  ci: [github]
-  os: [apple, linux]
-  notes: Python CFFI binding to libheif library with third party dependencies like `libde265`, `x265`, `libaom` with test & publishing on PyPi.
+  ci: [github, cirrusci]
+  os: [apple, linux, windows]
+  notes: Bindings to libheif library with third party dependencies. Fully automated CI for tests and publishing including Apple Silicon builds.

 - name: clang-format
  gh: ssciwr/clang-format-wheel
@@ -431,11 +431,6 @@
  ci: [github]
  os: [apple, linux, windows]

- name: pydantic
-  gh: samuelcolvin/pydantic
-  ci: [github]
-  os: [apple, linux, windows]
-
 - name: vaex
  gh: vaexio/vaex
  ci: [github]
@@ -621,3 +616,10 @@
  os: [windows, apple, linux]
  pypi: pyril
  notes: A python binding to Rust Imaging library using maturin and Pyo3, utilizes Github Action cache to improve speed. Builds abi3 wheels.
+
+- name: Picologging
+  gh: microsoft/picologging
+  ci: [github]
+  os: [windows, apple, linux]
+  pypi: picologging
+  notes: A high-performance logging library for Python.
@@ -118,6 +118,8 @@ The CPython Limited API is a subset of the Python C Extension API that's declare

 To create a package that builds ABI3 wheels, you'll need to configure your build backend to compile libraries correctly create wheels with the right tags. [Check this repo](https://github.com/joerick/python-abi3-package-sample) for an example of how to do this with setuptools.

+You could also consider running [abi3audit](https://github.com/trailofbits/abi3audit) against the produced wheels in order to check for abi3 violations or inconsistencies. You can run it alongside the default in your [CIBW_REPAIR_WHEEL_COMMAND](options.md#repair-wheel-command).
+
 ### Packages with optional C extensions {: #optional-extensions}

 `cibuildwheel` defines the environment variable `CIBUILDWHEEL` to the value `1` allowing projects for which the C extension is optional to make it mandatory when building wheels.
@@ -143,7 +145,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@v2.11.2
+uses: pypa/cibuildwheel@v2.12.2
 ```

 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.
@@ -165,7 +167,7 @@ The second option, and the only one that supports other CI systems, is using a `

 ```bash
 # requirements-cibw.txt
-cibuildwheel==2.11.2
+cibuildwheel==2.12.2
 ```

 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:
@@ -309,7 +311,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==2.11.2 --output-dir wheelhouse
+pipx run cibuildwheel==2.12.2 --output-dir wheelhouse
 pipx run twine upload wheelhouse/*.whl
 ```

@@ -227,8 +227,8 @@ When setting the options, you can use shell-style globbing syntax, as per [fnmat
 | Python 3.10  | cp310-macosx_x86_64<br/>cp310-macosx_universal2<br/>cp310-macosx_arm64 | cp310-win_amd64<br/>cp310-win32<br/>cp310-win_arm64 | cp310-manylinux_x86_64<br/>cp310-manylinux_i686<br/>cp310-musllinux_x86_64<br/>cp310-musllinux_i686 | cp310-manylinux_aarch64<br/>cp310-manylinux_ppc64le<br/>cp310-manylinux_s390x<br/>cp310-musllinux_aarch64<br/>cp310-musllinux_ppc64le<br/>cp310-musllinux_s390x |
 | Python 3.11  | cp311-macosx_x86_64<br/>cp311-macosx_universal2<br/>cp311-macosx_arm64 | cp311-win_amd64<br/>cp311-win32<br/>cp311-win_arm64 | cp311-manylinux_x86_64<br/>cp311-manylinux_i686<br/>cp311-musllinux_x86_64<br/>cp311-musllinux_i686 | cp311-manylinux_aarch64<br/>cp311-manylinux_ppc64le<br/>cp311-manylinux_s390x<br/>cp311-musllinux_aarch64<br/>cp311-musllinux_ppc64le<br/>cp311-musllinux_s390x |
 | PyPy3.7 v7.3 | pp37-macosx_x86_64                                                     | pp37-win_amd64                                      | pp37-manylinux_x86_64<br/>pp37-manylinux_i686                                                       | pp37-manylinux_aarch64                                                                                                                                          |
-| PyPy3.8 v7.3 | pp38-macosx_x86_64                                                     | pp38-win_amd64                                      | pp38-manylinux_x86_64<br/>pp38-manylinux_i686                                                       | pp38-manylinux_aarch64                                                                                                                                          |
-| PyPy3.9 v7.3 | pp39-macosx_x86_64                                                     | pp39-win_amd64                                      | pp39-manylinux_x86_64<br/>pp39-manylinux_i686                                                       | pp39-manylinux_aarch64                                                                                                                                          |
+| PyPy3.8 v7.3 | pp38-macosx_x86_64<br/>pp38-macosx_arm64                               | pp38-win_amd64                                      | pp38-manylinux_x86_64<br/>pp38-manylinux_i686                                                       | pp38-manylinux_aarch64                                                                                                                                          |
+| PyPy3.9 v7.3 | pp39-macosx_x86_64<br/>pp39-macosx_arm64                               | pp39-win_amd64                                      | pp39-manylinux_x86_64<br/>pp39-manylinux_i686                                                       | pp39-manylinux_aarch64                                                                                                                                          |

 The list of supported and currently selected build identifiers can also be retrieved by passing the `--print-build-identifiers` flag to cibuildwheel.
 The format is `python_tag-platform_tag`, with tags similar to those in [PEP 425](https://www.python.org/dev/peps/pep-0425/#details).
@@ -898,6 +898,18 @@ Platform-specific environment variables are also available:<br/>
      python scripts/check_repaired_wheel.py -w {dest_dir} {wheel}
    ```

+    ```yaml
+    # Use abi3audit to catch issues with Limited API wheels
+    CIBW_REPAIR_WHEEL_COMMAND_LINUX: >
+      auditwheel repair -w {dest_dir} {wheel} &&
+      pipx run abi3audit --strict --report {wheel}
+    CIBW_REPAIR_WHEEL_COMMAND_MACOS: >
+      delocate-wheel --require-archs {delocate_archs} -w {dest_dir} -v {wheel} &&
+      pipx run abi3audit --strict --report {wheel}
+    CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: >
+      pipx run abi3audit --strict --report {wheel}
+    ```
+
 !!! tab examples "pyproject.toml"

    ```toml
@@ -922,6 +934,22 @@ Platform-specific environment variables are also available:<br/>
    ]
    ```

+    ```toml
+    # Use abi3audit to catch issues with Limited API wheels
+    [tool.cibuildwheel.linux]
+    repair-wheel-command = [
+      "auditwheel repair -w {dest_dir} {wheel}",
+      "pipx run abi3audit --strict --report {wheel}",
+    ]
+    [tool.cibuildwheel.macos]
+    repair-wheel-command = [
+      "delocate-wheel --require-archs {delocate_archs} -w {dest_dir} -v {wheel}",
+      "pipx run abi3audit --strict --report {wheel}",
+    ]
+    [tool.cibuildwheel.windows]
+    repair-wheel-command = "pipx run abi3audit --strict --report {wheel}"
+    ```
+
    In configuration mode, you can use an inline array, and the items will be joined with `&&`.


@@ -1186,6 +1214,13 @@ Platform-specific environment variables are also available:<br/>

    In configuration files, you can use an array, and the items will be joined with `&&`.

+!!! note
+
+    It's isn't recommended to `cd` to your project directory before running tests,
+    because Python might resolve `import yourpackage` relative to the working dir,
+    and we want to test the wheel you just built. However, if you're sure that's not
+    an issue for you and your workflow requires it, on Windows you should do `cd /d`,
+    because the CWD and project dir might be on different drives.

 ### `CIBW_BEFORE_TEST` {: #before-test}
 > Execute a shell command before testing each wheel
@@ -1358,7 +1393,7 @@ This option is not supported in the overrides section in `pyproject.toml`.
 ### `CIBW_BUILD_VERBOSITY` {: #build-verbosity}
 > Increase/decrease the output of pip wheel

-An number from 1 to 3 to increase the level of verbosity (corresponding to invoking pip with `-v`, `-vv`, and `-vvv`), between -1 and -3 (`-q`, `-qq`, and `-qqq`), or just 0 (default verbosity). These flags are useful while debugging a build when the output of the actual build invoked by `pip wheel` is required.
+An number from 1 to 3 to increase the level of verbosity (corresponding to invoking pip with `-v`, `-vv`, and `-vvv`), between -1 and -3 (`-q`, `-qq`, and `-qqq`), or just 0 (default verbosity). These flags are useful while debugging a build when the output of the actual build invoked by `pip wheel` is required. Has no effect on the `build` backend, which produces verbose output by default.

 Platform-specific environment variables are also available:<br/>
 `CIBW_BUILD_VERBOSITY_MACOS` | `CIBW_BUILD_VERBOSITY_WINDOWS` | `CIBW_BUILD_VERBOSITY_LINUX`
@@ -184,7 +184,7 @@ To build Linux, Mac, and Windows wheels using GitHub Actions, create a `.github/
          - uses: actions/checkout@v3

          - name: Build wheels
-            run: pipx run cibuildwheel==2.11.2
+            run: pipx run cibuildwheel==2.12.2

          - uses: actions/upload-artifact@v3
            with:
@@ -219,7 +219,7 @@ To build Linux, Mac, and Windows wheels using GitHub Actions, create a `.github/
          - uses: actions/setup-python@v3

          - name: Install cibuildwheel
-            run: python -m pip install cibuildwheel==2.11.2
+            run: python -m pip install cibuildwheel==2.12.2

          - name: Build wheels
            run: python -m cibuildwheel --output-dir wheelhouse
@@ -10,21 +10,21 @@ title: Working examples
 |-----------------------------------|----|----|:------|
 | [scikit-learn][]                  | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | The machine learning library. A complex but clean config using many of cibuildwheel's features to build a large project with Cython and C++ extensions.  |
 | [NumPy][]                         | ![github icon][] ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | The fundamental package for scientific computing with Python. |
-| [Tornado][]                       | ![travisci icon][] | ![apple icon][] ![linux icon][] | Tornado is a Python web framework and asynchronous networking library, originally developed at FriendFeed. |
 | [pytorch-fairseq][]               | ![github icon][] | ![apple icon][] ![linux icon][] | Facebook AI Research Sequence-to-Sequence Toolkit written in Python. |
+| [Tornado][]                       | ![travisci icon][] | ![apple icon][] ![linux icon][] | Tornado is a Python web framework and asynchronous networking library, originally developed at FriendFeed. |
 | [Matplotlib][]                    | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | The venerable Matplotlib, a Python library with C++ portions |
 | [NCNN][]                          | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | ncnn is a high-performance neural network inference framework optimized for the mobile platform |
 | [Kivy][]                          | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Open source UI framework written in Python, running on Windows, Linux, macOS, Android and iOS |
 | [Prophet][]                       | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Tool for producing high quality forecasts for time series data that has multiple seasonality with linear or non-linear growth. |
 | [MyPy][]                          | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | The compiled version of MyPy using MyPyC. |
-| [pydantic][]                      | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Data parsing and validation using Python type hints |
 | [MemRay][]                        | ![github icon][] | ![linux icon][] | Memray is a memory profiler for Python |
+| [duckdb][]                        | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | DuckDB is an in-process SQL OLAP Database Management System |
 | [uvloop][]                        | ![github icon][] | ![apple icon][] ![linux icon][] | Ultra fast asyncio event loop. |
 | [psutil][]                        | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Cross-platform lib for process and system monitoring in Python |
 | [vaex][]                          | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Out-of-Core hybrid Apache Arrow/NumPy DataFrame for Python, ML, visualization and exploration of big tabular data at a billion rows per second 🚀 |
-| [duckdb][]                        | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | DuckDB is an in-process SQL OLAP Database Management System |
 | [Google Benchmark][]              | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | A microbenchmark support library |
 | [Apache Beam][]                   | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Apache Beam is a unified programming model for Batch and Streaming data processing. |
+| [Triton][]                        | ![github icon][] | ![linux icon][] | Self hosted runners |
 | [asyncpg][]                       | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | A fast PostgreSQL Database Client Library for Python/asyncio. |
 | [PyGame][]                        | ![github icon][] | ![apple icon][] ![linux icon][] | 🐍🎮 pygame (the library) is a Free and Open Source python programming language library for making multimedia applications like games built on top of the excellent SDL library. C, Python, Native, OpenGL. |
 | [cmake][]                         | ![github icon][] ![travisci icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Multitagged binary builds for all supported platforms, using cibw 2 config configuration. |
@@ -33,12 +33,11 @@ title: Working examples
 | [PyOxidizer][]                    | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | A modern Python application packaging and distribution tool |
 | [websockets][]                    | ![travisci icon][] | ![apple icon][] ![linux icon][] | Library for building WebSocket servers and clients. Mostly written in Python, with a small C 'speedups' extension module.  |
 | [cvxpy][]                         | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | A Python-embedded modeling language for convex optimization problems. |
-| [Triton][]                        | ![github icon][] | ![linux icon][] | Self hosted runners |
-| [UltraJSON][]                     | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Ultra fast JSON decoder and encoder written in C with Python bindings |
 | [River][]                         | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | 🌊 Online machine learning in Python |
+| [UltraJSON][]                     | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Ultra fast JSON decoder and encoder written in C with Python bindings |
 | [OpenSpiel][]                     | ![github icon][] | ![apple icon][] ![linux icon][] | OpenSpiel is a collection of environments and algorithms for research in general reinforcement learning and search/planning in games. |
-| [pyzmq][]                         | ![github icon][] ![circleci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Python bindings for zeromq, the networking library. Uses Cython on CPython and CFFI on PyPy. ARM wheels for linux are built natively on CircleCI.  |
 | [aiortc][]                        | ![github icon][] | ![apple icon][] ![linux icon][] | WebRTC and ORTC implementation for Python using asyncio. |
+| [pyzmq][]                         | ![github icon][] ![circleci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Python bindings for zeromq, the networking library. Uses Cython on CPython and CFFI on PyPy. ARM wheels for linux are built natively on CircleCI.  |
 | [Confluent client for Kafka][]    | ![travisci icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | setup in `tools/wheels/build-wheels.bat` |
 | [Implicit][]                      | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Includes GPU support for linux wheels |
 | [vispy][]                         | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Main repository for Vispy |
@@ -49,87 +48,88 @@ title: Working examples
 | [PyYAML][]                        | ![github icon][] | ![apple icon][] | Canonical source repository for PyYAML |
 | [numexpr][]                       | ![github icon][] ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Fast numerical array expression evaluator for Python, NumPy, PyTables, pandas, bcolz and more |
 | [h5py][]                          | ![azurepipelines icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | HDF5 for Python -- The h5py package is a Pythonic interface to the HDF5 binary data format. |
-| [Wrapt][]                         | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A Python module for decorators, wrappers and monkey patching. |
 | [PyAV][]                          | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Pythonic bindings for FFmpeg's libraries. |
-| [pikepdf][]                       | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A Python library for reading and writing PDF, powered by qpdf |
-| [SimpleJSON][]                    | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | simplejson is a simple, fast, extensible JSON encoder/decoder for Python  |
+| [Wrapt][]                         | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A Python module for decorators, wrappers and monkey patching. |
 | [Line Profiler][]                 | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Line-by-line profiling for Python |
+| [pikepdf][]                       | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A Python library for reading and writing PDF, powered by qpdf |
+| [envd][]                          | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | 🏕️ Reproducible development environment for AI/ML |
+| [SimpleJSON][]                    | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | simplejson is a simple, fast, extensible JSON encoder/decoder for Python  |
 | [OpenColorIO][]                   | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | A color management framework for visual effects and animation. |
-| [PyTables][]                      | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A Python package to manage extremely large amounts of data |
-| [OpenTimelineIO][]                | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Open Source API and interchange format for editorial timeline information. |
-| [envd][]                          | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | 🏕️ Development environment for AI/ML |
 | [aioquic][]                       | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | QUIC and HTTP/3 implementation in Python |
+| [OpenTimelineIO][]                | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Open Source API and interchange format for editorial timeline information. |
+| [PyTables][]                      | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A Python package to manage extremely large amounts of data |
 | [ruptures][]                      | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Extensive Cython + NumPy [pyproject.toml](https://github.com/deepcharles/ruptures/blob/master/pyproject.toml) example. |
 | [Psycopg 3][]                     | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A modern implementation of a PostgreSQL adapter for Python |
+| [Parselmouth][]                   | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A Python interface to the Praat software package, using pybind11, C++17 and CMake, with the core Praat static library built only once and shared between wheels. |
 | [DeepForest][]                    | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | An Efficient, Scalable and Optimized Python Framework for Deep Forest (2021.2.1) |
 | [google neuroglancer][]           | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | WebGL-based viewer for volumetric data |
-| [Parselmouth][]                   | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A Python interface to the Praat software package, using pybind11, C++17 and CMake, with the core Praat static library built only once and shared between wheels. |
 | [AutoPy][]                        | ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Includes a Windows Travis build. |
+| [CTranslate2][]                   | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Includes libraries from the [Intel oneAPI toolkit](https://www.intel.com/content/www/us/en/developer/tools/oneapi/base-toolkit.html) and CUDA kernels compiled for multiple GPU architectures. |
 | [H3-py][]                         | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Python bindings for H3, a hierarchical hexagonal geospatial indexing system |
 | [Rtree][]                         | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Rtree: spatial index for Python GIS ¶ |
 | [markupsafe][]                    | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Safely add untrusted strings to HTML/XML markup. |
-| [python-rapidjson][]              | ![travisci icon][] ![gitlab icon][] ![appveyor icon][] | ![windows icon][] ![linux icon][] | Python wrapper around rapidjson |
+| [Picologging][]                   | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A high-performance logging library for Python. |
 | [pybind11 cmake_example][]        | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Example pybind11 module built with a CMake-based build system |
-| [python-snappy][]                 | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Python bindings for the snappy google library |
+| [python-rapidjson][]              | ![travisci icon][] ![gitlab icon][] ![appveyor icon][] | ![windows icon][] ![linux icon][] | Python wrapper around rapidjson |
 | [KDEpy][]                         | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Kernel Density Estimation in Python |
+| [python-snappy][]                 | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Python bindings for the snappy google library |
+| [time-machine][]                  | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Time mocking library using only the CPython C API. |
 | [tgcalls][]                       | ![github icon][] | ![apple icon][] ![windows icon][] | Python `pybind11` binding to Telegram's WebRTC library with third party dependencies like `OpenSSL`, `MozJPEG`, `FFmpeg`, etc. |
 | [pybind11 python_example][]       | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Example pybind11 module built with a Python-based build system |
 | [dd-trace-py][]                   | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Uses custom alternate arch emulation on GitHub |
-| [CTranslate2][]                   | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Includes libraries from the [Intel oneAPI toolkit](https://www.intel.com/content/www/us/en/developer/tools/oneapi/base-toolkit.html) and CUDA kernels compiled for multiple GPU architectures. |
-| [time-machine][]                  | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Time mocking library using only the CPython C API. |
 | [sourmash][]                      | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Quickly search, compare, and analyze genomic and metagenomic data sets. |
 | [cyvcf2][]                        | ![github icon][] | ![apple icon][] ![linux icon][] | cython + htslib == fast VCF and BCF processing |
 | [matrixprofile][]                 | ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A Python 3 library making time series data mining tasks, utilizing matrix profile algorithms, accessible to everyone. |
 | [abess][]                         | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A fast best-subset selection library. It uses cibuildwheel to build a large project with C++ extensions. |
+| [mosec][]                         | ![github icon][] | ![linux icon][] ![apple icon][] | A high-performance serving framework for ML models, offers dynamic batching and multi-stage pipeline to fully exploit your compute machine |
 | [jq.py][]                         | ![travisci icon][] | ![apple icon][] ![linux icon][] | Python bindings for jq |
 | [iminuit][]                       | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Jupyter-friendly Python interface for C++ MINUIT2 |
 | [Tokenizer][]                     | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Fast and customizable text tokenization library with BPE and SentencePiece support |
 | [PyGLM][]                         | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Fast OpenGL Mathematics (GLM) for Python |
-| [mosec][]                         | ![github icon][] | ![linux icon][] ![apple icon][] | A high-performance serving framework for ML models, offers dynamic batching and multi-stage pipeline to fully exploit your compute machine |
-| [bx-python][]                     | ![travisci icon][] | ![apple icon][] ![linux icon][] | A library that includes Cython extensions. |
 | [TgCrypto][]                      | ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Includes a Windows Travis build. |
+| [bx-python][]                     | ![travisci icon][] | ![apple icon][] ![linux icon][] | A library that includes Cython extensions. |
 | [boost-histogram][]               | ![github icon][] ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Supports full range of wheels, including PyPy and alternate archs. |
 | [iDynTree][]                      | ![github icon][] | ![linux icon][] | Uses manylinux_2_24 |
 | [Python-WebRTC][]                 | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | a Python extension that provides bindings to WebRTC M92 |
 | [pybase64][]                      | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Fast Base64 encoding/decoding in Python |
+| [pillow-heif][]                   | ![github icon][] ![cirrusci icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Bindings to libheif library with third party dependencies. Fully automated CI for tests and publishing including Apple Silicon builds. |
 | [Arbor][]                         | ![github icon][] | ![apple icon][] ![linux icon][] | Arbor is a multi-compartment neuron simulation library; compatible with next-generation accelerators; best-practices applied to research software; focused on community-driven development. Includes a [small script](https://github.com/arbor-sim/arbor/blob/master/scripts/patchwheel.py) patching `rpath` in bundled libraries.  |
 | [fathon][]                        | ![travisci icon][] | ![apple icon][] ![linux icon][] | python package for DFA (Detrended Fluctuation Analysis) and related algorithms |
-| [etebase-py][]                    | ![travisci icon][] | ![linux icon][] | Python bindings to a Rust library using `setuptools-rust`, and `sccache` for improved speed. |
-| [polaroid][]                      | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Full range of wheels for setuptools rust, with auto release and PyPI deploy. |
-| [pillow-heif][]                   | ![github icon][] | ![apple icon][] ![linux icon][] | Python CFFI binding to libheif library with third party dependencies like `libde265`, `x265`, `libaom` with test & publishing on PyPi. |
-| [power-grid-model][]              | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Python/C++ library for distribution power system analysis |
 | [Imagecodecs (fork)][]            | ![azurepipelines icon][] | ![apple icon][] ![linux icon][] | Over 20 external dependencies in compiled libraries, custom docker image, `libomp`, `openblas` and `install_name_tool` for macOS. |
+| [polaroid][]                      | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Full range of wheels for setuptools rust, with auto release and PyPI deploy. |
+| [power-grid-model][]              | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Python/C++ library for distribution power system analysis |
+| [etebase-py][]                    | ![travisci icon][] | ![linux icon][] | Python bindings to a Rust library using `setuptools-rust`, and `sccache` for improved speed. |
 | [cf-units][]                      | ![github icon][] | ![apple icon][] ![linux icon][] | Units of measure as required by the Climate and Forecast (CF) Metadata Conventions |
-| [clang-format][]                  | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Scikit-build wrapper around LLVM's CMake, all platforms, generic wheels. |
 | [pybind11 scikit_build_example][] | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | An example combining scikit-build and pybind11 |
+| [clang-format][]                  | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Scikit-build wrapper around LLVM's CMake, all platforms, generic wheels. |
 | [numpythia][]                     | ![github icon][] | ![apple icon][] ![linux icon][] | The interface between PYTHIA and NumPy |
-| [pyjet][]                         | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | The interface between FastJet and NumPy |
 | [ninja][]                         | ![github icon][] ![travisci icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Multitagged binary builds for all supported platforms, using cibw 2 config configuration. |
+| [pyjet][]                         | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | The interface between FastJet and NumPy |
 | [GSD][]                           | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Cython and NumPy project with 64-bit wheels. |
+| [ril][]                           | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A python binding to Rust Imaging library using maturin and Pyo3, utilizes Github Action cache to improve speed. Builds abi3 wheels. |
+| [SiPM][]                          | ![github icon][] | ![apple icon][] ![linux icon][] | High performance library for SiPM detectors simulation using C++17, OpenMP and AVX2 intrinsics. |
 | [CorrectionLib][]                 | ![github icon][] | ![apple icon][] ![linux icon][] | Structured JSON powered correction library for HEP, designed for the CMS experiment at CERN. |
 | [pyinstrument_cext][]             | ![travisci icon][] ![appveyor icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A simple C extension, without external dependencies |
-| [SiPM][]                          | ![github icon][] | ![apple icon][] ![linux icon][] | High performance library for SiPM detectors simulation using C++17, OpenMP and AVX2 intrinsics. |
-| [ril][]                           | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A python binding to Rust Imaging library using maturin and Pyo3, utilizes Github Action cache to improve speed. Builds abi3 wheels. |
 | [xmlstarlet][]                    | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Python 3.6+ CFFI bindings with true MSVC build. |
 | [pybind11 cross build example][]  | ![github icon][] ![gitlab icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Same as pybind11 cmake_example but used to demo Linux ARM + Windows + macOS builds on GitLab |

 [scikit-learn]: https://github.com/scikit-learn/scikit-learn
 [NumPy]: https://github.com/numpy/numpy
-[Tornado]: https://github.com/tornadoweb/tornado
 [pytorch-fairseq]: https://github.com/pytorch/fairseq
+[Tornado]: https://github.com/tornadoweb/tornado
 [Matplotlib]: https://github.com/matplotlib/matplotlib
 [NCNN]: https://github.com/Tencent/ncnn
 [Kivy]: https://github.com/kivy/kivy
 [Prophet]: https://github.com/facebook/prophet
 [MyPy]: https://github.com/mypyc/mypy_mypyc-wheels
-[pydantic]: https://github.com/samuelcolvin/pydantic
 [MemRay]: https://github.com/bloomberg/memray
+[duckdb]: https://github.com/duckdb/duckdb
 [uvloop]: https://github.com/MagicStack/uvloop
 [psutil]: https://github.com/giampaolo/psutil
 [vaex]: https://github.com/vaexio/vaex
-[duckdb]: https://github.com/duckdb/duckdb
 [Google Benchmark]: https://github.com/google/benchmark
 [Apache Beam]: https://github.com/apache/beam
+[Triton]: https://github.com/openai/triton
 [asyncpg]: https://github.com/MagicStack/asyncpg
 [PyGame]: https://github.com/pygame/pygame
 [cmake]: https://github.com/scikit-build/cmake-python-distributions
@@ -138,12 +138,11 @@ title: Working examples
 [PyOxidizer]: https://github.com/indygreg/PyOxidizer
 [websockets]: https://github.com/aaugustin/websockets
 [cvxpy]: https://github.com/cvxpy/cvxpy
-[Triton]: https://github.com/openai/triton
-[UltraJSON]: https://github.com/ultrajson/ultrajson
 [River]: https://github.com/online-ml/river
+[UltraJSON]: https://github.com/ultrajson/ultrajson
 [OpenSpiel]: https://github.com/deepmind/open_spiel
-[pyzmq]: https://github.com/zeromq/pyzmq
 [aiortc]: https://github.com/aiortc/aiortc
+[pyzmq]: https://github.com/zeromq/pyzmq
 [Confluent client for Kafka]: https://github.com/confluentinc/confluent-kafka-python
 [Implicit]: https://github.com/benfred/implicit
 [vispy]: https://github.com/vispy/vispy
@@ -154,67 +153,68 @@ title: Working examples
 [PyYAML]: https://github.com/yaml/pyyaml
 [numexpr]: https://github.com/pydata/numexpr
 [h5py]: https://github.com/h5py/h5py
-[Wrapt]: https://github.com/GrahamDumpleton/wrapt
 [PyAV]: https://github.com/PyAV-Org/PyAV
-[pikepdf]: https://github.com/pikepdf/pikepdf
-[SimpleJSON]: https://github.com/simplejson/simplejson
+[Wrapt]: https://github.com/GrahamDumpleton/wrapt
 [Line Profiler]: https://github.com/pyutils/line_profiler
-[OpenColorIO]: https://github.com/AcademySoftwareFoundation/OpenColorIO
-[PyTables]: https://github.com/PyTables/PyTables
-[OpenTimelineIO]: https://github.com/PixarAnimationStudios/OpenTimelineIO
+[pikepdf]: https://github.com/pikepdf/pikepdf
 [envd]: https://github.com/tensorchord/envd
+[SimpleJSON]: https://github.com/simplejson/simplejson
+[OpenColorIO]: https://github.com/AcademySoftwareFoundation/OpenColorIO
 [aioquic]: https://github.com/aiortc/aioquic
+[OpenTimelineIO]: https://github.com/PixarAnimationStudios/OpenTimelineIO
+[PyTables]: https://github.com/PyTables/PyTables
 [ruptures]: https://github.com/deepcharles/ruptures
 [Psycopg 3]: https://github.com/psycopg/psycopg
+[Parselmouth]: https://github.com/YannickJadoul/Parselmouth
 [DeepForest]: https://github.com/LAMDA-NJU/Deep-Forest
 [google neuroglancer]: https://github.com/google/neuroglancer
-[Parselmouth]: https://github.com/YannickJadoul/Parselmouth
 [AutoPy]: https://github.com/autopilot-rs/autopy
+[CTranslate2]: https://github.com/OpenNMT/CTranslate2
 [H3-py]: https://github.com/uber/h3-py
 [Rtree]: https://github.com/Toblerity/rtree
 [markupsafe]: https://github.com/pallets/markupsafe
-[python-rapidjson]: https://github.com/python-rapidjson/python-rapidjson
+[Picologging]: https://github.com/microsoft/picologging
 [pybind11 cmake_example]: https://github.com/pybind/cmake_example
-[python-snappy]: https://github.com/andrix/python-snappy
+[python-rapidjson]: https://github.com/python-rapidjson/python-rapidjson
 [KDEpy]: https://github.com/tommyod/KDEpy
+[python-snappy]: https://github.com/andrix/python-snappy
+[time-machine]: https://github.com/adamchainz/time-machine
 [tgcalls]: https://github.com/MarshalX/tgcalls
 [pybind11 python_example]: https://github.com/pybind/python_example
 [dd-trace-py]: https://github.com/DataDog/dd-trace-py
-[CTranslate2]: https://github.com/OpenNMT/CTranslate2
-[time-machine]: https://github.com/adamchainz/time-machine
 [sourmash]: https://github.com/dib-lab/sourmash
 [cyvcf2]: https://github.com/brentp/cyvcf2
 [matrixprofile]: https://github.com/matrix-profile-foundation/matrixprofile
 [abess]: https://github.com/abess-team/abess
+[mosec]: https://github.com/mosecorg/mosec
 [jq.py]: https://github.com/mwilliamson/jq.py
 [iminuit]: https://github.com/scikit-hep/iminuit
 [Tokenizer]: https://github.com/OpenNMT/Tokenizer
 [PyGLM]: https://github.com/Zuzu-Typ/PyGLM
-[mosec]: https://github.com/mosecorg/mosec
-[bx-python]: https://github.com/bxlab/bx-python
 [TgCrypto]: https://github.com/pyrogram/tgcrypto
+[bx-python]: https://github.com/bxlab/bx-python
 [boost-histogram]: https://github.com/scikit-hep/boost-histogram
 [iDynTree]: https://github.com/robotology/idyntree
 [Python-WebRTC]: https://github.com/MarshalX/python-webrtc
 [pybase64]: https://github.com/mayeut/pybase64
+[pillow-heif]: https://github.com/bigcat88/pillow_heif
 [Arbor]: https://github.com/arbor-sim/arbor
 [fathon]: https://github.com/stfbnc/fathon
-[etebase-py]: https://github.com/etesync/etebase-py
-[polaroid]: https://github.com/daggy1234/polaroid
-[pillow-heif]: https://github.com/bigcat88/pillow_heif
-[power-grid-model]: https://github.com/alliander-opensource/power-grid-model
 [Imagecodecs (fork)]: https://github.com/czaki/imagecodecs_build
+[polaroid]: https://github.com/daggy1234/polaroid
+[power-grid-model]: https://github.com/alliander-opensource/power-grid-model
+[etebase-py]: https://github.com/etesync/etebase-py
 [cf-units]: https://github.com/SciTools/cf-units
-[clang-format]: https://github.com/ssciwr/clang-format-wheel
 [pybind11 scikit_build_example]: https://github.com/pybind/scikit_build_example
+[clang-format]: https://github.com/ssciwr/clang-format-wheel
 [numpythia]: https://github.com/scikit-hep/numpythia
-[pyjet]: https://github.com/scikit-hep/pyjet
 [ninja]: https://github.com/scikit-build/ninja-python-distributions
+[pyjet]: https://github.com/scikit-hep/pyjet
 [GSD]: https://github.com/glotzerlab/gsd
+[ril]: https://github.com/Cryptex-github/ril-py
+[SiPM]: https://github.com/EdoPro98/SimSiPM
 [CorrectionLib]: https://github.com/cms-nanoAOD/correctionlib
 [pyinstrument_cext]: https://github.com/joerick/pyinstrument_cext
-[SiPM]: https://github.com/EdoPro98/SimSiPM
-[ril]: https://github.com/Cryptex-github/ril-py
 [xmlstarlet]: https://github.com/dimitern/xmlstarlet
 [pybind11 cross build example]: https://github.com/wbarnha/pybind_cmake_example_crossbuild

@@ -229,111 +229,6 @@ title: Working examples
 [apple icon]: data/readme_icons/apple.svg
 [linux icon]: data/readme_icons/linux.svg

-<!-- scikit-learn: 51848, last pushed 0 days ago -->
-<!-- NumPy: 21783, last pushed 0 days ago -->
-<!-- Tornado: 20819, last pushed 9 days ago -->
-<!-- pytorch-fairseq: 19600, last pushed 0 days ago -->
-<!-- Matplotlib: 16308, last pushed 0 days ago -->
-<!-- NCNN: 15771, last pushed 0 days ago -->
-<!-- Kivy: 15142, last pushed 0 days ago -->
-<!-- Prophet: 15053, last pushed 4 days ago -->
-<!-- MyPy: 14010, last pushed 0 days ago -->
-<!-- pydantic: 11358, last pushed 0 days ago -->
-<!-- MemRay: 9471, last pushed 4 days ago -->
-<!-- uvloop: 8956, last pushed 23 days ago -->
-<!-- psutil: 8794, last pushed 2 days ago -->
-<!-- vaex: 7361, last pushed 7 days ago -->
-<!-- duckdb: 6941, last pushed 0 days ago -->
-<!-- Google Benchmark: 6940, last pushed 6 days ago -->
-<!-- Apache Beam: 5970, last pushed 0 days ago -->
-<!-- asyncpg: 5679, last pushed 13 days ago -->
-<!-- PyGame: 5309, last pushed 0 days ago -->
-<!-- cmake: 5181, last pushed 0 days ago -->
-<!-- scikit-image: 5093, last pushed 0 days ago -->
-<!-- twisted-iocpsupport: 4808, last pushed 0 days ago -->
-<!-- PyOxidizer: 4347, last pushed 21 days ago -->
-<!-- websockets: 4210, last pushed 1 days ago -->
-<!-- cvxpy: 4147, last pushed 3 days ago -->
-<!-- Triton: 4134, last pushed 0 days ago -->
-<!-- UltraJSON: 3872, last pushed 10 days ago -->
-<!-- River: 3762, last pushed 0 days ago -->
-<!-- OpenSpiel: 3363, last pushed 0 days ago -->
-<!-- pyzmq: 3187, last pushed 7 days ago -->
-<!-- aiortc: 3110, last pushed 6 days ago -->
-<!-- Confluent client for Kafka: 3002, last pushed 3 days ago -->
-<!-- Implicit: 2979, last pushed 20 days ago -->
-<!-- vispy: 2946, last pushed 0 days ago -->
-<!-- tinyobjloader: 2674, last pushed 2 days ago -->
-<!-- Dependency Injector: 2444, last pushed 46 days ago -->
-<!-- coverage.py: 2234, last pushed 1 days ago -->
-<!-- PyCryptodome: 2155, last pushed 24 days ago -->
-<!-- PyYAML: 1965, last pushed 8 days ago -->
-<!-- numexpr: 1827, last pushed 0 days ago -->
-<!-- h5py: 1794, last pushed 3 days ago -->
-<!-- Wrapt: 1772, last pushed 61 days ago -->
-<!-- PyAV: 1699, last pushed 5 days ago -->
-<!-- pikepdf: 1537, last pushed 3 days ago -->
-<!-- SimpleJSON: 1526, last pushed 115 days ago -->
-<!-- Line Profiler: 1430, last pushed 11 days ago -->
-<!-- OpenColorIO: 1385, last pushed 0 days ago -->
-<!-- PyTables: 1153, last pushed 0 days ago -->
-<!-- OpenTimelineIO: 1111, last pushed 1 days ago -->
-<!-- envd: 1101, last pushed 0 days ago -->
-<!-- aioquic: 1094, last pushed 6 days ago -->
-<!-- ruptures: 1068, last pushed 17 days ago -->
-<!-- Psycopg 3: 816, last pushed 3 days ago -->
-<!-- DeepForest: 786, last pushed 24 days ago -->
-<!-- google neuroglancer: 768, last pushed 0 days ago -->
-<!-- Parselmouth: 727, last pushed 14 days ago -->
-<!-- AutoPy: 681, last pushed 34 days ago -->
-<!-- H3-py: 570, last pushed 11 days ago -->
-<!-- Rtree: 505, last pushed 13 days ago -->
-<!-- markupsafe: 501, last pushed 21 days ago -->
-<!-- python-rapidjson: 462, last pushed 7 days ago -->
-<!-- pybind11 cmake_example: 462, last pushed 0 days ago -->
-<!-- python-snappy: 445, last pushed 222 days ago -->
-<!-- KDEpy: 417, last pushed 22 days ago -->
-<!-- tgcalls: 393, last pushed 115 days ago -->
-<!-- pybind11 python_example: 370, last pushed 1 days ago -->
-<!-- dd-trace-py: 364, last pushed 0 days ago -->
-<!-- CTranslate2: 350, last pushed 0 days ago -->
-<!-- time-machine: 345, last pushed 1 days ago -->
-<!-- sourmash: 326, last pushed 0 days ago -->
-<!-- cyvcf2: 307, last pushed 26 days ago -->
-<!-- matrixprofile: 290, last pushed 18 days ago -->
-<!-- abess: 289, last pushed 43 days ago -->
-<!-- jq.py: 237, last pushed 10 days ago -->
-<!-- iminuit: 212, last pushed 22 days ago -->
-<!-- Tokenizer: 196, last pushed 41 days ago -->
-<!-- PyGLM: 151, last pushed 210 days ago -->
-<!-- mosec: 146, last pushed 0 days ago -->
-<!-- bx-python: 121, last pushed 57 days ago -->
-<!-- TgCrypto: 117, last pushed 13 days ago -->
-<!-- boost-histogram: 117, last pushed 7 days ago -->
-<!-- iDynTree: 109, last pushed 14 days ago -->
-<!-- Python-WebRTC: 96, last pushed 228 days ago -->
-<!-- pybase64: 92, last pushed 0 days ago -->
-<!-- Arbor: 82, last pushed 0 days ago -->
-<!-- fathon: 71, last pushed 144 days ago -->
-<!-- etebase-py: 60, last pushed 110 days ago -->
-<!-- polaroid: 57, last pushed 5 days ago -->
-<!-- pillow-heif: 52, last pushed 0 days ago -->
-<!-- power-grid-model: 52, last pushed 0 days ago -->
-<!-- Imagecodecs (fork): 50, last pushed 28 days ago -->
-<!-- cf-units: 49, last pushed 0 days ago -->
-<!-- clang-format: 44, last pushed 23 days ago -->
-<!-- pybind11 scikit_build_example: 36, last pushed 1 days ago -->
-<!-- numpythia: 36, last pushed 23 days ago -->
-<!-- pyjet: 33, last pushed 23 days ago -->
-<!-- ninja: 26, last pushed 10 days ago -->
-<!-- GSD: 19, last pushed 21 days ago -->
-<!-- CorrectionLib: 11, last pushed 0 days ago -->
-<!-- pyinstrument_cext: 10, last pushed 381 days ago -->
-<!-- SiPM: 10, last pushed 145 days ago -->
-<!-- ril: 10, last pushed 41 days ago -->
-<!-- xmlstarlet: 8, last pushed 7 days ago -->
-<!-- pybind11 cross build example: 0, last pushed 11 days ago -->
-
 <!-- END bin/projects.py -->

 > Add your repo here! Let us know on [GitHub Discussions](https://github.com/pypa/cibuildwheel/discussions/485), or send a PR, adding your information to `docs/data/projects.yml`.
@@ -4,15 +4,15 @@ environment:
      APPVEYOR_JOB_NAME: "python37-x64-ubuntu"
    - APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2015
      APPVEYOR_JOB_NAME: "python37-x64-vs2015"
-    - APPVEYOR_BUILD_WORKER_IMAGE: macos-mojave
-      APPVEYOR_JOB_NAME: "python37-x64-macos-mojave"
+    - APPVEYOR_BUILD_WORKER_IMAGE: macos
+      APPVEYOR_JOB_NAME: "python37-x64-macos"

 stack: python 3.7

 init:
 - cmd: set PATH=C:\Python37;C:\Python37\Scripts;%PATH%

-install: python -m pip install cibuildwheel==2.11.2
+install: python -m pip install cibuildwheel==2.12.2

 build_script: python -m cibuildwheel --output-dir wheelhouse

@@ -6,7 +6,7 @@ jobs:
    - bash: |
        set -o errexit
        python3 -m pip install --upgrade pip
-        pip3 install cibuildwheel==2.11.2
+        pip3 install cibuildwheel==2.12.2
      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==2.11.2
+        python3 -m pip install cibuildwheel==2.12.2
      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==2.11.2
+        pip install cibuildwheel==2.12.2
      displayName: Install dependencies
    - bash: cibuildwheel --output-dir wheelhouse .
      displayName: Build wheels
@@ -11,7 +11,7 @@ jobs:
      - run:
          name: Build the Linux wheels.
          command: |
-            pip3 install --user cibuildwheel==2.11.2
+            pip3 install --user cibuildwheel==2.12.2
            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==2.11.2
+            python3 -m pip install --user cibuildwheel==2.12.2
            python3 -m cibuildwheel --output-dir wheelhouse
      - store_artifacts:
          path: wheelhouse/
@@ -42,7 +42,7 @@ jobs:
      - run:
          name: Build the OS X wheels.
          command: |
-            pip3 install cibuildwheel==2.11.2
+            pip3 install cibuildwheel==2.12.2
            cibuildwheel --output-dir wheelhouse
      - store_artifacts:
          path: wheelhouse/
@@ -1,6 +1,6 @@
 build_and_store_wheels: &BUILD_AND_STORE_WHEELS
  install_cibuildwheel_script:
-    - python -m pip install cibuildwheel==2.11.2
+    - python -m pip install cibuildwheel==2.12.2
  run_cibuildwheel_script:
    - cibuildwheel
  wheels_artifacts:
@@ -1,6 +1,6 @@
 build_and_store_wheels: &BUILD_AND_STORE_WHEELS
  install_cibuildwheel_script:
-    - python -m pip install cibuildwheel==2.11.2
+    - python -m pip install cibuildwheel==2.12.2
  run_cibuildwheel_script:
    - cibuildwheel
  wheels_artifacts:
@@ -10,7 +10,7 @@ jobs:
      - uses: actions/checkout@v3

      - name: Build wheels
-        uses: pypa/cibuildwheel@v2.11.2
+        uses: pypa/cibuildwheel@v2.12.2
        env:
          CIBW_ARCHS_MACOS: x86_64 arm64

@@ -22,7 +22,7 @@ jobs:
      - uses: actions/checkout@v3

      - name: Build wheels
-        uses: pypa/cibuildwheel@v2.11.2
+        uses: pypa/cibuildwheel@v2.12.2

      - uses: actions/upload-artifact@v3
        with:
@@ -14,7 +14,7 @@ jobs:
      - uses: actions/checkout@v3

      - name: Build wheels
-        uses: pypa/cibuildwheel@v2.11.2
+        uses: pypa/cibuildwheel@v2.12.2
        # env:
        #   CIBW_SOME_OPTION: value
        #    ...
@@ -20,7 +20,7 @@ jobs:
          platforms: all

      - name: Build wheels
-        uses: pypa/cibuildwheel@v2.11.2
+        uses: pypa/cibuildwheel@v2.12.2
        env:
          # configure cibuildwheel to build native archs ('auto'), and some
          # emulated ones
@@ -12,7 +12,7 @@ linux:
    DOCKER_TLS_CERTDIR: ""
  script:
    - curl -sSL https://get.docker.com/ | sh
-    - python -m pip install cibuildwheel==2.11.2
+    - python -m pip install cibuildwheel==2.12.2
    - cibuildwheel --output-dir wheelhouse
  artifacts:
    paths:
@@ -23,7 +23,7 @@ windows:
  before_script:
    - choco install python -y --version 3.8.6
    - choco install git.install -y
-    - py -m pip install cibuildwheel==2.11.2
+    - py -m pip install cibuildwheel==2.12.2
  script:
    - py -m cibuildwheel --output-dir wheelhouse --platform windows
  artifacts:
@@ -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==2.11.2
+    - python -m pip install cibuildwheel==2.12.2
    # Assuming your CI runner's default architecture is x86_64...
    - cibuildwheel --output-dir wheelhouse --platform linux --archs aarch64
  artifacts:
@@ -20,7 +20,7 @@ jobs:
        - ln -s /c/Python38/python.exe /c/Python38/python3.exe

 install:
-  - python3 -m pip install cibuildwheel==2.11.2
+  - python3 -m pip install cibuildwheel==2.12.2

 script:
  # build the wheels, put them into './dist'
@@ -26,7 +26,7 @@ jobs:
        - ln -s /c/Python38/python.exe /c/Python38/python3.exe

 install:
-  - python3 -m pip install cibuildwheel==2.11.2
+  - python3 -m pip install cibuildwheel==2.12.2

 script:
  # build the wheels, put them into './wheelhouse'
@@ -54,7 +54,7 @@ jobs:
    - stage: deploy
      name: Build and deploy Linux wheels
      services: docker
-      install: python3 -m pip install cibuildwheel==2.11.2 twine
+      install: python3 -m pip install cibuildwheel==2.12.2 twine
      script: python3 -m cibuildwheel --output-dir wheelhouse
      after_success: python3 -m twine upload --skip-existing wheelhouse/*.whl
    # Deploy on windows
@@ -62,7 +62,7 @@ jobs:
      name: Build and deploy Windows wheels
      os: windows
      language: shell
-      install: python3 -m pip install cibuildwheel==2.11.2 twine
+      install: python3 -m pip install cibuildwheel==2.12.2 twine
      script: python3 -m cibuildwheel --output-dir wheelhouse
      after_success: python3 -m twine upload --skip-existing wheelhouse/*.whl

@@ -2,17 +2,12 @@
 requires = [
    "setuptools>=42",
 ]
-
 build-backend = "setuptools.build_meta"


 [tool.black]
 line-length = 100
-target-version = ['py37', 'py38', 'py39', 'py310']
-
-
-[tool.isort]
-profile = "black"
+target-version = ['py37', 'py38', 'py39', 'py310', 'py311']


 [tool.pytest.ini_options]
@@ -88,10 +83,10 @@ ignore = [
 ]

 [tool.pylint]
-master.py-version = "3.7"
-master.jobs = "0"
-master.fail-on = ["E", "F"]
-master.fail-under = "9.8"
+py-version = "3.7"
+jobs = "0"
+fail-on = ["E", "F"]
+fail-under = "9.8"
 reports.output-format = "colorized"
 messages_control.enable = [
  "useless-suppression",
@@ -119,4 +114,50 @@ messages_control.disable = [
  "too-many-statements",
  "unsubscriptable-object",
  "wrong-import-position",
+  "unused-argument",  # Handled by Ruff
+  "broad-exception-raised",  # Could be improved eventually
 ]
+
+[tool.ruff]
+select = [
+  "E", "F", "W", # flake8
+  "B",           # flake8-bugbear
+  "I",           # isort
+  "ARG",         # flake8-unused-arguments
+  "C4",          # flake8-comprehensions
+  "EM",          # flake8-errmsg
+  "ICN",         # flake8-import-conventions
+  "ISC",         # flake8-implicit-str-concat
+  "G",           # flake8-logging-format
+  "PGH",         # pygrep-hooks
+  "PIE",         # flake8-pie
+  "PL",          # pylint
+  "PT",          # flake8-pytest-style
+  "RET",         # flake8-return
+  "RUF",         # Ruff-specific
+  "SIM",         # flake8-simplify
+  "TID251",      # flake8-tidy-imports.banned-api
+  "UP",          # pyupgrade
+  "YTT",         # flake8-2020
+  "EXE",         # flake8-executable
+]
+extend-ignore = [
+  "PLR",    # Design related pylint codes
+  "E501",   # Line too long
+  "RET504", "RET505", "RET508",  # else after control flow
+  "PT004",  # Rename suggested for returnless fixtures
+  "PT007",  # False positive (fixed upstream)
+]
+target-version = "py37"
+typing-modules = ["cibuildwheel.typing"]
+flake8-unused-arguments.ignore-variadic-names = true
+
+[tool.ruff.flake8-tidy-imports.banned-api]
+"typing.Mapping".msg = "Use collections.abc.Mapping instead."
+"typing.Callable".msg = "Use collections.abc.Callable instead."
+"typing.Iterator".msg = "Use collections.abc.Iterator instead."
+"typing.Sequence".msg = "Use collections.abc.Sequence instead."
+"typing.Set".msg = "Use collections.abc.Set instead."
+
+[tool.ruff.per-file-ignores]
+"unit_test/*" = ["PLC1901"]
@@ -1,6 +1,6 @@
 [metadata]
 name = cibuildwheel
-version = 2.11.2
+version = 2.12.2
 description = Build Python wheels on CI with minimal configuration.
 long_description = file: README.md
 long_description_content_type = text/markdown
@@ -53,18 +53,3 @@ console_scripts =

 [options.package_data]
 cibuildwheel = resources/*
-
-[flake8]
-extend-ignore = E203,E501,B950,B023
-extend-select = B9
-application-import-names = cibuildwheel
-exclude =
-    cibuildwheel/resources/,
-    dist/,
-    build/,
-    .git/,
-    env/,
-    env2/,
-    env??/,
-    .venv/,
-    site/
@@ -27,20 +27,9 @@ extras = {
        "rich>=9.6",
        "packaging>=21.0",
    ],
-    "mypy": [
-        "mypy>=0.901",
-        "types-jinja2",
-        "types-certifi",
-        "types-toml",
-        "types-jinja2",
-        "types-pyyaml",
-        "types-click",
-        "types-requests",
-    ],
 }

 extras["dev"] = [
-    *extras["mypy"],
    *extras["test"],
    *extras["bin"],
 ]
@@ -70,7 +70,7 @@ def test_cpp11(tmp_path):
    cpp11_project.generate(project_dir)

    actual_wheels = utils.cibuildwheel_run(project_dir)
-    expected_wheels = [w for w in utils.expected_wheels("spam", "0.1.0")]
+    expected_wheels = list(utils.expected_wheels("spam", "0.1.0"))

    assert set(actual_wheels) == set(expected_wheels)

@@ -89,7 +89,7 @@ def test_cpp14(tmp_path):
    cpp14_project.generate(project_dir)

    actual_wheels = utils.cibuildwheel_run(project_dir)
-    expected_wheels = [w for w in utils.expected_wheels("spam", "0.1.0")]
+    expected_wheels = list(utils.expected_wheels("spam", "0.1.0"))

    assert set(actual_wheels) == set(expected_wheels)

@@ -45,9 +45,7 @@ VERSION_REGEX = r"([\w-]+)==([^\s]+)"
 def get_versions_from_constraint_file(constraint_file):
    constraint_file_text = constraint_file.read_text(encoding="utf8")

-    return {
-        package: version for package, version in re.findall(VERSION_REGEX, constraint_file_text)
-    }
+    return dict(re.findall(VERSION_REGEX, constraint_file_text))


@pytest.mark.parametrize("python_version", ["3.6", "3.8", "3.9"])
@@ -65,8 +65,8 @@ def test_overridden_path(tmp_path, capfd):
    output_dir.mkdir()

    # mess up PATH, somehow
-    with pytest.raises(subprocess.CalledProcessError):
-        if utils.platform == "linux":
+    if utils.platform == "linux":
+        with pytest.raises(subprocess.CalledProcessError):
            utils.cibuildwheel_run(
                project_dir,
                output_dir=output_dir,
@@ -75,11 +75,12 @@ def test_overridden_path(tmp_path, capfd):
                    "CIBW_ENVIRONMENT": '''PATH="$(pwd)/new_path:$PATH"''',
                },
            )
-        else:
-            new_path = tmp_path / "another_bin"
-            new_path.mkdir()
-            (new_path / "python").touch(mode=0o777)
+    else:
+        new_path = tmp_path / "another_bin"
+        new_path.mkdir()
+        (new_path / "python").touch(mode=0o777)

+        with pytest.raises(subprocess.CalledProcessError):
            utils.cibuildwheel_run(
                project_dir,
                output_dir=output_dir,
@@ -65,7 +65,7 @@ def test_cross_compiled_test(tmp_path, capfd, build_universal2):
    actual_wheels = utils.cibuildwheel_run(
        project_dir,
        add_env={
-            "CIBW_BUILD": "cp39-*",
+            "CIBW_BUILD": "cp39-*" if build_universal2 else "*p39-*",
            "CIBW_TEST_COMMAND": '''python -c "import platform; print('running tests on ' + platform.machine())"''',
            "CIBW_ARCHS": "universal2" if build_universal2 else "x86_64 arm64",
            "CIBW_BUILD_VERBOSITY": "3",
@@ -76,7 +76,8 @@ def test_cross_compiled_test(tmp_path, capfd, build_universal2):

    assert DEPLOYMENT_TARGET_TOO_LOW_WARNING not in captured.err

-    if platform.machine() == "x86_64":
+    platform_machine = platform.machine()
+    if platform_machine == "x86_64":
        # ensure that tests were run on only x86_64
        assert "running tests on x86_64" in captured.out
        assert "running tests on arm64" not in captured.out
@@ -89,15 +90,24 @@ def test_cross_compiled_test(tmp_path, capfd, build_universal2):
            assert (
                "While arm64 wheels can be built on x86_64, they cannot be tested" in captured.err
            )
-    elif platform.machine() == "arm64":
+    elif platform_machine == "arm64":
        # ensure that tests were run on both x86_64 and arm64
        assert "running tests on x86_64" in captured.out
        assert "running tests on arm64" in captured.out
+        assert (
+            "While universal2 wheels can be built on x86_64, the arm64 part of them cannot currently be tested"
+            not in captured.err
+        )
+        assert (
+            "While arm64 wheels can be built on x86_64, they cannot be tested" not in captured.err
+        )

    if build_universal2:
        expected_wheels = [w for w in ALL_MACOS_WHEELS if "cp39" in w and "universal2" in w]
    else:
-        expected_wheels = [w for w in ALL_MACOS_WHEELS if "cp39" in w and "universal2" not in w]
+        expected_wheels = [w for w in ALL_MACOS_WHEELS if "p39-" in w and "universal2" not in w]
+        if platform_machine == "x86_64":
+            expected_wheels = [w for w in expected_wheels if not ("pp39" in w and "arm64" in w)]

    assert set(actual_wheels) == set(expected_wheels)

@@ -35,7 +35,6 @@ build-backend = "setuptools.build_meta"


 def test_pep518(tmp_path, build_frontend_env):
-
    project_dir = tmp_path / "project"
    basic_project.generate(project_dir)

@@ -33,7 +33,7 @@ class TestProject:

            with file_path.open("w", encoding="utf8") as f:
                if isinstance(content, jinja2.Template):
-                    content = content.render(self.template_context)
+                    content = content.render(self.template_context)  # noqa: PLW2901

                f.write(content)

@@ -35,8 +35,7 @@ def test(tmp_path, capfd):
    pure_python_project.generate(project_dir)

    with pytest.raises(subprocess.CalledProcessError):
-        actual_wheels = utils.cibuildwheel_run(project_dir)
-        print("produced wheels:", actual_wheels)
+        print("produced wheels:", utils.cibuildwheel_run(project_dir))

    captured = capfd.readouterr()
    print("out", captured.out)
@@ -3,6 +3,7 @@ from __future__ import annotations
 import os
 import subprocess
 import textwrap
+from pathlib import Path

 import pytest

@@ -151,3 +152,37 @@ def test_failing_test(tmp_path):
        )

    assert len(os.listdir(output_dir)) == 0
+
+
+@pytest.mark.parametrize("test_runner", ["pytest", "unittest"])
+def test_bare_pytest_invocation(
+    tmp_path: Path, capfd: pytest.CaptureFixture[str], test_runner: str
+):
+    """Check that if a user runs pytest in the the test cwd, it raises a helpful error"""
+    project_dir = tmp_path / "project"
+    output_dir = tmp_path / "output"
+    project_with_a_test.generate(project_dir)
+
+    with pytest.raises(subprocess.CalledProcessError):
+        utils.cibuildwheel_run(
+            project_dir,
+            output_dir=output_dir,
+            add_env={
+                "CIBW_TEST_REQUIRES": "pytest" if test_runner == "pytest" else "",
+                "CIBW_TEST_COMMAND": (
+                    "python -m pytest" if test_runner == "pytest" else "python -m unittest"
+                ),
+                # Skip CPython 3.8 on macOS arm64, see comment above in
+                # 'test_failing_test'
+                "CIBW_SKIP": "cp38-macosx_arm64",
+            },
+        )
+
+    assert len(os.listdir(output_dir)) == 0
+
+    captured = capfd.readouterr()
+
+    assert (
+        "Please specify a path to your tests when invoking pytest using the {project} placeholder"
+        in captured.out + captured.err
+    )
@@ -12,9 +12,9 @@ basic_project = test_projects.new_c_project()


 def skip_if_no_msvc(arm64=False):
-    programfiles = os.getenv("ProgramFiles(x86)", "") or os.getenv("ProgramFiles", "")
+    programfiles = os.getenv("PROGRAMFILES(X86)", "") or os.getenv("PROGRAMFILES", "")
    if not programfiles:
-        pytest.skip("Requires %ProgramFiles(x86)% variable to be set")
+        pytest.skip("Requires %PROGRAMFILES(X86)% variable to be set")

    vswhere = os.path.join(programfiles, "Microsoft Visual Studio", "Installer", "vswhere.exe")
    if not os.path.isfile(vswhere):
@@ -177,7 +177,14 @@ def expected_wheels(

        if platform == "macos" and machine_arch == "arm64":
            # arm64 macs are only supported by cp38+
-            python_abi_tags = ["cp38-cp38", "cp39-cp39", "cp310-cp310", "cp311-cp311"]
+            python_abi_tags = [
+                "cp38-cp38",
+                "cp39-cp39",
+                "cp310-cp310",
+                "cp311-cp311",
+                "pp38-pypy38_pp73",
+                "pp39-pypy39_pp73",
+            ]

    wheels = []

@@ -19,7 +19,7 @@ def pytest_addoption(parser):
    )


-@pytest.fixture
+@pytest.fixture()
 def fake_package_dir(tmp_path, monkeypatch):
    """
    Monkey-patch enough for the main() function to run
@@ -6,9 +6,7 @@ from pprint import pprint

 import cibuildwheel.linux
 import cibuildwheel.oci_container
-from cibuildwheel.options import Options
-
-from .utils import get_default_command_line_arguments
+from cibuildwheel.options import CommandLineArguments, Options


 def test_linux_container_split(tmp_path: Path, monkeypatch):
@@ -16,7 +14,7 @@ def test_linux_container_split(tmp_path: Path, monkeypatch):
    Tests splitting linux builds by container image and before_all
    """

-    args = get_default_command_line_arguments()
+    args = CommandLineArguments.defaults()
    args.platform = "linux"

    (tmp_path / "pyproject.toml").write_text(
@@ -42,7 +40,7 @@ def test_linux_container_split(tmp_path: Path, monkeypatch):
    )

    monkeypatch.chdir(tmp_path)
-    options = Options("linux", command_line_arguments=args)
+    options = Options("linux", command_line_arguments=args, env={})

    python_configurations = cibuildwheel.linux.get_python_configurations(
        options.globals.build_selector, options.globals.architectures
@@ -47,7 +47,7 @@ def mock_protection(monkeypatch):


@pytest.fixture(autouse=True)
-def fake_package_dir_autouse(fake_package_dir):
+def fake_package_dir_autouse(fake_package_dir):  # noqa: ARG001
    pass


@@ -60,9 +60,9 @@ def disable_print_wheels(monkeypatch):
    monkeypatch.setattr(util, "print_new_wheels", empty_cm)


-@pytest.fixture
-def allow_empty(request, monkeypatch, fake_package_dir):
-    monkeypatch.setattr(sys, "argv", fake_package_dir + ["--allow-empty"])
+@pytest.fixture()
+def allow_empty(monkeypatch, fake_package_dir):
+    monkeypatch.setattr(sys, "argv", [*fake_package_dir, "--allow-empty"])


@pytest.fixture(params=["linux", "macos", "windows"])
@@ -81,7 +81,7 @@ def platform(request, monkeypatch):
    return platform_value


-@pytest.fixture
+@pytest.fixture()
 def intercepted_build_args(monkeypatch):
    intercepted = ArgsInterceptor()

@@ -19,7 +19,8 @@ from cibuildwheel.util import BuildSelector, resources_dir, split_config_setting
 # CIBW_PLATFORM is tested in main_platform_test.py


-def test_output_dir(platform, intercepted_build_args, monkeypatch):
+@pytest.mark.usefixtures("platform")
+def test_output_dir(intercepted_build_args, monkeypatch):
    OUTPUT_DIR = Path("some_output_dir")

    monkeypatch.setenv("CIBW_OUTPUT_DIR", str(OUTPUT_DIR))
@@ -29,17 +30,19 @@ def test_output_dir(platform, intercepted_build_args, monkeypatch):
    assert intercepted_build_args.args[0].globals.output_dir == OUTPUT_DIR.resolve()


-def test_output_dir_default(platform, intercepted_build_args, monkeypatch):
+@pytest.mark.usefixtures("platform")
+def test_output_dir_default(intercepted_build_args):
    main()

    assert intercepted_build_args.args[0].globals.output_dir == Path("wheelhouse").resolve()


+@pytest.mark.usefixtures("platform")
@pytest.mark.parametrize("also_set_environment", [False, True])
-def test_output_dir_argument(also_set_environment, platform, intercepted_build_args, monkeypatch):
+def test_output_dir_argument(also_set_environment, intercepted_build_args, monkeypatch):
    OUTPUT_DIR = Path("some_output_dir")

-    monkeypatch.setattr(sys, "argv", sys.argv + ["--output-dir", str(OUTPUT_DIR)])
+    monkeypatch.setattr(sys, "argv", [*sys.argv, "--output-dir", str(OUTPUT_DIR)])
    if also_set_environment:
        monkeypatch.setenv("CIBW_OUTPUT_DIR", "not_this_output_dir")

@@ -48,7 +51,8 @@ def test_output_dir_argument(also_set_environment, platform, intercepted_build_a
    assert intercepted_build_args.args[0].globals.output_dir == OUTPUT_DIR.resolve()


-def test_build_selector(platform, intercepted_build_args, monkeypatch, allow_empty):
+@pytest.mark.usefixtures("platform", "allow_empty")
+def test_build_selector(intercepted_build_args, monkeypatch):
    BUILD = "some build* *-selector"
    SKIP = "some skip* *-selector"

@@ -65,7 +69,8 @@ def test_build_selector(platform, intercepted_build_args, monkeypatch, allow_emp
    # Unit tests for BuildSelector are in build_selector_test.py


-def test_empty_selector(platform, intercepted_build_args, monkeypatch):
+@pytest.mark.usefixtures("platform", "intercepted_build_args")
+def test_empty_selector(monkeypatch):
    monkeypatch.setenv("CIBW_SKIP", "*")

    with pytest.raises(SystemExit) as e:
@@ -75,7 +80,7 @@ def test_empty_selector(platform, intercepted_build_args, monkeypatch):


@pytest.mark.parametrize(
-    "architecture, image, full_image",
+    ("architecture", "image", "full_image"),
    [
        ("x86_64", None, "quay.io/pypa/manylinux2014_x86_64:*"),
        ("x86_64", "manylinux1", "quay.io/pypa/manylinux1_x86_64:*"),
@@ -278,12 +283,18 @@ def test_config_settings(platform_specific, platform, intercepted_build_args, mo

    assert build_options.config_settings == config_settings

-    assert split_config_settings(config_settings) == [
+    assert split_config_settings(config_settings, "build") == [
        "--config-setting=setting=value",
        "--config-setting=setting=value2",
        "--config-setting=other=something else",
    ]

+    assert split_config_settings(config_settings, "pip") == [
+        "--config-settings=setting=value",
+        "--config-settings=setting=value2",
+        "--config-settings=other=something else",
+    ]
+

@pytest.mark.parametrize(
    "selector",
@@ -303,9 +314,8 @@ def test_config_settings(platform_specific, platform, intercepted_build_args, mo
        "?p35*",
    ],
 )
-def test_build_selector_deprecated_error(
-    monkeypatch, platform, intercepted_build_args, selector, pattern, allow_empty, capsys
-):
+@pytest.mark.usefixtures("platform", "intercepted_build_args", "allow_empty")
+def test_build_selector_deprecated_error(monkeypatch, selector, pattern, capsys):
    monkeypatch.setenv(selector, pattern)

    if selector == "CIBW_BUILD":
@@ -24,7 +24,7 @@ def test_unknown_platform_non_ci(monkeypatch, capsys):

    with pytest.raises(SystemExit) as exit:
        main()
-        assert exit.value.code == 2
+    assert exit.value.code == 2
    _, err = capsys.readouterr()

    assert "cibuildwheel: Unable to detect platform." in err
@@ -38,7 +38,7 @@ def test_unknown_platform_on_ci(monkeypatch, capsys):

    with pytest.raises(SystemExit) as exit:
        main()
-        assert exit.value.code == 2
+    assert exit.value.code == 2
    _, err = capsys.readouterr()

    assert 'cibuildwheel: Unable to detect platform from "sys.platform"' in err
@@ -57,7 +57,7 @@ def test_unknown_platform(monkeypatch, capsys):

 def test_platform_argument(platform, intercepted_build_args, monkeypatch):
    monkeypatch.setenv("CIBW_PLATFORM", "nonexistent")
-    monkeypatch.setattr(sys, "argv", sys.argv + ["--platform", platform])
+    monkeypatch.setattr(sys, "argv", [*sys.argv, "--platform", platform])

    main()

@@ -66,15 +66,15 @@ def test_platform_argument(platform, intercepted_build_args, monkeypatch):
    assert options.globals.package_dir == MOCK_PACKAGE_DIR.resolve()


-def test_platform_environment(platform, intercepted_build_args, monkeypatch):
+@pytest.mark.usefixtures("platform")
+def test_platform_environment(intercepted_build_args):
    main()
    options = intercepted_build_args.args[0]

    assert options.globals.package_dir == MOCK_PACKAGE_DIR.resolve()


-def test_archs_default(platform, intercepted_build_args, monkeypatch):
-
+def test_archs_default(platform, intercepted_build_args):
    main()
    options = intercepted_build_args.args[0]

@@ -88,12 +88,11 @@ def test_archs_default(platform, intercepted_build_args, monkeypatch):

@pytest.mark.parametrize("use_env_var", [False, True])
 def test_archs_argument(platform, intercepted_build_args, monkeypatch, use_env_var):
-
    if use_env_var:
        monkeypatch.setenv("CIBW_ARCHS", "ppc64le")
    else:
        monkeypatch.setenv("CIBW_ARCHS", "unused")
-        monkeypatch.setattr(sys, "argv", sys.argv + ["--archs", "ppc64le"])
+        monkeypatch.setattr(sys, "argv", [*sys.argv, "--archs", "ppc64le"])

    if platform in {"macos", "windows"}:
        with pytest.raises(SystemExit) as exit:
@@ -195,7 +194,7 @@ def test_archs_platform_all(platform, intercepted_build_args, monkeypatch):


@pytest.mark.parametrize(
-    "only,plat",
+    ("only", "plat"),
    (
        ("cp311-manylinux_x86_64", "linux"),
        ("cp310-win_amd64", "windows"),
@@ -206,7 +205,7 @@ def test_archs_platform_all(platform, intercepted_build_args, monkeypatch):
 def test_only_argument(intercepted_build_args, monkeypatch, only, plat):
    monkeypatch.setenv("CIBW_BUILD", "unused")
    monkeypatch.setenv("CIBW_SKIP", "unused")
-    monkeypatch.setattr(sys, "argv", sys.argv + ["--only", only])
+    monkeypatch.setattr(sys, "argv", [*sys.argv, "--only", only])

    main()

@@ -219,7 +218,7 @@ def test_only_argument(intercepted_build_args, monkeypatch, only, plat):

@pytest.mark.parametrize("only", ("cp311-manylxinux_x86_64", "some_linux_thing"))
 def test_only_failed(monkeypatch, only):
-    monkeypatch.setattr(sys, "argv", sys.argv + ["--only", only])
+    monkeypatch.setattr(sys, "argv", [*sys.argv, "--only", only])

    with pytest.raises(SystemExit):
        main()
@@ -227,7 +226,7 @@ def test_only_failed(monkeypatch, only):

 def test_only_no_platform(monkeypatch):
    monkeypatch.setattr(
-        sys, "argv", sys.argv + ["--only", "cp311-manylinux_x86_64", "--platform", "macos"]
+        sys, "argv", [*sys.argv, "--only", "cp311-manylinux_x86_64", "--platform", "macos"]
    )

    with pytest.raises(SystemExit):
@@ -236,7 +235,7 @@ def test_only_no_platform(monkeypatch):

 def test_only_no_archs(monkeypatch):
    monkeypatch.setattr(
-        sys, "argv", sys.argv + ["--only", "cp311-manylinux_x86_64", "--archs", "x86_64"]
+        sys, "argv", [*sys.argv, "--only", "cp311-manylinux_x86_64", "--archs", "x86_64"]
    )

    with pytest.raises(SystemExit):
@@ -244,7 +243,7 @@ def test_only_no_archs(monkeypatch):


@pytest.mark.parametrize(
-    "envvar_name,envvar_value",
+    ("envvar_name", "envvar_value"),
    (
        ("CIBW_BUILD", "cp310-*"),
        ("CIBW_SKIP", "cp311-*"),
@@ -253,7 +252,7 @@ def test_only_no_archs(monkeypatch):
    ),
 )
 def test_only_overrides_env_vars(monkeypatch, intercepted_build_args, envvar_name, envvar_value):
-    monkeypatch.setattr(sys, "argv", sys.argv + ["--only", "cp311-manylinux_x86_64"])
+    monkeypatch.setattr(sys, "argv", [*sys.argv, "--only", "cp311-manylinux_x86_64"])
    monkeypatch.setenv(envvar_name, envvar_value)

    main()
@@ -9,7 +9,7 @@ from packaging.specifiers import SpecifierSet
 from cibuildwheel.__main__ import main


-@pytest.fixture(autouse=True, scope="function")
+@pytest.fixture(autouse=True)
 def fake_package_dir(monkeypatch, tmp_path):
    """
    Set up a fake project
@@ -25,8 +25,8 @@ def fake_package_dir(monkeypatch, tmp_path):
    return local_path


-def test_no_override(platform, monkeypatch, intercepted_build_args):
-
+@pytest.mark.usefixtures("platform")
+def test_no_override(intercepted_build_args):
    main()

    options = intercepted_build_args.args[0]
@@ -38,7 +38,8 @@ def test_no_override(platform, monkeypatch, intercepted_build_args):
    assert intercepted_build_selector.requires_python is None


-def test_override_env(platform, monkeypatch, intercepted_build_args):
+@pytest.mark.usefixtures("platform")
+def test_override_env(monkeypatch, intercepted_build_args):
    monkeypatch.setenv("CIBW_PROJECT_REQUIRES_PYTHON", ">=3.8")

    main()
@@ -52,8 +53,8 @@ def test_override_env(platform, monkeypatch, intercepted_build_args):
    assert not intercepted_build_selector("cp36-win32")


-def test_override_setup_cfg(platform, monkeypatch, intercepted_build_args, fake_package_dir):
-
+@pytest.mark.usefixtures("platform")
+def test_override_setup_cfg(intercepted_build_args, fake_package_dir):
    fake_package_dir.joinpath("setup.cfg").write_text(
        textwrap.dedent(
            """
@@ -74,8 +75,8 @@ def test_override_setup_cfg(platform, monkeypatch, intercepted_build_args, fake_
    assert not intercepted_build_selector("cp36-win32")


-def test_override_pyproject_toml(platform, monkeypatch, intercepted_build_args, fake_package_dir):
-
+@pytest.mark.usefixtures("platform")
+def test_override_pyproject_toml(intercepted_build_args, fake_package_dir):
    fake_package_dir.joinpath("pyproject.toml").write_text(
        textwrap.dedent(
            """
@@ -96,8 +97,8 @@ def test_override_pyproject_toml(platform, monkeypatch, intercepted_build_args,
    assert not intercepted_build_selector("cp36-win32")


-def test_override_setup_py_simple(platform, monkeypatch, intercepted_build_args, fake_package_dir):
-
+@pytest.mark.usefixtures("platform")
+def test_override_setup_py_simple(intercepted_build_args, fake_package_dir):
    fake_package_dir.joinpath("setup.py").write_text(
        textwrap.dedent(
            """
@@ -3,9 +3,9 @@ from __future__ import annotations
 import platform as platform_module
 import subprocess
 import sys
+import typing
 from contextlib import contextmanager
 from pathlib import PurePosixPath
-from typing import cast
 from unittest import mock

 import pytest
@@ -16,7 +16,7 @@ from cibuildwheel.__main__ import main
 ALL_IDS = {"cp36", "cp37", "cp38", "cp39", "cp310", "cp311", "pp37", "pp38", "pp39"}


-@pytest.fixture
+@pytest.fixture()
 def mock_build_container(monkeypatch):
    def fail_on_call(*args, **kwargs):
        msg = "This should never be called"
@@ -46,12 +46,13 @@ def mock_build_container(monkeypatch):
    monkeypatch.setattr("cibuildwheel.util.print_new_wheels", ignore_context_call)


-def test_build_default_launches(mock_build_container, fake_package_dir, monkeypatch):
-    monkeypatch.setattr(sys, "argv", sys.argv + ["--platform=linux"])
+@pytest.mark.usefixtures("mock_build_container", "fake_package_dir")
+def test_build_default_launches(monkeypatch):
+    monkeypatch.setattr(sys, "argv", [*sys.argv, "--platform=linux"])

    main()

-    build_in_container = cast(mock.Mock, linux.build_in_container)
+    build_in_container = typing.cast(mock.Mock, linux.build_in_container)

    assert build_in_container.call_count == 4

@@ -91,7 +92,8 @@ def test_build_default_launches(mock_build_container, fake_package_dir, monkeypa
    assert identifiers == {f"{x}-musllinux_i686" for x in ALL_IDS if "pp" not in x}


-def test_build_with_override_launches(mock_build_container, monkeypatch, tmp_path):
+@pytest.mark.usefixtures("mock_build_container")
+def test_build_with_override_launches(monkeypatch, tmp_path):
    pkg_dir = tmp_path / "cibw_package"
    pkg_dir.mkdir()

@@ -118,7 +120,7 @@ before-all = "true"

    main()

-    build_in_container = cast(mock.Mock, linux.build_in_container)
+    build_in_container = typing.cast(mock.Mock, linux.build_in_container)

    assert build_in_container.call_count == 6

@@ -7,16 +7,19 @@ from pathlib import Path

 import pytest

-from cibuildwheel.__main__ import get_build_identifiers
+from cibuildwheel.__main__ import get_build_identifiers, get_platform_module
 from cibuildwheel.bashlex_eval import local_environment_executor
 from cibuildwheel.environment import parse_environment
-from cibuildwheel.options import Options, _get_pinned_container_images
-
-from .utils import get_default_command_line_arguments
+from cibuildwheel.options import (
+    CommandLineArguments,
+    Options,
+    _get_pinned_container_images,
+)

 PYPROJECT_1 = """
 [tool.cibuildwheel]
 build = ["cp38*", "cp37*"]
+skip = ["*musllinux*"]
 environment = {FOO="BAR"}

 test-command = "pyproject"
@@ -39,23 +42,23 @@ def test_options_1(tmp_path, monkeypatch):
    with tmp_path.joinpath("pyproject.toml").open("w") as f:
        f.write(PYPROJECT_1)

-    args = get_default_command_line_arguments()
+    args = CommandLineArguments.defaults()
    args.package_dir = tmp_path

    monkeypatch.setattr(platform_module, "machine", lambda: "x86_64")

-    options = Options(platform="linux", command_line_arguments=args)
+    options = Options(platform="linux", command_line_arguments=args, env={})

+    module = get_platform_module("linux")
    identifiers = get_build_identifiers(
-        platform="linux",
+        platform_module=module,
        build_selector=options.globals.build_selector,
        architectures=options.globals.architectures,
    )

    override_display = """\
-test_command: 'pyproject'
-  cp37-manylinux_x86_64: 'pyproject-override'"""
-
+  *: pyproject
+  cp37-manylinux_x86_64, cp37-manylinux_i686: pyproject-override"""
    print(options.summary(identifiers))

    assert override_display in options.summary(identifiers)
@@ -82,13 +85,12 @@ def test_passthrough(tmp_path, monkeypatch):
    with tmp_path.joinpath("pyproject.toml").open("w") as f:
        f.write(PYPROJECT_1)

-    args = get_default_command_line_arguments()
+    args = CommandLineArguments.defaults()
    args.package_dir = tmp_path

    monkeypatch.setattr(platform_module, "machine", lambda: "x86_64")
-    monkeypatch.setenv("EXAMPLE_ENV", "ONE")

-    options = Options(platform="linux", command_line_arguments=args)
+    options = Options(platform="linux", command_line_arguments=args, env={"EXAMPLE_ENV": "ONE"})

    default_build_options = options.build_options(identifier=None)

@@ -110,14 +112,16 @@ def test_passthrough(tmp_path, monkeypatch):
    ],
 )
 def test_passthrough_evil(tmp_path, monkeypatch, env_var_value):
-    args = get_default_command_line_arguments()
+    args = CommandLineArguments.defaults()
    args.package_dir = tmp_path

    monkeypatch.setattr(platform_module, "machine", lambda: "x86_64")
-    monkeypatch.setenv("CIBW_ENVIRONMENT_PASS_LINUX", "ENV_VAR")
-    options = Options(platform="linux", command_line_arguments=args)
+    options = Options(
+        platform="linux",
+        command_line_arguments=args,
+        env={"CIBW_ENVIRONMENT_PASS_LINUX": "ENV_VAR", "ENV_VAR": env_var_value},
+    )

-    monkeypatch.setenv("ENV_VAR", env_var_value)
    parsed_environment = options.build_options(identifier=None).environment
    assert parsed_environment.as_dictionary(prev_environment={}) == {"ENV_VAR": env_var_value}

@@ -137,8 +141,8 @@ xfail_env_parse = pytest.mark.xfail(
        pytest.param("a trailing backslash \\", marks=[xfail_env_parse]),
    ],
 )
-def test_toml_environment_evil(tmp_path, monkeypatch, env_var_value):
-    args = get_default_command_line_arguments()
+def test_toml_environment_evil(tmp_path, env_var_value):
+    args = CommandLineArguments.defaults()
    args.package_dir = tmp_path

    tmp_path.joinpath("pyproject.toml").write_text(
@@ -150,13 +154,13 @@ def test_toml_environment_evil(tmp_path, monkeypatch, env_var_value):
        )
    )

-    options = Options(platform="linux", command_line_arguments=args)
+    options = Options(platform="linux", command_line_arguments=args, env={})
    parsed_environment = options.build_options(identifier=None).environment
    assert parsed_environment.as_dictionary(prev_environment={}) == {"EXAMPLE": env_var_value}


@pytest.mark.parametrize(
-    "toml_assignment,result_value",
+    ("toml_assignment", "result_value"),
    [
        ('TEST_VAR="simple_value"', "simple_value"),
        # spaces
@@ -174,7 +178,7 @@ def test_toml_environment_evil(tmp_path, monkeypatch, env_var_value):
    ],
 )
 def test_toml_environment_quoting(tmp_path: Path, toml_assignment, result_value):
-    args = get_default_command_line_arguments()
+    args = CommandLineArguments.defaults()
    args.package_dir = tmp_path

    tmp_path.joinpath("pyproject.toml").write_text(
@@ -186,7 +190,7 @@ def test_toml_environment_quoting(tmp_path: Path, toml_assignment, result_value)
        )
    )

-    options = Options(platform="linux", command_line_arguments=args)
+    options = Options(platform="linux", command_line_arguments=args, env={})
    parsed_environment = options.build_options(identifier=None).environment
    environment_values = parsed_environment.as_dictionary(
        prev_environment={**os.environ, "PARAM": "spam"},
@@ -35,7 +35,7 @@ def test_simple_settings(tmp_path, platform, fname):
    config_file_path: Path = tmp_path / fname
    config_file_path.write_text(PYPROJECT_1)

-    options_reader = OptionsReader(config_file_path, platform=platform)
+    options_reader = OptionsReader(config_file_path, platform=platform, env={})

    assert options_reader.get("build", env_plat=False, sep=" ") == "cp39*"

@@ -71,17 +71,21 @@ def test_simple_settings(tmp_path, platform, fname):
        options_reader.get("test-extras", table={"item": '{k}="{v}"', "sep": " "})


-def test_envvar_override(tmp_path, platform, monkeypatch):
-    monkeypatch.setenv("CIBW_BUILD", "cp38*")
-    monkeypatch.setenv("CIBW_MANYLINUX_X86_64_IMAGE", "manylinux_2_24")
-    monkeypatch.setenv("CIBW_TEST_COMMAND", "mytest")
-    monkeypatch.setenv("CIBW_TEST_REQUIRES", "docs")
-    monkeypatch.setenv("CIBW_TEST_REQUIRES_LINUX", "scod")
-
+def test_envvar_override(tmp_path, platform):
    config_file_path: Path = tmp_path / "pyproject.toml"
    config_file_path.write_text(PYPROJECT_1)

-    options_reader = OptionsReader(config_file_path, platform=platform)
+    options_reader = OptionsReader(
+        config_file_path,
+        platform=platform,
+        env={
+            "CIBW_BUILD": "cp38*",
+            "CIBW_MANYLINUX_X86_64_IMAGE": "manylinux_2_24",
+            "CIBW_TEST_COMMAND": "mytest",
+            "CIBW_TEST_REQUIRES": "docs",
+            "CIBW_TEST_REQUIRES_LINUX": "scod",
+        },
+    )

    assert options_reader.get("archs", sep=" ") == "auto"

@@ -104,18 +108,18 @@ def test_project_global_override_default_platform(tmp_path, platform):
 repair-wheel-command = "repair-project-global"
 """
    )
-    options_reader = OptionsReader(pyproject_toml, platform=platform)
+    options_reader = OptionsReader(pyproject_toml, platform=platform, env={})
    assert options_reader.get("repair-wheel-command") == "repair-project-global"


-def test_env_global_override_default_platform(tmp_path, platform, monkeypatch):
-    monkeypatch.setenv("CIBW_REPAIR_WHEEL_COMMAND", "repair-env-global")
-    options_reader = OptionsReader(platform=platform)
+def test_env_global_override_default_platform(platform):
+    options_reader = OptionsReader(
+        platform=platform, env={"CIBW_REPAIR_WHEEL_COMMAND": "repair-env-global"}
+    )
    assert options_reader.get("repair-wheel-command") == "repair-env-global"


-def test_env_global_override_project_platform(tmp_path, platform, monkeypatch):
-    monkeypatch.setenv("CIBW_REPAIR_WHEEL_COMMAND", "repair-env-global")
+def test_env_global_override_project_platform(tmp_path, platform):
    pyproject_toml = tmp_path / "pyproject.toml"
    pyproject_toml.write_text(
        """
@@ -127,7 +131,13 @@ repair-wheel-command = "repair-project-windows"
 repair-wheel-command = "repair-project-macos"
 """
    )
-    options_reader = OptionsReader(pyproject_toml, platform=platform)
+    options_reader = OptionsReader(
+        pyproject_toml,
+        platform=platform,
+        env={
+            "CIBW_REPAIR_WHEEL_COMMAND": "repair-env-global",
+        },
+    )
    assert options_reader.get("repair-wheel-command") == "repair-env-global"


@@ -145,7 +155,7 @@ repair-wheel-command = "repair-project-macos"
 repair-wheel-command = "repair-project-global"
 """
    )
-    options_reader = OptionsReader(pyproject_toml, platform=platform)
+    options_reader = OptionsReader(pyproject_toml, platform=platform, env={})
    assert options_reader.get("repair-wheel-command") == f"repair-project-{platform}"


@@ -161,7 +171,7 @@ repairs-wheel-command = "repair-project-linux"
    )

    with pytest.raises(ConfigOptionError) as excinfo:
-        OptionsReader(pyproject_toml, platform="linux")
+        OptionsReader(pyproject_toml, platform="linux", env={})

    assert "repair-wheel-command" in str(excinfo.value)

@@ -178,7 +188,7 @@ repair_wheel_command = "repair-project-linux"
    )

    with pytest.raises(ConfigOptionError) as excinfo:
-        OptionsReader(pyproject_toml, platform="linux")
+        OptionsReader(pyproject_toml, platform="linux", env={})

    assert "repair-wheel-command" in str(excinfo.value)

@@ -192,7 +202,7 @@ repair-wheel-command = "repair-project-linux"
 """
    )
    with pytest.raises(ConfigOptionError):
-        OptionsReader(pyproject_toml, platform="linux")
+        OptionsReader(pyproject_toml, platform="linux", env={})


 def test_unsupported_join(tmp_path):
@@ -203,9 +213,9 @@ def test_unsupported_join(tmp_path):
 build = ["1", "2"]
 """
    )
-    options_reader = OptionsReader(pyproject_toml, platform="linux")
+    options_reader = OptionsReader(pyproject_toml, platform="linux", env={})

-    assert "1, 2" == options_reader.get("build", sep=", ")
+    assert options_reader.get("build", sep=", ") == "1, 2"
    with pytest.raises(ConfigOptionError):
        options_reader.get("build")

@@ -219,12 +229,12 @@ manylinux-x86_64-image = "manylinux1"
 """
    )
    disallow = {"windows": {"manylinux-x86_64-image"}}
-    OptionsReader(pyproject_toml, platform="linux", disallow=disallow)
+    OptionsReader(pyproject_toml, platform="linux", disallow=disallow, env={})
    with pytest.raises(ConfigOptionError):
-        OptionsReader(pyproject_toml, platform="windows", disallow=disallow)
+        OptionsReader(pyproject_toml, platform="windows", disallow=disallow, env={})


-def test_environment_override_empty(tmp_path, monkeypatch):
+def test_environment_override_empty(tmp_path):
    pyproject_toml = tmp_path / "pyproject.toml"
    pyproject_toml.write_text(
        """
@@ -234,10 +244,14 @@ manylinux-x86_64-image = ""
 """
    )

-    monkeypatch.setenv("CIBW_MANYLINUX_I686_IMAGE", "")
-    monkeypatch.setenv("CIBW_MANYLINUX_AARCH64_IMAGE", "manylinux1")
-
-    options_reader = OptionsReader(pyproject_toml, platform="linux")
+    options_reader = OptionsReader(
+        pyproject_toml,
+        platform="linux",
+        env={
+            "CIBW_MANYLINUX_I686_IMAGE": "",
+            "CIBW_MANYLINUX_AARCH64_IMAGE": "manylinux1",
+        },
+    )

    assert options_reader.get("manylinux-x86_64-image") == ""
    assert options_reader.get("manylinux-i686-image") == ""
@@ -248,7 +262,7 @@ manylinux-x86_64-image = ""
    assert options_reader.get("manylinux-aarch64-image", ignore_empty=True) == "manylinux1"


-@pytest.mark.parametrize("ignore_empty", (True, False))
+@pytest.mark.parametrize("ignore_empty", [True, False])
 def test_dig_first(ignore_empty):
    d1 = {"random": "thing"}
    d2 = {"this": "that", "empty": ""}
@@ -306,7 +320,7 @@ def test_pyproject_2(tmp_path, platform):
    pyproject_toml: Path = tmp_path / "pyproject.toml"
    pyproject_toml.write_text(PYPROJECT_2)

-    options_reader = OptionsReader(config_file_path=pyproject_toml, platform=platform)
+    options_reader = OptionsReader(config_file_path=pyproject_toml, platform=platform, env={})
    assert options_reader.get("test-command") == "pyproject"

    with options_reader.identifier("random"):
@@ -330,7 +344,7 @@ test-command = "pyproject-override"
    )

    with pytest.raises(ConfigOptionError):
-        OptionsReader(config_file_path=pyproject_toml, platform=platform)
+        OptionsReader(config_file_path=pyproject_toml, platform=platform, env={})


 def test_config_settings(tmp_path):
@@ -343,7 +357,7 @@ other = ["two", "three"]
 """
    )

-    options_reader = OptionsReader(config_file_path=pyproject_toml, platform="linux")
+    options_reader = OptionsReader(config_file_path=pyproject_toml, platform="linux", env={})
    assert (
        options_reader.get("config-settings", table={"item": '{k}="{v}"', "sep": " "})
        == 'example="one" other="two" other="three"'
@@ -359,7 +373,7 @@ def test_pip_config_settings(tmp_path):
 """
    )

-    options_reader = OptionsReader(config_file_path=pyproject_toml, platform="linux")
+    options_reader = OptionsReader(config_file_path=pyproject_toml, platform="linux", env={})
    assert (
        options_reader.get(
            "config-settings", table={"item": "--config-settings='{k}=\"{v}\"'", "sep": " "}
@@ -1,21 +0,0 @@
-from __future__ import annotations
-
-from pathlib import Path
-
-from cibuildwheel.options import CommandLineArguments
-
-
-def get_default_command_line_arguments() -> CommandLineArguments:
-    defaults = CommandLineArguments(
-        platform="auto",
-        allow_empty=False,
-        archs=None,
-        only=None,
-        config_file="",
-        output_dir=Path("wheelhouse"),
-        package_dir=Path("."),
-        prerelease_pythons=False,
-        print_build_identifiers=False,
-    )
-
-    return defaults
@@ -1,10 +1,16 @@
 from __future__ import annotations

+import textwrap
 from pathlib import PurePath

 import pytest

-from cibuildwheel.util import find_compatible_wheel, format_safe, prepare_command
+from cibuildwheel.util import (
+    find_compatible_wheel,
+    fix_ansi_codes_for_github_actions,
+    format_safe,
+    prepare_command,
+)


 def test_format_safe():
@@ -55,8 +61,8 @@ def test_prepare_command():


@pytest.mark.parametrize(
-    "wheel,identifier",
-    (
+    ("wheel", "identifier"),
+    [
        ("foo-0.1-cp38-abi3-win_amd64.whl", "cp310-win_amd64"),
        ("foo-0.1-cp38-abi3-macosx_11_0_x86_64.whl", "cp310-macosx_x86_64"),
        ("foo-0.1-cp38-abi3-manylinux2014_x86_64.whl", "cp310-manylinux_x86_64"),
@@ -66,7 +72,7 @@ def test_prepare_command():
        ("foo-0.1-py3-none-win_amd64.whl", "cp310-win_amd64"),
        ("foo-0.1-py38-none-win_amd64.whl", "cp310-win_amd64"),
        ("foo-0.1-py38-none-win_amd64.whl", "pp310-win_amd64"),
-    ),
+    ],
 )
 def test_find_compatible_wheel_found(wheel: str, identifier: str):
    wheel_ = PurePath(wheel)
@@ -75,8 +81,8 @@ def test_find_compatible_wheel_found(wheel: str, identifier: str):


@pytest.mark.parametrize(
-    "wheel,identifier",
-    (
+    ("wheel", "identifier"),
+    [
        ("foo-0.1-cp38-abi3-win_amd64.whl", "cp310-win32"),
        ("foo-0.1-cp38-abi3-win_amd64.whl", "cp37-win_amd64"),
        ("foo-0.1-cp38-abi3-macosx_11_0_x86_64.whl", "cp310-macosx_universal2"),
@@ -86,7 +92,35 @@ def test_find_compatible_wheel_found(wheel: str, identifier: str):
        ("foo-0.1-py38-none-win_amd64.whl", "cp37-win_amd64"),
        ("foo-0.1-py38-none-win_amd64.whl", "pp37-win_amd64"),
        ("foo-0.1-cp38-cp38-win_amd64.whl", "cp310-win_amd64"),
-    ),
+    ],
 )
 def test_find_compatible_wheel_not_found(wheel: str, identifier: str):
    assert find_compatible_wheel([PurePath(wheel)], identifier) is None
+
+
+def test_fix_ansi_codes_for_github_actions():
+    input = textwrap.dedent(
+        """
+        This line is normal
+        \033[1mThis line is bold
+        This line is also bold
+        \033[31m this line is red and bold
+        This line is red and bold, too\033[0m
+        This line is normal again
+        """
+    )
+
+    expected = textwrap.dedent(
+        """
+        This line is normal
+        \033[1mThis line is bold
+        \033[1mThis line is also bold
+        \033[1m\033[31m this line is red and bold
+        \033[1m\033[31mThis line is red and bold, too\033[0m
+        This line is normal again
+        """
+    )
+
+    output = fix_ansi_codes_for_github_actions(input)
+
+    assert output == expected
@@ -23,10 +23,9 @@ def test_printout_wheels(tmp_path, capsys):

 def test_no_printout_on_error(tmp_path, capsys):
    tmp_path.joinpath("example.0").touch()
-    with pytest.raises(RuntimeError):
-        with print_new_wheels("TEST_MSG: {n}", tmp_path):
-            tmp_path.joinpath("example.1").touch()
-            raise RuntimeError()
+    with pytest.raises(RuntimeError), print_new_wheels("TEST_MSG: {n}", tmp_path):  # noqa: PT012
+        tmp_path.joinpath("example.1").touch()
+        raise RuntimeError()

    captured = capsys.readouterr()  # type: ignore[unreachable]
    assert captured.err == ""