Bump version: v2.12.0

[Bot] Update dependencies

.github/workflows/release.yml

@@ -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.6.4
       with:
         user: __token__
         password: ${{ secrets.pypi_password }}

.github/workflows/test.yml

@@ -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

.github/workflows/update-dependencies.yml

@@ -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

.gitlab-ci.yml

@@ -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

.pre-commit-config.yaml

@@ -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
@@ -14,7 +14,7 @@ repos:
   - id: trailing-whitespace
 
 - repo: https://github.com/asottile/pyupgrade
-  rev: v3.1.0
+  rev: v3.3.1
   hooks:
   - id: pyupgrade
     args: ["--py37-plus"]
@@ -22,32 +22,32 @@ repos:
 
 # Autoremoves unused imports
 - repo: https://github.com/hadialqattan/pycln
-  rev: v2.1.1
+  rev: v2.1.2
   hooks:
   - id: pycln
     args: [--all]
     stages: [manual]
 
 - repo: https://github.com/PyCQA/isort
-  rev: 5.10.1
+  rev: 5.11.4
   hooks:
   - id: isort
     args: ["-a", "from __future__ import annotations"]
     exclude: ^cibuildwheel/resources/.*py$
 
 - repo: https://github.com/psf/black
-  rev: 22.10.0
+  rev: 22.12.0
   hooks:
   - id: black
 
 - 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: v0.991
   hooks:
   - id: mypy
     name: mypy 3.7 on cibuildwheel/
@@ -55,7 +55,7 @@ repos:
     args: ["--python-version=3.7"]
     additional_dependencies: &mypy-dependencies
       - nox
-      - packaging>=21.0
+      - packaging~=21.0
       - pygithub
       - rich
       - tomli
@@ -70,6 +70,7 @@ repos:
       - dataclasses
   - id: mypy
     name: mypy 3.10
+    exclude: ^cibuildwheel/resources/.*py$
     args: ["--python-version=3.10"]
     additional_dependencies: *mypy-dependencies
 
@@ -81,7 +82,7 @@ repos:
     - flake8-bugbear
 
 - repo: https://github.com/PyCQA/flake8
-  rev: 5.0.4
+  rev: 6.0.0
   hooks:
   - id: flake8
     exclude: ^cibuildwheel/resources/
@@ -97,7 +98,7 @@ repos:
   - 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
 

README.md

@@ -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.0
 
       - name: Build wheels
         run: python -m cibuildwheel --output-dir wheelhouse
@@ -209,6 +210,30 @@ Changelog
 
 <!-- this section was generated by bin/update_readme_changelog.py -- do not edit manually -->
 
+### 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_
@@ -227,33 +252,6 @@ _13 October 2022_
 
 - 🛠 Updates to the latest manylinux images, and updates CPython 3.10 to 3.10.8.
 
-### v2.11.0
-
-_13 October 2022_
-
-- 🌟 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)
-
-### v2.10.2
-
-_25 September 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)
-
-### v2.10.1
-
-_18 September 2022_
-
-- 🐛 Fix a bug that stopped environment variables specified in TOML from being expanded. (#1273)
-
 <!-- END bin/update_readme_changelog.py -->
 
 ---

action.yml

@@ -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'

appveyor.yml

@@ -4,8 +4,8 @@ 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
 

bin/projects.py

@@ -243,7 +243,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
         )
 
 

bin/update_pythons.py

@@ -159,8 +159,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 +172,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(
@@ -251,6 +253,7 @@ 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:
         identifier = config["identifier"]
@@ -261,11 +264,14 @@ class AllVersions:
         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)

cibuildwheel/__init__.py

@@ -1,3 +1,3 @@
 from __future__ import annotations
 
-__version__ = "2.11.2"
+__version__ = "2.12.0"

cibuildwheel/__main__.py

@@ -22,9 +22,11 @@ from cibuildwheel.typing import PLATFORMS, PlatformName, assert_never
 from cibuildwheel.util import (
     CIBW_CACHE_PATH,
     BuildSelector,
+    CIProvider,
     Unbuffered,
     chdir,
     detect_ci_provider,
+    fix_ansi_codes_for_github_actions,
 )
 
 
@@ -229,7 +231,7 @@ def build_in_directory(args: CommandLineArguments) -> None:
             )
             sys.exit(2)
 
-    options = compute_options(platform=platform, command_line_arguments=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"}
@@ -318,9 +320,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)

cibuildwheel/architecture.py

@@ -43,6 +43,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()

cibuildwheel/environment.py

@@ -70,7 +70,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
@@ -131,6 +131,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)

cibuildwheel/linux.py

@@ -21,6 +21,7 @@ from .util import (
     prepare_command,
     read_python_configs,
     split_config_settings,
+    test_fail_cwd_file,
     unwrap,
 )
 
@@ -306,9 +307,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 +348,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:

cibuildwheel/logger.py

@@ -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 ""
 

cibuildwheel/macos.py

@@ -36,6 +36,7 @@ from .util import (
     read_python_configs,
     shell,
     split_config_settings,
+    test_fail_cwd_file,
     unwrap,
     virtualenv,
 )
@@ -83,7 +84,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:
@@ -563,7 +588,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 +596,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:

cibuildwheel/options.py

@@ -1,13 +1,14 @@
 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
 from pathlib import Path
 from typing import Any, Callable, Dict, Generator, Iterator, List, Mapping, Union, cast
@@ -21,6 +22,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 +54,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:
@@ -176,9 +192,11 @@ class OptionsReader:
         config_file_path: Path | None = None,
         *,
         platform: PlatformName,
+        env: Mapping[str, str],
         disallow: dict[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 +337,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 +380,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 +428,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)
 
@@ -497,7 +523,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 | (
@@ -594,37 +620,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: list[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: dict[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
 

cibuildwheel/resources/build-platforms.toml

@@ -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.9/python-3.10.9-macos11.pkg" },
+  { identifier = "cp310-macosx_arm64", version = "3.10", url = "https://www.python.org/ftp/python/3.10.9/python-3.10.9-macos11.pkg" },
+  { identifier = "cp310-macosx_universal2", version = "3.10", url = "https://www.python.org/ftp/python/3.10.9/python-3.10.9-macos11.pkg" },
+  { identifier = "cp311-macosx_x86_64", version = "3.11", url = "https://www.python.org/ftp/python/3.11.1/python-3.11.1-macos11.pkg" },
+  { identifier = "cp311-macosx_arm64", version = "3.11", url = "https://www.python.org/ftp/python/3.11.1/python-3.11.1-macos11.pkg" },
+  { identifier = "cp311-macosx_universal2", version = "3.11", url = "https://www.python.org/ftp/python/3.11.1/python-3.11.1-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.9", arch = "32" },
+  { identifier = "cp310-win_amd64", version = "3.10.9", arch = "64" },
+  { identifier = "cp311-win32", version = "3.11.1", arch = "32" },
+  { identifier = "cp311-win_amd64", version = "3.11.1", 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 = "cp311-win_arm64", version = "3.11.1", 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" },
 ]

cibuildwheel/resources/constraints-python310.txt

@@ -1,28 +1,26 @@
 #
-# 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.9.0
     # via virtualenv
-platformdirs==2.5.2
+packaging==23.0
+    # via delocate
+pip==22.3.1
+    # via -r cibuildwheel/resources/constraints.in
+platformdirs==2.6.2
     # via virtualenv
+setuptools==66.0.0
+    # via -r cibuildwheel/resources/constraints.in
 typing-extensions==4.4.0
     # via delocate
-virtualenv==20.16.5
+virtualenv==20.17.1
     # 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
-    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.5.0
+wheel==0.38.4
     # via -r cibuildwheel/resources/constraints.in

cibuildwheel/resources/constraints-python311.txt

@@ -1,28 +1,26 @@
 #
-# 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.9.0
     # via virtualenv
-platformdirs==2.5.2
+packaging==23.0
+    # via delocate
+pip==22.3.1
+    # via -r cibuildwheel/resources/constraints.in
+platformdirs==2.6.2
     # via virtualenv
+setuptools==66.0.0
+    # via -r cibuildwheel/resources/constraints.in
 typing-extensions==4.4.0
     # via delocate
-virtualenv==20.16.5
+virtualenv==20.17.1
     # 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
-    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.5.0
+wheel==0.38.4
     # via -r cibuildwheel/resources/constraints.in

cibuildwheel/resources/constraints-python36.txt

@@ -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

cibuildwheel/resources/constraints-python37.txt

@@ -1,34 +1,33 @@
 #
-# 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.9.0
     # via virtualenv
-importlib-metadata==5.0.0
+importlib-metadata==6.0.0
     # via virtualenv
-platformdirs==2.5.2
+packaging==23.0
+    # via delocate
+pip==22.3.1
+    # via -r cibuildwheel/resources/constraints.in
+platformdirs==2.6.2
     # via virtualenv
+setuptools==66.0.0
+    # via -r cibuildwheel/resources/constraints.in
 typing-extensions==4.4.0
     # via
     #   delocate
     #   importlib-metadata
-virtualenv==20.16.5
+    #   platformdirs
+virtualenv==20.17.1
     # via -r cibuildwheel/resources/constraints.in
-wheel==0.37.1
-    # via
-    #   -r cibuildwheel/resources/constraints.in
-    #   delocate
-zipp==3.10.0
+wheel==0.38.4
+    # via -r cibuildwheel/resources/constraints.in
+zipp==3.11.0
     # via importlib-metadata
-
-# The following packages are considered to be unsafe in a requirements file:
-pip==22.3
-    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.5.0
-    # via -r cibuildwheel/resources/constraints.in

cibuildwheel/resources/constraints-python38.txt

@@ -1,28 +1,26 @@
 #
-# 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.9.0
     # via virtualenv
-platformdirs==2.5.2
+packaging==23.0
+    # via delocate
+pip==22.3.1
+    # via -r cibuildwheel/resources/constraints.in
+platformdirs==2.6.2
     # via virtualenv
+setuptools==66.0.0
+    # via -r cibuildwheel/resources/constraints.in
 typing-extensions==4.4.0
     # via delocate
-virtualenv==20.16.5
+virtualenv==20.17.1
     # 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
-    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.5.0
+wheel==0.38.4
     # via -r cibuildwheel/resources/constraints.in

cibuildwheel/resources/constraints-python39.txt

@@ -1,28 +1,26 @@
 #
-# 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.9.0
     # via virtualenv
-platformdirs==2.5.2
+packaging==23.0
+    # via delocate
+pip==22.3.1
+    # via -r cibuildwheel/resources/constraints.in
+platformdirs==2.6.2
     # via virtualenv
+setuptools==66.0.0
+    # via -r cibuildwheel/resources/constraints.in
 typing-extensions==4.4.0
     # via delocate
-virtualenv==20.16.5
+virtualenv==20.17.1
     # 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
-    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.5.0
+wheel==0.38.4
     # via -r cibuildwheel/resources/constraints.in

cibuildwheel/resources/constraints.txt

@@ -1,28 +1,26 @@
 #
-# 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.9.0
     # via virtualenv
-platformdirs==2.5.2
+packaging==23.0
+    # via delocate
+pip==22.3.1
+    # via -r cibuildwheel/resources/constraints.in
+platformdirs==2.6.2
     # via virtualenv
+setuptools==66.0.0
+    # via -r cibuildwheel/resources/constraints.in
 typing-extensions==4.4.0
     # via delocate
-virtualenv==20.16.5
+virtualenv==20.17.1
     # 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
-    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.5.0
+wheel==0.38.4
     # via -r cibuildwheel/resources/constraints.in

cibuildwheel/resources/pinned_docker_images.cfg

@@ -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-01-14-0c345ba
 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-01-14-103cb93
+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-01-14-103cb93
+musllinux_1_1 = quay.io/pypa/musllinux_1_1_x86_64:2023-01-14-103cb93
 
 [i686]
-manylinux1 = quay.io/pypa/manylinux1_i686:2022-10-15-7701e25
+manylinux1 = quay.io/pypa/manylinux1_i686:2023-01-14-0c345ba
 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-01-14-103cb93
+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-01-14-103cb93
 
 [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-01-14-103cb93
+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-01-14-103cb93
 
 [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-01-14-103cb93
+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-01-14-103cb93
+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-01-14-103cb93
+musllinux_1_1 = quay.io/pypa/musllinux_1_1_aarch64:2023-01-14-103cb93
 
 [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-01-14-103cb93
+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-01-03-129be5e
+musllinux_1_1 = quay.io/pypa/musllinux_1_1_ppc64le:2023-01-14-103cb93
 
 [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-01-14-103cb93
+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-01-14-103cb93
+musllinux_1_1 = quay.io/pypa/musllinux_1_1_s390x:2023-01-14-103cb93
 
 [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-01-14-103cb93
+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-01-14-103cb93
 

cibuildwheel/resources/testing_temp_dir_file.py

@@ -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."
+        )

cibuildwheel/resources/virtualenv.toml

@@ -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.17.1"
+url = "https://github.com/pypa/get-virtualenv/blob/20.17.1/public/virtualenv.pyz?raw=true"

cibuildwheel/util.py

@@ -67,6 +67,8 @@ 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"]
 
 MANYLINUX_ARCHS: Final[tuple[str, ...]] = (
@@ -270,6 +272,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 +293,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 +369,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:
@@ -655,3 +674,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

cibuildwheel/windows.py

@@ -35,6 +35,7 @@ from .util import (
     read_python_configs,
     shell,
     split_config_settings,
+    test_fail_cwd_file,
     unwrap,
     virtualenv,
 )
@@ -487,20 +488,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 +542,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,7 +550,11 @@ 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:

docs/changelog.md

@@ -4,6 +4,30 @@ title: Changelog
 
 # Changelog
 
+### 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_

docs/data/projects.yml

@@ -621,3 +621,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.

docs/faq.md

@@ -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.0
 ```
 
 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.0
 ```
 
 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.0 --output-dir wheelhouse
 pipx run twine upload wheelhouse/*.whl
 ```
 

docs/options.md

@@ -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 `&&`.
 
 

docs/setup.md

@@ -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.0
 
           - 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.0
 
           - name: Build wheels
             run: python -m cibuildwheel --output-dir wheelhouse

docs/working-examples.md

@@ -21,8 +21,8 @@ title: Working examples
 | [MemRay][]                        | ![github icon][] | ![linux icon][] | Memray is a memory profiler for Python |
 | [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 |
+| [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 🚀 |
 | [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. |
 | [asyncpg][]                       | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | A fast PostgreSQL Database Client Library for Python/asyncio. |
@@ -30,12 +30,12 @@ title: Working examples
 | [cmake][]                         | ![github icon][] ![travisci icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Multitagged binary builds for all supported platforms, using cibw 2 config configuration. |
 | [scikit-image][]                  | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Image processing library. Uses cibuildwheel to build and test a project that uses Cython with platform-native code.  |
 | [twisted-iocpsupport][]           | ![github icon][] | ![windows icon][] | A submodule of Twisted that hooks into native C APIs using Cython. |
+| [Triton][]                        | ![github icon][] | ![linux icon][] | Self hosted runners |
 | [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. |
@@ -52,30 +52,31 @@ title: Working examples
 | [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  |
 | [Line Profiler][]                 | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Line-by-line profiling for Python |
+| [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. |
+| [envd][]                          | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | 🏕️ Reproducible development environment for AI/ML |
+| [aioquic][]                       | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | QUIC and HTTP/3 implementation in Python |
 | [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 |
 | [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. |
 | [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-rapidjson][]              | ![travisci icon][] ![gitlab icon][] ![appveyor icon][] | ![windows icon][] ![linux icon][] | Python wrapper around rapidjson |
 | [python-snappy][]                 | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Python bindings for the snappy google library |
 | [KDEpy][]                         | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Kernel Density Estimation in Python |
 | [tgcalls][]                       | ![github icon][] | ![apple icon][] ![windows icon][] | Python `pybind11` binding to Telegram's WebRTC library with third party dependencies like `OpenSSL`, `MozJPEG`, `FFmpeg`, etc. |
+| [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. |
 | [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 |
@@ -84,19 +85,19 @@ title: Working examples
 | [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. |
+| [PyGLM][]                         | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Fast OpenGL Mathematics (GLM) for Python |
 | [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 |
 | [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. |
+| [polaroid][]                      | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Full range of wheels for setuptools rust, with auto release and PyPI deploy. |
+| [etebase-py][]                    | ![travisci icon][] | ![linux icon][] | Python bindings to a Rust library using `setuptools-rust`, and `sccache` for improved speed. |
 | [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. |
 | [cf-units][]                      | ![github icon][] | ![apple icon][] ![linux icon][] | Units of measure as required by the Climate and Forecast (CF) Metadata Conventions |
@@ -106,10 +107,10 @@ title: Working examples
 | [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. |
 | [GSD][]                           | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Cython and NumPy project with 64-bit wheels. |
-| [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. |
+| [CorrectionLib][]                 | ![github icon][] | ![apple icon][] ![linux icon][] | Structured JSON powered correction library for HEP, designed for the CMS experiment at CERN. |
+| [SiPM][]                          | ![github icon][] | ![apple icon][] ![linux icon][] | High performance library for SiPM detectors simulation using C++17, OpenMP and AVX2 intrinsics. |
+| [pyinstrument_cext][]             | ![travisci icon][] ![appveyor icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A simple C extension, without external dependencies |
 | [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 |
 
@@ -126,8 +127,8 @@ title: Working examples
 [MemRay]: https://github.com/bloomberg/memray
 [uvloop]: https://github.com/MagicStack/uvloop
 [psutil]: https://github.com/giampaolo/psutil
-[vaex]: https://github.com/vaexio/vaex
 [duckdb]: https://github.com/duckdb/duckdb
+[vaex]: https://github.com/vaexio/vaex
 [Google Benchmark]: https://github.com/google/benchmark
 [Apache Beam]: https://github.com/apache/beam
 [asyncpg]: https://github.com/MagicStack/asyncpg
@@ -135,12 +136,12 @@ title: Working examples
 [cmake]: https://github.com/scikit-build/cmake-python-distributions
 [scikit-image]: https://github.com/scikit-image/scikit-image
 [twisted-iocpsupport]: https://github.com/twisted/twisted-iocpsupport
+[Triton]: https://github.com/openai/triton
 [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
@@ -157,30 +158,31 @@ title: Working examples
 [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
 [Line Profiler]: https://github.com/pyutils/line_profiler
+[SimpleJSON]: https://github.com/simplejson/simplejson
 [OpenColorIO]: https://github.com/AcademySoftwareFoundation/OpenColorIO
-[PyTables]: https://github.com/PyTables/PyTables
-[OpenTimelineIO]: https://github.com/PixarAnimationStudios/OpenTimelineIO
 [envd]: https://github.com/tensorchord/envd
 [aioquic]: https://github.com/aiortc/aioquic
+[PyTables]: https://github.com/PyTables/PyTables
+[OpenTimelineIO]: https://github.com/PixarAnimationStudios/OpenTimelineIO
 [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
 [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-rapidjson]: https://github.com/python-rapidjson/python-rapidjson
 [python-snappy]: https://github.com/andrix/python-snappy
 [KDEpy]: https://github.com/tommyod/KDEpy
 [tgcalls]: https://github.com/MarshalX/tgcalls
+[CTranslate2]: https://github.com/OpenNMT/CTranslate2
 [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
@@ -189,19 +191,19 @@ title: Working examples
 [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
+[PyGLM]: https://github.com/Zuzu-Typ/PyGLM
 [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
 [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
+[polaroid]: https://github.com/daggy1234/polaroid
+[etebase-py]: https://github.com/etesync/etebase-py
 [power-grid-model]: https://github.com/alliander-opensource/power-grid-model
 [Imagecodecs (fork)]: https://github.com/czaki/imagecodecs_build
 [cf-units]: https://github.com/SciTools/cf-units
@@ -211,10 +213,10 @@ title: Working examples
 [pyjet]: https://github.com/scikit-hep/pyjet
 [ninja]: https://github.com/scikit-build/ninja-python-distributions
 [GSD]: https://github.com/glotzerlab/gsd
-[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
+[CorrectionLib]: https://github.com/cms-nanoAOD/correctionlib
+[SiPM]: https://github.com/EdoPro98/SimSiPM
+[pyinstrument_cext]: https://github.com/joerick/pyinstrument_cext
 [xmlstarlet]: https://github.com/dimitern/xmlstarlet
 [pybind11 cross build example]: https://github.com/wbarnha/pybind_cmake_example_crossbuild
 
@@ -229,111 +231,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`.

examples/appveyor-minimal.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.0
 
 build_script: python -m cibuildwheel --output-dir wheelhouse
 

examples/azure-pipelines-minimal.yml

@@ -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.0
       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.0
       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.0
       displayName: Install dependencies
     - bash: cibuildwheel --output-dir wheelhouse .
       displayName: Build wheels

examples/circleci-minimal.yml

@@ -11,7 +11,7 @@ jobs:
       - run:
           name: Build the Linux wheels.
           command: |
-            pip3 install --user cibuildwheel==2.11.2
+            pip3 install --user cibuildwheel==2.12.0
             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.0
             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.0
             cibuildwheel --output-dir wheelhouse
       - store_artifacts:
           path: wheelhouse/

examples/cirrus-ci-intel-mac.yml

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

examples/cirrus-ci-minimal.yml

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

examples/github-apple-silicon.yml

@@ -10,7 +10,7 @@ jobs:
       - uses: actions/checkout@v3
 
       - name: Build wheels
-        uses: pypa/cibuildwheel@v2.11.2
+        uses: pypa/cibuildwheel@v2.12.0
         env:
           CIBW_ARCHS_MACOS: x86_64 arm64
 

examples/github-deploy.yml

@@ -22,7 +22,7 @@ jobs:
       - uses: actions/checkout@v3
 
       - name: Build wheels
-        uses: pypa/cibuildwheel@v2.11.2
+        uses: pypa/cibuildwheel@v2.12.0
 
       - uses: actions/upload-artifact@v3
         with:

examples/github-minimal.yml

@@ -14,7 +14,7 @@ jobs:
       - uses: actions/checkout@v3
 
       - name: Build wheels
-        uses: pypa/cibuildwheel@v2.11.2
+        uses: pypa/cibuildwheel@v2.12.0
         # env:
         #   CIBW_SOME_OPTION: value
         #    ...

examples/github-with-qemu.yml

@@ -20,7 +20,7 @@ jobs:
           platforms: all
 
       - name: Build wheels
-        uses: pypa/cibuildwheel@v2.11.2
+        uses: pypa/cibuildwheel@v2.12.0
         env:
           # configure cibuildwheel to build native archs ('auto'), and some
           # emulated ones

examples/gitlab-minimal.yml

@@ -12,7 +12,7 @@ linux:
     DOCKER_TLS_CERTDIR: ""
   script:
     - curl -sSL https://get.docker.com/ | sh
-    - python -m pip install cibuildwheel==2.11.2
+    - python -m pip install cibuildwheel==2.12.0
     - 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.0
   script:
     - py -m cibuildwheel --output-dir wheelhouse --platform windows
   artifacts:

examples/gitlab-with-qemu.yml

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

examples/travis-ci-deploy.yml

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

examples/travis-ci-minimal.yml

@@ -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.0
 
 script:
   # build the wheels, put them into './wheelhouse'

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

@@ -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.0 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.0 twine
       script: python3 -m cibuildwheel --output-dir wheelhouse
       after_success: python3 -m twine upload --skip-existing wheelhouse/*.whl
 

setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = cibuildwheel
-version = 2.11.2
+version = 2.12.0
 description = Build Python wheels on CI with minimal configuration.
 long_description = file: README.md
 long_description_content_type = text/markdown

test/test_macos_archs.py

@@ -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)
 

test/test_testing.py

@@ -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
+    )

test/utils.py

@@ -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 = []
 

unit_test/linux_build_steps_test.py

@@ -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

unit_test/options_test.py

@@ -10,13 +10,16 @@ import pytest
 from cibuildwheel.__main__ import get_build_identifiers
 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,12 +42,12 @@ 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={})
 
     identifiers = get_build_identifiers(
         platform="linux",
@@ -53,9 +56,8 @@ def test_options_1(tmp_path, monkeypatch):
     )
 
     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 +84,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 +111,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}
 
@@ -138,7 +141,7 @@ xfail_env_parse = pytest.mark.xfail(
     ],
 )
 def test_toml_environment_evil(tmp_path, monkeypatch, env_var_value):
-    args = get_default_command_line_arguments()
+    args = CommandLineArguments.defaults()
     args.package_dir = tmp_path
 
     tmp_path.joinpath("pyproject.toml").write_text(
@@ -150,7 +153,7 @@ 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}
 
@@ -174,7 +177,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 +189,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"},

unit_test/options_toml_test.py

@@ -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*"
 
@@ -72,16 +72,20 @@ def test_simple_settings(tmp_path, platform, fname):
 
 
 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")
-
     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)
+    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")
     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,7 +213,7 @@ 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=", ")
     with pytest.raises(ConfigOptionError):
@@ -219,9 +229,9 @@ 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):
@@ -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") == ""
@@ -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": " "}

unit_test/utils.py

@@ -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

unit_test/utils_test.py

@@ -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():
@@ -90,3 +96,31 @@ def test_find_compatible_wheel_found(wheel: str, identifier: str):
 )
 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