Bump version: v2.11.0

Merge pull request #1296 from pypa/example-configs
CI updates, fix up example configs
2022-10-13 09:54:44 +01:00 · 2022-10-13 09:07:15 +01:00 · 2022-10-13 09:05:37 +01:00 · 2022-10-12 13:43:33 +02:00 · 2022-10-12 13:38:52 +02:00 · 2022-10-12 09:19:06 +01:00
54 changed files with 801 additions and 293 deletions
@@ -37,9 +37,30 @@ jobs:
          command: venv/bin/python ./bin/run_tests.py
          no_output_timeout: 30m

+  linux-aarch64:
+    machine:
+       image: ubuntu-2004:2022.04.1
+    resource_class: arm.medium
+    environment:
+      PYTHON: python3
+      # Temporarily restrict the tests that are run on CircleCI to prevent
+      # test timeouts.
+      PYTEST_ADDOPTS: -k "unit_test or main_tests or test_0_basic or test_docker_images"
+    steps:
+      - checkout
+
+      - run:
+          name: Prepare the environment.
+          command: bash .circleci/prepare.sh
+      - run:
+          name: Test.
+          command: venv/bin/python ./bin/run_tests.py
+          no_output_timeout: 30m
+
 workflows:
  version: 2
  all-tests:
    jobs:
      - osx-python3.9
      - linux-python3.9
+      - linux-aarch64
@@ -56,3 +56,19 @@ macos_arm64_task:
    - brew install python@3.10
    - ln -s python3 /opt/homebrew/opt/python@3.10/bin/python
  <<: *RUN_TESTS
+
+macos_arm64_cp38_task:
+  macos_instance:
+    image: ghcr.io/cirruslabs/macos-monterey-xcode
+
+  env:
+    PATH: /opt/homebrew/opt/python@3.10/bin:$PATH
+    PYTEST_ADDOPTS: --run-cp38-universal2 -k 'test_cp38_arm64_testing_universal2_installer or test_arch_auto'
+  install_pre_requirements_script:
+    - brew install python@3.10
+    - ln -s python3 /opt/homebrew/opt/python@3.10/bin/python
+    - curl -fsSLO https://www.python.org/ftp/python/3.8.10/python-3.8.10-macos11.pkg
+    - sudo installer -pkg python-3.8.10-macos11.pkg -target /
+    - rm python-3.8.10-macos11.pkg
+    - sh "/Applications/Python 3.8/Install Certificates.command"
+  <<: *RUN_TESTS
@@ -17,3 +17,16 @@ linux:
    - curl -sSL https://get.docker.com/ | sh
    - python -m pip install -e ".[dev]" pytest-custom-exit-code
    - python ./bin/run_tests.py
+
+windows:
+  image: mcr.microsoft.com/windows/servercore:1809
+  variables:
+    PYTEST_ADDOPTS: -k "unit_test or test_0_basic" --suppress-no-test-exit-code
+  before_script:
+    - choco install python -y --version 3.8.6
+  script:
+    - py -m cibuildwheel --output-dir wheelhouse --platform windows
+    - py -m pip install -e ".[dev]" pytest-custom-exit-code
+    - py bin\run_tests.py
+  tags:
+    - windows
@@ -14,7 +14,7 @@ repos:
  - id: trailing-whitespace

 - repo: https://github.com/asottile/pyupgrade
-  rev: v2.38.0
+  rev: v3.0.0
  hooks:
  - id: pyupgrade
    args: ["--py37-plus"]
@@ -36,7 +36,7 @@ repos:
    exclude: ^cibuildwheel/resources/.*py$

 - repo: https://github.com/psf/black
-  rev: 22.8.0
+  rev: 22.10.0
  hooks:
  - id: black

@@ -47,7 +47,7 @@ repos:
    args: [--include-version-classifiers, --max-py-version=3.10]

 - repo: https://github.com/pre-commit/mirrors-mypy
-  rev: v0.971
+  rev: v0.982
  hooks:
  - id: mypy
    name: mypy 3.7 on cibuildwheel/
@@ -51,19 +51,20 @@ Usage

 `cibuildwheel` runs inside a CI service. Supported platforms depend on which service you're using:

-|                 | Linux | macOS | Windows | Linux ARM | macOS ARM |
-|-----------------|-------|-------|---------|-----------|-----------|
-| GitHub Actions  | ✅    | ✅    | ✅      | ✅¹       | ✅²       |
-| Azure Pipelines | ✅    | ✅    | ✅      |           | ✅²       |
-| Travis CI       | ✅    |       | ✅      | ✅        |           |
-| AppVeyor        | ✅    | ✅    | ✅      |           | ✅²       |
-| CircleCI        | ✅    | ✅    |         |           | ✅²       |
-| Gitlab CI       | ✅    |       |         |           |           |
-| Cirrus CI       | ✅    | ✅³   | ✅      | ✅        | ✅        |
+|                 | Linux | macOS | Windows | Linux ARM | macOS ARM | Windows ARM |
+|-----------------|-------|-------|---------|-----------|-----------|-------------|
+| GitHub Actions  | ✅    | ✅    | ✅      | ✅¹       | ✅²       | ✅⁴         |
+| Azure Pipelines | ✅    | ✅    | ✅      |           | ✅²       | ✅⁴         |
+| Travis CI       | ✅    |       | ✅      | ✅        |           |             |
+| AppVeyor        | ✅    | ✅    | ✅      |           | ✅²       | ✅⁴         |
+| CircleCI        | ✅    | ✅    |         | ✅        | ✅²       |             |
+| Gitlab CI       | ✅    |       | ✅      | ✅¹       |           |             |
+| Cirrus CI       | ✅    | ✅³   | ✅      | ✅        | ✅        |             |

 <sup>¹ [Requires emulation](https://cibuildwheel.readthedocs.io/en/stable/faq/#emulation), distributed separately. Other services may also support Linux ARM through emulation or third-party build hosts, but these are not tested in our CI.</sup><br>
 <sup>² [Uses cross-compilation](https://cibuildwheel.readthedocs.io/en/stable/faq/#universal2). It is not possible to test `arm64` and the `arm64` part of a `universal2` wheel on this CI platform.</sup><br>
 <sup>³ [Uses cross-compilation](https://cibuildwheel.readthedocs.io/en/stable/faq/#universal2). Thanks to Rosetta 2 emulation, it is possible to test `x86_64` and both parts of a `universal2` wheel on this CI platform.</sup><br>
+<sup>⁴ [Uses cross-compilation](https://cibuildwheel.readthedocs.io/en/stable/faq/#windows-arm64). It is not possible to test `arm64` on this CI platform.</sup>

 <!--intro-end-->

@@ -92,7 +93,7 @@ jobs:
      - uses: actions/setup-python@v3

      - name: Install cibuildwheel
-        run: python -m pip install cibuildwheel==2.10.2
+        run: python -m pip install cibuildwheel==2.11.0

      - name: Build wheels
        run: python -m cibuildwheel --output-dir wheelhouse
@@ -208,6 +209,19 @@ Changelog

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

+### 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_
@@ -243,15 +257,6 @@ _11 August 2022_
 - ✨ Improved error messages when misspelling TOML options, suggesting close matches (#1205)
 - 🛠 When running on Apple Silicon (so far, an unsupported mode of operation), cibuildwheel no longer builds universal2 wheels by default - just arm64. See [#1204](https://github.com/pypa/cibuildwheel/issues/1204) for discussion. We hope to release official support for native builds on Apple Silicon soon! (#1217)

-### v2.8.1
-
-_18 July 2022_
-
- 🐛 Fix a bug when building CPython 3.8 wheels on an Apple Silicon machine where testing would always fail. cibuildwheel will no longer attempt to test the arm64 part of CPython 3.8 wheels because we use the x86_64 installer of CPython 3.8 due to its macOS system version backward-compatibility. See [#1169](https://github.com/pypa/cibuildwheel/pull/1169) for more details. (#1171)
- 🛠 Update the prerelease CPython 3.11 to 3.11.0b4. (#1180)
- 🛠 The GitHub Action will ensure a compatible version of Python is installed on the runner (#1114)
- 📚 A few docs improvements
-
 <!-- END bin/update_readme_changelog.py -->

 ---
@@ -1,7 +1,7 @@
 jobs:
 - job: linux_38
  timeoutInMinutes: 120
-  pool: {vmImage: 'Ubuntu-18.04'}
+  pool: {vmImage: 'Ubuntu-20.04'}
  steps:
    - task: UsePythonVersion@0
      inputs:
@@ -39,12 +39,12 @@ services = [
    CIService(
        name="appveyor",
        dst_config_path="appveyor.yml",
-        badge_md="[![Build status](https://ci.appveyor.com/api/projects/status/wbsgxshp05tt1tif/branch/{branch}?svg=true)](https://ci.appveyor.com/project/pypa/cibuildwheel/branch/{branch})",
+        badge_md="[![Build status](https://ci.appveyor.com/api/projects/status/gt3vwl88yt0y3hur/branch/{branch}?svg=true)](https://ci.appveyor.com/project/joerick/cibuildwheel/branch/{branch})",
    ),
    CIService(
        name="azure-pipelines",
        dst_config_path="azure-pipelines.yml",
-        badge_md="[![Build Status](https://dev.azure.com/joerick0429/cibuildwheel/_apis/build/status/joerick.cibuildwheel?branchName={branch})](https://dev.azure.com/joerick0429/cibuildwheel/_build/latest?definitionId=2&branchName={branch})",
+        badge_md="[![Build Status](https://dev.azure.com/joerick0429/cibuildwheel/_apis/build/status/pypa.cibuildwheel?branchName={branch})](https://dev.azure.com/joerick0429/cibuildwheel/_build/latest?definitionId=2&branchName={branch})",
    ),
    CIService(
        name="circleci",
@@ -59,12 +59,12 @@ services = [
    CIService(
        name="travis-ci",
        dst_config_path=".travis.yml",
-        badge_md="[![Build Status](https://travis-ci.org/pypa/cibuildwheel.svg?branch={branch})](https://travis-ci.org/pypa/cibuildwheel)",
+        badge_md="[![Build Status](https://app.travis-ci.com/pypa/cibuildwheel.svg?branch={branch})](https://app.travis-ci.com/pypa/cibuildwheel)",
    ),
    CIService(
        name="gitlab",
        dst_config_path=".gitlab-ci.yml",
-        badge_md="[![Gitlab](https://gitlab.com/pypa/cibuildwheel/badges/{branch}/pipeline.svg)](https://gitlab.com/pypa/cibuildwheel/-/commits/{branch})",
+        badge_md="[![Gitlab](https://gitlab.com/joerick/cibuildwheel/badges/{branch}/pipeline.svg)](https://gitlab.com/joerick/cibuildwheel/-/commits/{branch})",
    ),
    CIService(
        name="cirrus-ci",
@@ -75,14 +75,13 @@ services = [


 def ci_service_for_config_file(config_file):
-    service_name = Path(config_file).name.rsplit("-", 1)[0]
+    filename = Path(config_file).name

-    for service in services:
-        if service.name == service_name:
-            return service
-
-    msg = f"unknown ci service for config file {config_file}"
-    raise ValueError(msg)
+    try:
+        return next(s for s in services if filename.startswith(s.name))
+    except StopIteration:
+        msg = f"unknown ci service for config file {config_file}"
+        raise ValueError(msg) from None


@click.command()
@@ -1,3 +1,3 @@
 from __future__ import annotations

-__version__ = "2.10.2"
+__version__ = "2.11.0"
@@ -162,7 +162,7 @@ def main() -> None:
        # cleanup manually
        shutil.rmtree(temp_dir, ignore_errors=sys.platform.startswith("win"))
        if temp_dir.exists():
-            log.warning(f"Can't delete temporary folder '{str(temp_dir)}'")
+            log.warning(f"Can't delete temporary folder '{temp_dir}'")


 def build_in_directory(args: CommandLineArguments) -> None:
@@ -300,7 +300,7 @@ def build_in_directory(args: CommandLineArguments) -> None:
        # cleanup manually
        shutil.rmtree(tmp_path, ignore_errors=sys.platform.startswith("win"))
        if tmp_path.exists():
-            log.warning(f"Can't delete temporary folder '{str(tmp_path)}'")
+            log.warning(f"Can't delete temporary folder '{tmp_path}'")


 def print_preamble(platform: str, options: Options, identifiers: list[str]) -> None:
@@ -114,6 +114,7 @@ class Architecture(Enum):
        return all_archs_map[platform]

    @staticmethod
+    # pylint: disable-next=inconsistent-return-statements
    def bitness_archs(platform: PlatformName, bitness: Literal["64", "32"]) -> set[Architecture]:
        archs_32 = {Architecture.i686, Architecture.x86}
        auto_archs = Architecture.auto_archs(platform)
@@ -110,6 +110,29 @@ def get_build_steps(
    yield from steps.values()


+def check_all_python_exist(
+    *, platform_configs: list[PythonConfiguration], container: OCIContainer
+) -> None:
+    exist = True
+    messages = []
+    for config in platform_configs:
+        python_path = config.path / "bin" / "python"
+        try:
+            container.call(["test", "-x", python_path])
+        except subprocess.CalledProcessError:
+            messages.append(
+                f"  '{python_path}' executable doesn't exist in image '{container.image}' to build '{config.identifier}'."
+            )
+            exist = False
+    if not exist:
+        message = "\n".join(messages)
+        print(
+            f"cibuildwheel:\n{message}",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+
+
 def build_in_container(
    *,
    options: Options,
@@ -120,6 +143,8 @@ def build_in_container(
 ) -> None:
    container_output_dir = PurePosixPath("/output")

+    check_all_python_exist(platform_configs=platform_configs, container=container)
+
    log.step("Copying project into container...")
    container.copy_into(Path.cwd(), container_project_path)

@@ -132,6 +157,7 @@ def build_in_container(
        env = container.get_environment()
        env["PATH"] = f'/opt/python/cp38-cp38/bin:{env["PATH"]}'
        env["PIP_DISABLE_PIP_VERSION_CHECK"] = "1"
+        env["PIP_ROOT_USER_ACTION"] = "ignore"
        env = before_all_options.environment.as_dictionary(
            env, executor=container.environment_executor
        )
@@ -448,4 +474,4 @@ def troubleshoot(options: Options, error: Exception) -> None:

            print("  Files detected:")
            print("\n".join(f"    {f}" for f in so_files))
-            print("")
+            print()
@@ -126,6 +126,13 @@ class Logger:
        self.step_end(success=False)
        self.error(error)

+    def notice(self, message: str) -> None:
+        if self.fold_mode == "github":
+            print(f"::notice::{message}\n", file=sys.stderr)
+        else:
+            c = self.colors
+            print(f"{c.bold}Note{c.end}: {message}\n", file=sys.stderr)
+
    def warning(self, message: str) -> None:
        if self.fold_mode == "github":
            print(f"::warning::{message}\n", file=sys.stderr)
@@ -1,5 +1,6 @@
 from __future__ import annotations

+import contextlib
 import functools
 import os
 import platform
@@ -283,7 +284,7 @@ def build(options: Options, tmp_path: Path) -> None:
        options.globals.build_selector, options.globals.architectures
    )

-    if len(python_configurations) == 0:
+    if not python_configurations:
        return

    try:
@@ -425,6 +426,13 @@ def build(options: Options, tmp_path: Path) -> None:

            if build_options.test_command and build_options.test_selector(config.identifier):
                machine_arch = platform.machine()
+                python_arch = call(
+                    "python",
+                    "-sSc",
+                    "import platform; print(platform.machine())",
+                    env=env,
+                    capture_stdout=True,
+                ).strip()
                testing_archs: list[Literal["x86_64", "arm64"]]

                if config_is_arm64:
@@ -473,7 +481,8 @@ def build(options: Options, tmp_path: Path) -> None:
                        # skip this test
                        continue

-                    if testing_arch == "arm64" and config.identifier.startswith("cp38-"):
+                    is_cp38 = config.identifier.startswith("cp38-")
+                    if testing_arch == "arm64" and is_cp38 and python_arch != "arm64":
                        log.warning(
                            unwrap(
                                """
@@ -566,10 +575,8 @@ def build(options: Options, tmp_path: Path) -> None:

            # we're all done here; move it to output (overwrite existing)
            if compatible_wheel is None:
-                try:
+                with contextlib.suppress(FileNotFoundError):
                    (build_options.output_dir / repaired_wheel.name).unlink()
-                except FileNotFoundError:
-                    pass

                shutil.move(str(repaired_wheel), build_options.output_dir)
                built_wheels.append(build_options.output_dir / repaired_wheel.name)
@@ -1,14 +1,14 @@
 from __future__ import annotations

+import configparser
+import contextlib
+import dataclasses
 import difflib
 import functools
 import os
 import shlex
 import sys
 import traceback
-from configparser import ConfigParser
-from contextlib import contextmanager
-from dataclasses import asdict, dataclass
 from pathlib import Path
 from typing import Any, Callable, Dict, Generator, Iterator, List, Mapping, Union, cast

@@ -40,7 +40,7 @@ from .util import (
 )


-@dataclass
+@dataclasses.dataclass
 class CommandLineArguments:
    platform: Literal["auto", "linux", "macos", "windows"] | None
    archs: str | None
@@ -53,7 +53,7 @@ class CommandLineArguments:
    prerelease_pythons: bool


-@dataclass(frozen=True)
+@dataclasses.dataclass(frozen=True)
 class GlobalOptions:
    package_dir: Path
    output_dir: Path
@@ -63,7 +63,7 @@ class GlobalOptions:
    container_engine: ContainerEngine


-@dataclass(frozen=True)
+@dataclasses.dataclass(frozen=True)
 class BuildOptions:
    globals: GlobalOptions
    environment: ParsedEnvironment
@@ -105,7 +105,7 @@ class BuildOptions:
 Setting = Union[Dict[str, str], List[str], str, int]


-@dataclass(frozen=True)
+@dataclasses.dataclass(frozen=True)
 class Override:
    select_pattern: str
    options: dict[str, Setting]
@@ -277,7 +277,7 @@ class OptionsReader:
            o for o in self.overrides if selector_matches(o.select_pattern, self.current_identifier)
        ]

-    @contextmanager
+    @contextlib.contextmanager
    def identifier(self, identifier: str | None) -> Generator[None, None, None]:
        self.current_identifier = identifier
        try:
@@ -496,10 +496,8 @@ class Options:
            # Pass through environment variables
            if self.platform == "linux":
                for env_var_name in environment_pass:
-                    try:
+                    with contextlib.suppress(KeyError):
                        environment.add(env_var_name, os.environ[env_var_name])
-                    except KeyError:
-                        pass

            if dependency_versions == "pinned":
                dependency_constraints: None | (
@@ -574,7 +572,7 @@ class Options:
            )

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

            if len(before_all_values) > 1:
@@ -599,7 +597,7 @@ class Options:
    def summary(self, identifiers: list[str]) -> str:
        lines = [
            f"{option_name}: {option_value!r}"
-            for option_name, option_value in sorted(asdict(self.globals).items())
+            for option_name, option_value in sorted(dataclasses.asdict(self.globals).items())
        ]

        build_option_defaults = self.build_options(identifier=None)
@@ -607,7 +605,7 @@ class Options:
            identifier: self.build_options(identifier) for identifier in identifiers
        }

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

@@ -642,7 +640,7 @@ def _get_pinned_container_images() -> Mapping[str, Mapping[str, str]]:
    """

    pinned_images_file = resources_dir / "pinned_docker_images.cfg"
-    all_pinned_images = ConfigParser()
+    all_pinned_images = configparser.ConfigParser()
    all_pinned_images.read(pinned_images_file)
    return all_pinned_images

@@ -1,8 +1,9 @@
 from __future__ import annotations

 import ast
+import configparser
+import contextlib
 import sys
-from configparser import ConfigParser
 from pathlib import Path
 from typing import Any

@@ -59,25 +60,21 @@ def get_requires_python_str(package_dir: Path) -> str | None:
    """Return the python requires string from the most canonical source available, or None"""

    # Read in from pyproject.toml:project.requires-python
-    try:
+    with contextlib.suppress(FileNotFoundError):
        with (package_dir / "pyproject.toml").open("rb") as f1:
            info = tomllib.load(f1)
-        return str(info["project"]["requires-python"])
-    except (FileNotFoundError, KeyError, IndexError, TypeError):
-        pass
+        with contextlib.suppress(KeyError, IndexError, TypeError):
+            return str(info["project"]["requires-python"])

    # Read in from setup.cfg:options.python_requires
-    try:
-        config = ConfigParser()
+    config = configparser.ConfigParser()
+    with contextlib.suppress(FileNotFoundError):
        config.read(package_dir / "setup.cfg")
-        return str(config["options"]["python_requires"])
-    except (FileNotFoundError, KeyError, IndexError, TypeError):
-        pass
+        with contextlib.suppress(KeyError, IndexError, TypeError):
+            return str(config["options"]["python_requires"])

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

    return None
@@ -12,7 +12,7 @@ filelock==3.8.0
    # via virtualenv
 platformdirs==2.5.2
    # via virtualenv
-typing-extensions==4.3.0
+typing-extensions==4.4.0
    # via delocate
 virtualenv==20.16.5
    # via -r cibuildwheel/resources/constraints.in
@@ -24,5 +24,5 @@ wheel==0.37.1
 # The following packages are considered to be unsafe in a requirements file:
 pip==22.2.2
    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.3.0
+setuptools==65.4.1
    # via -r cibuildwheel/resources/constraints.in
@@ -12,7 +12,7 @@ filelock==3.8.0
    # via virtualenv
 platformdirs==2.5.2
    # via virtualenv
-typing-extensions==4.3.0
+typing-extensions==4.4.0
    # via delocate
 virtualenv==20.16.5
    # via -r cibuildwheel/resources/constraints.in
@@ -24,5 +24,5 @@ wheel==0.37.1
 # The following packages are considered to be unsafe in a requirements file:
 pip==22.2.2
    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.3.0
+setuptools==65.4.1
    # via -r cibuildwheel/resources/constraints.in
@@ -10,11 +10,11 @@ distlib==0.3.6
    # via virtualenv
 filelock==3.8.0
    # via virtualenv
-importlib-metadata==4.12.0
+importlib-metadata==5.0.0
    # via virtualenv
 platformdirs==2.5.2
    # via virtualenv
-typing-extensions==4.3.0
+typing-extensions==4.4.0
    # via
    #   delocate
    #   importlib-metadata
@@ -24,11 +24,11 @@ wheel==0.37.1
    # via
    #   -r cibuildwheel/resources/constraints.in
    #   delocate
-zipp==3.8.1
+zipp==3.9.0
    # via importlib-metadata

 # The following packages are considered to be unsafe in a requirements file:
 pip==22.2.2
    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.3.0
+setuptools==65.4.1
    # via -r cibuildwheel/resources/constraints.in
@@ -12,7 +12,7 @@ filelock==3.8.0
    # via virtualenv
 platformdirs==2.5.2
    # via virtualenv
-typing-extensions==4.3.0
+typing-extensions==4.4.0
    # via delocate
 virtualenv==20.16.5
    # via -r cibuildwheel/resources/constraints.in
@@ -24,5 +24,5 @@ wheel==0.37.1
 # The following packages are considered to be unsafe in a requirements file:
 pip==22.2.2
    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.3.0
+setuptools==65.4.1
    # via -r cibuildwheel/resources/constraints.in
@@ -12,7 +12,7 @@ filelock==3.8.0
    # via virtualenv
 platformdirs==2.5.2
    # via virtualenv
-typing-extensions==4.3.0
+typing-extensions==4.4.0
    # via delocate
 virtualenv==20.16.5
    # via -r cibuildwheel/resources/constraints.in
@@ -24,5 +24,5 @@ wheel==0.37.1
 # The following packages are considered to be unsafe in a requirements file:
 pip==22.2.2
    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.3.0
+setuptools==65.4.1
    # via -r cibuildwheel/resources/constraints.in
@@ -12,7 +12,7 @@ filelock==3.8.0
    # via virtualenv
 platformdirs==2.5.2
    # via virtualenv
-typing-extensions==4.3.0
+typing-extensions==4.4.0
    # via delocate
 virtualenv==20.16.5
    # via -r cibuildwheel/resources/constraints.in
@@ -24,5 +24,5 @@ wheel==0.37.1
 # The following packages are considered to be unsafe in a requirements file:
 pip==22.2.2
    # via -r cibuildwheel/resources/constraints.in
-setuptools==65.3.0
+setuptools==65.4.1
    # via -r cibuildwheel/resources/constraints.in
@@ -6,6 +6,7 @@
 # for the ssl module.  Uses the certificates provided by the certifi package:
 #       https://pypi.org/project/certifi/

+import contextlib
 import os
 import os.path
 import ssl
@@ -39,10 +40,8 @@ def main():
    relpath_to_certifi_cafile = os.path.relpath(certifi.where())

    print(" -- removing any existing file or link")
-    try:
+    with contextlib.suppress(FileNotFoundError):
        os.remove(openssl_cafile)
-    except FileNotFoundError:
-        pass
    print(" -- creating symlink to certifi certificate bundle")
    os.symlink(relpath_to_certifi_cafile, openssl_cafile)

@@ -1,49 +1,49 @@
 [x86_64]
-manylinux1 = quay.io/pypa/manylinux1_x86_64:2022-09-18-e2e56b7
+manylinux1 = quay.io/pypa/manylinux1_x86_64:2022-10-09-d8a0859
 manylinux2010 = quay.io/pypa/manylinux2010_x86_64:2022-08-05-4535177
-manylinux2014 = quay.io/pypa/manylinux2014_x86_64:2022-09-18-2b8b451
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_x86_64:2022-09-18-2b8b451
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_x86_64:2022-09-18-2b8b451
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_x86_64:2022-09-18-2b8b451
+manylinux2014 = quay.io/pypa/manylinux2014_x86_64:2022-10-09-941e8b2
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_x86_64:2022-10-09-941e8b2
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_x86_64:2022-10-09-941e8b2
+musllinux_1_1 = quay.io/pypa/musllinux_1_1_x86_64:2022-10-09-941e8b2

 [i686]
-manylinux1 = quay.io/pypa/manylinux1_i686:2022-09-18-e2e56b7
+manylinux1 = quay.io/pypa/manylinux1_i686:2022-10-09-d8a0859
 manylinux2010 = quay.io/pypa/manylinux2010_i686:2022-08-05-4535177
-manylinux2014 = quay.io/pypa/manylinux2014_i686:2022-09-18-2b8b451
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_i686:2022-09-18-2b8b451
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_i686:2022-09-18-2b8b451
+manylinux2014 = quay.io/pypa/manylinux2014_i686:2022-10-09-941e8b2
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_i686:2022-10-09-941e8b2
+musllinux_1_1 = quay.io/pypa/musllinux_1_1_i686:2022-10-09-941e8b2

 [pypy_x86_64]
 manylinux2010 = quay.io/pypa/manylinux2010_x86_64:2022-08-05-4535177
-manylinux2014 = quay.io/pypa/manylinux2014_x86_64:2022-09-18-2b8b451
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_x86_64:2022-09-18-2b8b451
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_x86_64:2022-09-18-2b8b451
+manylinux2014 = quay.io/pypa/manylinux2014_x86_64:2022-10-09-941e8b2
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_x86_64:2022-10-09-941e8b2
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_x86_64:2022-10-09-941e8b2

 [pypy_i686]
 manylinux2010 = quay.io/pypa/manylinux2010_i686:2022-08-05-4535177
-manylinux2014 = quay.io/pypa/manylinux2014_i686:2022-09-18-2b8b451
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_i686:2022-09-18-2b8b451
+manylinux2014 = quay.io/pypa/manylinux2014_i686:2022-10-09-941e8b2
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_i686:2022-10-09-941e8b2

 [aarch64]
-manylinux2014 = quay.io/pypa/manylinux2014_aarch64:2022-09-18-2b8b451
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_aarch64:2022-09-18-2b8b451
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_aarch64:2022-09-18-2b8b451
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_aarch64:2022-09-18-2b8b451
+manylinux2014 = quay.io/pypa/manylinux2014_aarch64:2022-10-09-941e8b2
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_aarch64:2022-10-09-941e8b2
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_aarch64:2022-10-09-941e8b2
+musllinux_1_1 = quay.io/pypa/musllinux_1_1_aarch64:2022-10-09-941e8b2

 [ppc64le]
-manylinux2014 = quay.io/pypa/manylinux2014_ppc64le:2022-09-18-2b8b451
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_ppc64le:2022-09-18-2b8b451
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_ppc64le:2022-09-18-2b8b451
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_ppc64le:2022-09-18-2b8b451
+manylinux2014 = quay.io/pypa/manylinux2014_ppc64le:2022-10-09-941e8b2
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_ppc64le:2022-10-09-941e8b2
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_ppc64le:2022-10-09-941e8b2
+musllinux_1_1 = quay.io/pypa/musllinux_1_1_ppc64le:2022-10-09-941e8b2

 [s390x]
-manylinux2014 = quay.io/pypa/manylinux2014_s390x:2022-09-18-2b8b451
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_s390x:2022-09-18-2b8b451
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_s390x:2022-09-18-2b8b451
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_s390x:2022-09-18-2b8b451
+manylinux2014 = quay.io/pypa/manylinux2014_s390x:2022-10-09-941e8b2
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_s390x:2022-10-09-941e8b2
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_s390x:2022-10-09-941e8b2
+musllinux_1_1 = quay.io/pypa/musllinux_1_1_s390x:2022-10-09-941e8b2

 [pypy_aarch64]
-manylinux2014 = quay.io/pypa/manylinux2014_aarch64:2022-09-18-2b8b451
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_aarch64:2022-09-18-2b8b451
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_aarch64:2022-09-18-2b8b451
+manylinux2014 = quay.io/pypa/manylinux2014_aarch64:2022-10-09-941e8b2
+manylinux_2_24 = quay.io/pypa/manylinux_2_24_aarch64:2022-10-09-941e8b2
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_aarch64:2022-10-09-941e8b2

@@ -3,7 +3,7 @@ from __future__ import annotations
 import os
 import subprocess
 import sys
-from typing import TYPE_CHECKING, NoReturn, Set, Union
+from typing import TYPE_CHECKING, Union

 if sys.version_info < (3, 8):
    from typing_extensions import Final, Literal, OrderedDict, Protocol, TypedDict
@@ -11,9 +11,9 @@ else:
    from typing import Final, Literal, OrderedDict, Protocol, TypedDict

 if sys.version_info < (3, 11):
-    from typing_extensions import NotRequired
+    from typing_extensions import NotRequired, assert_never
 else:
-    from typing import NotRequired
+    from typing import NotRequired, assert_never

 __all__ = (
    "Final",
@@ -25,10 +25,8 @@ __all__ = (
    "PLATFORMS",
    "PopenBytes",
    "Protocol",
-    "Set",
    "TypedDict",
    "OrderedDict",
-    "Union",
    "assert_never",
    "NotRequired",
 )
@@ -44,7 +42,3 @@ else:

 PlatformName = Literal["linux", "macos", "windows"]
 PLATFORMS: Final[set[PlatformName]] = {"linux", "macos", "windows"}
-
-
-def assert_never(value: NoReturn) -> NoReturn:
-    assert False, f"Unhandled value: {value} ({type(value).__name__})"  # noqa: B011
@@ -461,7 +461,7 @@ def print_new_wheels(msg: str, output_dir: Path) -> Generator[None, None, None]:
        for wheel in final_contents - existing_contents
    ]

-    if len(new_contents) == 0:
+    if not new_contents:
        return

    max_name_len = max(len(f.name) for f in new_contents)
@@ -526,7 +526,7 @@ def _parse_constraints_for_virtualenv(
        with constraint_path.open(encoding="utf-8") as constraint_file:
            for line in constraint_file:
                line = line.strip()
-                if len(line) == 0:
+                if not line:
                    continue
                if line.startswith("#"):
                    continue
@@ -1,9 +1,11 @@
 from __future__ import annotations

 import os
+import platform as platform_module
 import shutil
 import subprocess
 import sys
+import textwrap
 from dataclasses import dataclass
 from functools import lru_cache
 from pathlib import Path
@@ -33,15 +35,22 @@ from .util import (
    read_python_configs,
    shell,
    split_config_settings,
+    unwrap,
    virtualenv,
 )


 def get_nuget_args(version: str, arch: str, output_directory: Path) -> list[str]:
-    platform_suffix = {"32": "x86", "64": "", "ARM64": "arm64"}
-    python_name = "python" + platform_suffix[arch]
+    package_name = {
+        "32": "pythonx86",
+        "64": "python",
+        "ARM64": "pythonarm64",
+        # Aliases for platform.machine() return values
+        "x86": "pythonx86",
+        "AMD64": "python",
+    }[arch]
    return [
-        python_name,
+        package_name,
        "-Version",
        version,
        "-FallbackSource",
@@ -121,6 +130,82 @@ def install_pypy(tmp: Path, arch: str, url: str) -> Path:
    return installation_path / "python.exe"


+def setup_setuptools_cross_compile(
+    tmp: Path,
+    python_configuration: PythonConfiguration,
+    python_libs_base: Path,
+    env: dict[str, str],
+) -> None:
+    distutils_cfg = tmp / "extra-setup.cfg"
+    env["DIST_EXTRA_CONFIG"] = str(distutils_cfg)
+    log.notice(f"Setting DIST_EXTRA_CONFIG={distutils_cfg} for cross-compilation")
+
+    # Ensure our additional import libraries are made available, and explicitly
+    # set the platform name
+    map_plat = {"32": "win32", "64": "win-amd64", "ARM64": "win-arm64"}
+    plat_name = map_plat[python_configuration.arch]
+    # (This file must be default/locale encoding, so we can't pass 'encoding')
+    distutils_cfg.write_text(
+        textwrap.dedent(
+            f"""\
+            [build]
+            plat_name={plat_name}
+            [build_ext]
+            library_dirs={python_libs_base}
+            plat_name={plat_name}
+            [bdist_wheel]
+            plat_name={plat_name}
+            """
+        )
+    )
+
+    # setuptools builds require explicit override of PYD extension
+    # This is because it always gets the extension from the running
+    # interpreter, and has no logic to construct it. Currently, CPython's
+    # extensions follow our identifiers, but if they ever diverge in the
+    # future, we will need to store new data
+    log.notice(
+        f"Setting SETUPTOOLS_EXT_SUFFIX=.{python_configuration.identifier}.pyd for cross-compilation"
+    )
+    env["SETUPTOOLS_EXT_SUFFIX"] = f".{python_configuration.identifier}.pyd"
+
+    # Cross-compilation requires fixes that only exist in setuptools's copy of
+    # distutils, so ensure that it is activated
+    # Since not all projects can handle the newer distutils, display a warning
+    # to help them figure out what may have gone wrong if this breaks for them
+    log.notice("Setting SETUPTOOLS_USE_DISTUTILS=local as it is required for cross-compilation")
+    env["SETUPTOOLS_USE_DISTUTILS"] = "local"
+
+
+def setup_rust_cross_compile(
+    tmp: Path,
+    python_configuration: PythonConfiguration,
+    python_libs_base: Path,
+    env: dict[str, str],
+) -> None:
+    # Assume that MSVC will be used, because we already know that we are
+    # cross-compiling. MinGW users can set CARGO_BUILD_TARGET themselves
+    # and we will respect the existing value.
+    cargo_target = {
+        "64": "x86_64-pc-windows-msvc",
+        "32": "i686-pc-windows-msvc",
+        "ARM64": "aarch64-pc-windows-msvc",
+    }.get(python_configuration.arch)
+
+    # CARGO_BUILD_TARGET is the variable used by Cargo and setuptools_rust
+    if env.get("CARGO_BUILD_TARGET"):
+        if env["CARGO_BUILD_TARGET"] != cargo_target:
+            log.notice("Not overriding CARGO_BUILD_TARGET as it has already been set")
+        # No message if it was set to what we were planning to set it to
+    elif cargo_target:
+        log.notice(f"Setting CARGO_BUILD_TARGET={cargo_target} for cross-compilation")
+        env["CARGO_BUILD_TARGET"] = cargo_target
+    else:
+        log.warning(
+            f"Unable to configure Rust cross-compilation for architecture {python_configuration.arch}"
+        )
+
+
 def setup_python(
    tmp: Path,
    python_configuration: PythonConfiguration,
@@ -130,9 +215,22 @@ def setup_python(
 ) -> dict[str, str]:
    tmp.mkdir()
    implementation_id = python_configuration.identifier.split("-")[0]
+    python_libs_base = None
    log.step(f"Installing Python {implementation_id}...")
    if implementation_id.startswith("cp"):
-        base_python = install_cpython(python_configuration.version, python_configuration.arch)
+        native_arch = platform_module.machine()
+        if python_configuration.arch == "ARM64" != native_arch:
+            # To cross-compile for ARM64, we need a native CPython to run the
+            # build, and a copy of the ARM64 import libraries ('.\libs\*.lib')
+            # for any extension modules.
+            python_libs_base = install_cpython(
+                python_configuration.version, python_configuration.arch
+            )
+            python_libs_base = python_libs_base.parent / "libs"
+            log.step(f"Installing native Python {native_arch} for cross-compilation...")
+            base_python = install_cpython(python_configuration.version, native_arch)
+        else:
+            base_python = install_cpython(python_configuration.version, python_configuration.arch)
    elif implementation_id.startswith("pp"):
        assert python_configuration.url is not None
        base_python = install_pypy(tmp, python_configuration.arch, python_configuration.url)
@@ -234,6 +332,11 @@ def setup_python(
    else:
        assert_never(build_frontend)

+    if python_libs_base:
+        # Set up the environment for various backends to enable cross-compilation
+        setup_setuptools_cross_compile(tmp, python_configuration, python_libs_base, env)
+        setup_rust_cross_compile(tmp, python_configuration, python_libs_base, env)
+
    return env


@@ -242,7 +345,7 @@ def build(options: Options, tmp_path: Path) -> None:
        options.globals.build_selector, options.globals.architectures
    )

-    if len(python_configurations) == 0:
+    if not python_configurations:
        return

    try:
@@ -296,7 +399,9 @@ def build(options: Options, tmp_path: Path) -> None:
                if build_options.before_build:
                    log.step("Running before_build...")
                    before_build_prepared = prepare_command(
-                        build_options.before_build, project=".", package=options.globals.package_dir
+                        build_options.before_build,
+                        project=".",
+                        package=options.globals.package_dir,
                    )
                    shell(before_build_prepared, env=env)

@@ -367,7 +472,9 @@ def build(options: Options, tmp_path: Path) -> None:
                if build_options.repair_command:
                    log.step("Repairing wheel...")
                    repair_command_prepared = prepare_command(
-                        build_options.repair_command, wheel=built_wheel, dest_dir=repaired_wheel_dir
+                        build_options.repair_command,
+                        wheel=built_wheel,
+                        dest_dir=repaired_wheel_dir,
                    )
                    shell(repair_command_prepared, env=env)
                else:
@@ -379,6 +486,19 @@ def build(options: Options, tmp_path: Path) -> None:
                    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(
+                            """
+                            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
+
                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.
@@ -4,6 +4,19 @@ title: Changelog

 # Changelog

+### 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_
@@ -55,9 +68,10 @@ _5 July 2022_
 - ✨ You can now run cibuildwheel on Podman, as an alternate container engine to Docker (which remains the default). This is useful in environments where a Docker daemon isn't available, for example, it can be run inside a Docker container, or without root access. To use Podman, set the [`CIBW_CONTAINER_ENGINE`](https://cibuildwheel.readthedocs.io/en/stable/options/#container-engine) option. (#966)
 - ✨ Adds support for building `py3-none-{platform}` wheels. This works the same as ABI3 - wheels won't be rebuilt, but tests will still be run across all selected versions of Python.

-  > These wheels contain native extension code, but don't use the Python APIs. Typically, they're bridged to Python using a FFI module like [ctypes](https://docs.python.org/3/library/ctypes.html) or [cffi](https://cffi.readthedocs.io/en/latest/). Because they don't use Python ABI, the wheels are more compatible - they work across many Python versions.
+    These wheels contain native extension code, but don't use the Python APIs. Typically, they're bridged to Python using a FFI module like [ctypes](https://docs.python.org/3/library/ctypes.html) or [cffi](https://cffi.readthedocs.io/en/latest/). Because they don't use Python ABI, the wheels are more compatible - they work across many Python versions.
+
+    Check out this [example ctypes project](https://github.com/joerick/python-ctypes-package-sample) to see an example of how it works. (#1151)

-  Check out this [example ctypes project](https://github.com/joerick/python-ctypes-package-sample) to see an example of how it works. (#1151)
 - 🛠 cibuildwheel will now error if multiple builds in a single run produce the same wheel filename, as this indicates a misconfiguration. (#1152)
 - 📚 A few docs improvements and updates to keep things up-to-date.

@@ -742,6 +756,18 @@ _31 March 2017_

 - 🌟 First public release!

+<style>
+
+/* improve list formatting to help separate items */
+
+.rst-content li {
+  margin-bottom: 12px;
+}
+.rst-content .section ol li>p:only-child, .rst-content .section ol li>p:only-child:last-child, .rst-content .section ul li>p:only-child, .rst-content .section ul li>p:only-child:last-child, .rst-content .toctree-wrapper ol li>p:only-child, .rst-content .toctree-wrapper ol li>p:only-child:last-child, .rst-content .toctree-wrapper ul li>p:only-child, .rst-content .toctree-wrapper ul li>p:only-child:last-child, .rst-content section ol li>p:only-child, .rst-content section ol li>p:only-child:last-child, .rst-content section ul li>p:only-child, .rst-content section ul li>p:only-child:last-child {
+  margin-bottom: 12px
+}
+</style>
+
 <script>
  // undo the scrollTop that the theme did on this page, as there are loads
  // of toc entries and it's disorientating.
@@ -172,11 +172,13 @@

 - name: pyzmq
  gh: zeromq/pyzmq
-  ci: [github]
+  ci: [github, circleci]
  os: [windows, apple, linux]
  ci_config: .github/workflows/wheels.yml
  notes: |
-    Python bindings for zeromq, the networking library. Uses Cython and CFFI.
+    Python bindings for zeromq, the networking library.
+    Uses Cython on CPython and CFFI on PyPy.
+    ARM wheels for linux are built natively on CircleCI.

 - name: python-rapidjson
  gh: python-rapidjson/python-rapidjson
@@ -204,6 +206,12 @@
  ci: [github]
  os: [windows, apple, linux]

+- name: pybind11 cross build example
+  gh: wbarnha/pybind_cmake_example_crossbuild
+  ci: [github, gitlab]
+  os: [windows, apple, linux]
+  notes: Same as pybind11 cmake_example but used to demo Linux ARM + Windows + macOS builds on GitLab
+
 - name: iminuit
  gh: scikit-hep/iminuit
  ci: [github]
@@ -599,7 +607,7 @@
  gh: tensorchord/envd
  ci: [github]
  os: [apple, linux, windows]
-  note: A machine learning development environment build toool
+  note: A machine learning development environment build tool

 - name: mosec
  gh: mosecorg/mosec
@@ -22,7 +22,7 @@ pipx run build --sdist
 # provider can be configured to store them for you. Put them all into the
 # 'dist' folder.

-# Upload using 'twine' (you may need to 'pip install twine')
+# Upload using 'twine'
 pipx run twine upload dist/*
 ```

@@ -82,7 +82,7 @@ This requires a [PyPI upload token](https://pypi.org/manage/account/token/), sto
        password: ${{ secrets.pypi_password }}
 ```

-You should use dependabot to keep the publish action up to date. In the above
+You should use Dependabot to keep the publish action up to date. In the above
 example, the same name (the default, "artifact" is used for all upload-artifact
 runs, so we can just download all of the in one step into a common directory.

@@ -91,7 +91,7 @@ Here's an example Cirrus CI workflow with a job that builds for macOS Intel thro
 {% include "../examples/cirrus-ci-intel-mac.yml" %}
 ```

-### Building non-native architectures using emulation  {: #emulation}
+### Building Linux wheels for non-native archs using emulation  {: #emulation}

 cibuildwheel supports building non-native architectures on Linux, via
 emulation through the binfmt_misc kernel feature. The easiest way to use this
@@ -118,7 +118,7 @@ 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.

-### Building packages with optional C extensions
+### 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.

@@ -132,17 +132,18 @@ myextension = Extension(
 )
 ```

-### Automatic updates {: #automatic-updates}
+### Automatic updates using Dependabot {: #automatic-updates}

 Selecting a moving target (like the latest release) is generally a bad idea in CI. If something breaks, you can't tell whether it was your code or an upstream update that caused the breakage, and in a worse-case scenario, it could occur during a release.
-There are two suggested methods for keeping cibuildwheel up to date that instead involve scheduled pull requests using GitHub's dependabot.
+
+There are two suggested methods for keeping cibuildwheel up to date that instead involve scheduled pull requests using GitHub's Dependabot.

 #### Option 1: GitHub Action

 If you use GitHub Actions for builds, you can use cibuildwheel as an action:

 ```yaml
-uses: pypa/cibuildwheel@v2.10.2
+uses: pypa/cibuildwheel@v2.11.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.
@@ -164,7 +165,7 @@ The second option, and the only one that supports other CI systems, is using a `

 ```bash
 # requirements-cibw.txt
-cibuildwheel==2.10.2
+cibuildwheel==2.11.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:
@@ -260,7 +261,28 @@ To quickly test your config without doing a git push and waiting for your code t

 ### Missing dependencies

-You might need to install something on the build machine. You can do this with apt/yum, brew or choco, using the [`CIBW_BEFORE_ALL`](options.md#before-all) option. Or, for a Python dependency, consider [adding it to pyproject.toml](#cibw-options-alternatives-deps).
+Sometimes a build will fail due to a missing dependency.
+
+**If the build is missing a Python package**, you should [add it to pyproject.toml](#cibw-options-alternatives-deps).
+
+**If you need a build tool** (e.g. cmake, automake, ninja), you can install it through a package manager like apt/yum, brew or choco, using the [`CIBW_BEFORE_ALL`](options.md#before-all) option.
+
+**If your build is linking into a native library dependency**, you can build/install that in [`CIBW_BEFORE_ALL`](options.md#before-all). However, on Linux, Mac (and Windows if you're using [delvewheel]), the library that you install will be bundled into the wheel in the [repair step]. So take care to ensure that
+
+- the bundled library doesn't accidentally increase the minimum system requirements (such as the minimum macOS version)
+- the bundled library matches the architecture of the wheel you're building when cross-compiling
+
+This is particularly an issue on macOS, where de facto package manager Homebrew will install libraries that are compiled for the specific version of macOS that the build machine is running, rendering the wheels useless for any previous version. And brew will not install the right arch for cross compilation of Apple Silicon wheels.
+
+For these reasons, it's strongly recommended to not use brew for native library dependencies. Instead, we recommend compiling the library yourself. If you compile in the [`CIBW_BEFORE_ALL`](options.md#before-all) step, cibuildwheel will have already set the appropriate `MACOSX_DEPLOYMENT_TARGET` env var, so the library will target the correct version of macOS.
+
+!!! tip
+    For build steps, Homebrew is still a great resource - you can [look up the build formula](https://formulae.brew.sh/) and use that as a starting point.
+
+[delvewheel]: https://github.com/adang1345/delvewheel
+[repair step]: options.md#repair-wheel-command
+[Homebrew]: https://brew.sh/
+[delocate]: https://github.com/matthew-brett/delocate

 ### macOS: ModuleNotFoundError

@@ -281,13 +303,14 @@ python3 -m twine upload wheelhouse/*.whl

 This doesn't work because while `cibuildwheel` was running, it installed a few new versions of 'python3', so the `python3` run on line 3 isn't the same as the `python3` that ran on line 1.

-Solutions to this vary, but the simplest is to install tools immediately before they're used:
+Solutions to this vary, but the simplest is to use pipx:

 ```bash
-python3 -m pip install cibuildwheel
-python3 -m cibuildwheel --output-dir wheelhouse
-python3 -m pip install twine
-python3 -m twine upload wheelhouse/*.whl
+# most runners have pipx preinstalled, but in case you don't
+python3 -m pip install pipx
+
+pipx run cibuildwheel==2.11.0 --output-dir wheelhouse
+pipx run twine upload wheelhouse/*.whl
 ```

 ### macOS: Passing DYLD_LIBRARY_PATH to delocate
@@ -318,7 +341,7 @@ See [#816](https://github.com/pypa/cibuildwheel/issues/816), thanks to @phoeriou

 ### Windows: 'ImportError: DLL load failed: The specific module could not be found'

-Visual Studio and MSVC link the compiled binary wheels to the Microsoft Visual C++ Runtime. Normally, these are included with Python, but when compiling with a newer version of Visual Studio, it is possible users will run into problems on systems that do not have these runtime libraries installed. The solution is to ask users to download the corresponding Visual C++ Redistributable from the [Microsoft website](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads) and install it. Since a Python installation normally includes these VC++ Redistributable files for [the version of the MSVC compiler used to compile Python](https://wiki.python.org/moin/WindowsCompilers), this is typically only a problem when compiling a Python C extension with a newer compiler.
+Visual Studio and MSVC link the compiled binary wheels to the Microsoft Visual C++ Runtime. Normally, the C parts of the runtime are included with Python, but the C++ components are not. When compiling modules using C++, it is possible users will run into problems on systems that do not have the full set of runtime libraries installed. The solution is to ask users to download the corresponding Visual C++ Redistributable from the [Microsoft website](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads) and install it.

 Additionally, Visual Studio 2019 started linking to an even newer DLL, `VCRUNTIME140_1.dll`, besides the `VCRUNTIME140.dll` that is included with recent Python versions (starting from Python 3.5; see [here](https://wiki.python.org/moin/WindowsCompilers) for more details on the corresponding Visual Studio & MSVC versions used to compile the different Python versions). To avoid this extra dependency on `VCRUNTIME140_1.dll`, the [`/d2FH4-` flag](https://devblogs.microsoft.com/cppblog/making-cpp-exception-handling-smaller-x64/) can be added to the MSVC invocations (check out [this issue](https://github.com/pypa/cibuildwheel/issues/423) for details and references). CPython 3.8.3 and all versions after it have this extra DLL, so it is only needed for 3.8 and earlier.

@@ -334,4 +357,12 @@ To add the `/d2FH4-` flag to a standard `setup.py` using `setuptools`, the `extr
    ],
 ```

-To investigate the dependencies of a C extension (i.e., the `.pyd` file, a DLL in disguise) on Windows, [Dependency Walker](http://www.dependencywalker.com/) is a great tool.
+To investigate the dependencies of a C extension (i.e., the `.pyd` file, a DLL in disguise) on Windows, [Dependency Walker](http://www.dependencywalker.com/) is a great tool. For diagnosing a failing import, the [dlltracer](https://pypi.org/project/dlltracer/) tool may also provide additional details.
+
+### Windows ARM64 builds {: #windows-arm64}
+
+`cibuildwheel` supports cross-compiling `ARM64` wheels on all Windows runners, but a native ARM64 runner is required for testing. On non-native runners, tests for ARM64 wheels will be automatically skipped with a warning. Add `*-win_arm64` to your `CIBW_TEST_SKIP` setting to suppress the warning.
+
+Cross-compilation on Windows relies on a supported build backend. Supported backends use an environment variable to specify their target platform (the one they are compiling native modules for, as opposed to the one they are running on), which is set in [cibuildwheels/windows.py](https://github.com/pypa/cibuildwheel/blob/main/cibuildwheel/windows.py) before building. Currently, `setuptools>=65.4.1` and `setuptools_rust` are the only supported backends.
+
+By default, `ARM64` is not enabled when running on non-ARM64 runners. Use [`CIBW_ARCHS`](options.md#archs) to select it.
@@ -347,11 +347,14 @@ On macOS, this option can be used to cross-compile between `x86_64`,
 On Linux, this option can be used to build non-native architectures under
 emulation. See [this guide](faq.md#emulation) for more information.

+On Windows, this option can be used to compile for `ARM64` from an Intel
+machine, provided the cross-compiling tools are installed.
+
 Options:

 - Linux: `x86_64` `i686` `aarch64` `ppc64le` `s390x`
 - macOS: `x86_64` `arm64` `universal2`
- Windows: `AMD64` `x86`
+- Windows: `AMD64` `x86` `ARM64`
 - `auto`: The default archs for your machine - see the table below.
    - `auto64`: Just the 64-bit auto archs
    - `auto32`: Just the 32-bit auto archs
@@ -366,6 +369,7 @@ Default: `auto`
 |---|---|---|---|---|
 | Linux / Intel | `x86_64` | `x86_64` `i686` | `x86_64` | `i686` |
 | Windows / Intel | `AMD64` | `AMD64` `x86` | `AMD64` | `x86` |
+| Windows / ARM64 | `ARM64` | `ARM64` | `ARM64` | |
 | macOS / Intel | `x86_64` | `x86_64` | `x86_64` |  |
 | macOS / Apple Silicon | `arm64` | `arm64` | `arm64` |  |

@@ -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.10.2
+            run: pipx run cibuildwheel==2.11.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.10.2
+            run: python -m pip install cibuildwheel==2.11.0

          - name: Build wheels
            run: python -m cibuildwheel --output-dir wheelhouse
@@ -39,8 +39,8 @@ title: Working examples
 | [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][] | ![windows icon][] ![apple icon][] ![linux icon][] | Python bindings for zeromq, the networking library. Uses Cython and CFFI.  |
 | [aiortc][]                        | ![github icon][] | ![apple icon][] ![linux icon][] | WebRTC and ORTC implementation for Python using asyncio. |
-| [Implicit][]                      | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Includes GPU support for linux wheels |
 | [Confluent client for Kafka][]    | ![travisci icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | setup in `tools/wheels/build-wheels.bat` |
+| [Implicit][]                      | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Includes GPU support for linux wheels |
 | [vispy][]                         | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Main repository for Vispy |
 | [tinyobjloader][]                 | ![azurepipelines icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Tiny but powerful single file wavefront obj loader |
 | [Dependency Injector][]           | ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Dependency injection framework for Python, uses Windows TravisCI |
@@ -58,8 +58,8 @@ title: Working examples
 | [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. |
 | [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. |
 | [envd][]                          | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | 🏕️ Development environment for AI/ML, based on buildkit |
+| [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 |
 | [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 |
@@ -69,8 +69,8 @@ title: Working examples
 | [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 |
-| [python-snappy][]                 | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Python bindings for the snappy google library |
 | [pybind11 cmake_example][]        | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Example pybind11 module built with a CMake-based build system |
+| [python-snappy][]                 | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Python bindings for the snappy google library |
 | [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. |
 | [pybind11 python_example][]       | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Example pybind11 module built with a Python-based build system |
@@ -85,10 +85,10 @@ title: Working examples
 | [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. |
 | [boost-histogram][]               | ![github icon][] ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Supports full range of wheels, including PyPy and alternate archs. |
 | [TgCrypto][]                      | ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Includes a Windows Travis build. |
-| [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 |
 | [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 |
@@ -96,20 +96,20 @@ title: Working examples
 | [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. |
-| [cf-units][]                      | ![github icon][] | ![apple icon][] ![linux icon][] | Units of measure as required by the Climate and Forecast (CF) Metadata Conventions |
 | [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. |
 | [pillow-heif][]                   | ![github icon][] | ![apple icon][] ![linux icon][] | Python CFFI binding to libheif library with third party dependencies like `libde265`, `x265`, `libaom` with test & publishing on PyPi. |
 | [power-grid-model][]              | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Python/C++ library for distribution power system analysis |
+| [cf-units][]                      | ![github icon][] | ![apple icon][] ![linux icon][] | Units of measure as required by the Climate and Forecast (CF) Metadata Conventions |
 | [clang-format][]                  | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Scikit-build wrapper around LLVM's CMake, all platforms, generic wheels. |
 | [numpythia][]                     | ![github icon][] | ![apple icon][] ![linux icon][] | The interface between PYTHIA and NumPy |
 | [pybind11 scikit_build_example][] | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | An example combining scikit-build and pybind11 |
 | [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. |
-| [pyinstrument_cext][]             | ![travisci icon][] ![appveyor icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A simple C extension, without external dependencies |
 | [CorrectionLib][]                 | ![github icon][] | ![apple icon][] ![linux icon][] | Structured JSON powered correction library for HEP, designed for the CMS experiment at CERN. |
-| [xmlstarlet][]                    | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Python 3.6+ CFFI bindings with true MSVC build. |
+| [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. |
+| [xmlstarlet][]                    | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Python 3.6+ CFFI bindings with true MSVC build. |
 | [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. |

 [scikit-learn]: https://github.com/scikit-learn/scikit-learn
@@ -143,8 +143,8 @@ title: Working examples
 [OpenSpiel]: https://github.com/deepmind/open_spiel
 [pyzmq]: https://github.com/zeromq/pyzmq
 [aiortc]: https://github.com/aiortc/aiortc
-[Implicit]: https://github.com/benfred/implicit
 [Confluent client for Kafka]: https://github.com/confluentinc/confluent-kafka-python
+[Implicit]: https://github.com/benfred/implicit
 [vispy]: https://github.com/vispy/vispy
 [tinyobjloader]: https://github.com/tinyobjloader/tinyobjloader
 [Dependency Injector]: https://github.com/ets-labs/python-dependency-injector
@@ -162,8 +162,8 @@ title: Working examples
 [PyTables]: https://github.com/PyTables/PyTables
 [OpenTimelineIO]: https://github.com/PixarAnimationStudios/OpenTimelineIO
 [aioquic]: https://github.com/aiortc/aioquic
-[ruptures]: https://github.com/deepcharles/ruptures
 [envd]: https://github.com/tensorchord/envd
+[ruptures]: https://github.com/deepcharles/ruptures
 [Psycopg 3]: https://github.com/psycopg/psycopg
 [DeepForest]: https://github.com/LAMDA-NJU/Deep-Forest
 [google neuroglancer]: https://github.com/google/neuroglancer
@@ -173,8 +173,8 @@ title: Working examples
 [Rtree]: https://github.com/Toblerity/rtree
 [markupsafe]: https://github.com/pallets/markupsafe
 [python-rapidjson]: https://github.com/python-rapidjson/python-rapidjson
-[python-snappy]: https://github.com/andrix/python-snappy
 [pybind11 cmake_example]: https://github.com/pybind/cmake_example
+[python-snappy]: https://github.com/andrix/python-snappy
 [KDEpy]: https://github.com/tommyod/KDEpy
 [tgcalls]: https://github.com/MarshalX/tgcalls
 [pybind11 python_example]: https://github.com/pybind/python_example
@@ -189,10 +189,10 @@ title: Working examples
 [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
 [boost-histogram]: https://github.com/scikit-hep/boost-histogram
 [TgCrypto]: https://github.com/pyrogram/tgcrypto
-[mosec]: https://github.com/mosecorg/mosec
 [iDynTree]: https://github.com/robotology/idyntree
 [Python-WebRTC]: https://github.com/MarshalX/python-webrtc
 [pybase64]: https://github.com/mayeut/pybase64
@@ -200,20 +200,20 @@ title: Working examples
 [fathon]: https://github.com/stfbnc/fathon
 [etebase-py]: https://github.com/etesync/etebase-py
 [polaroid]: https://github.com/daggy1234/polaroid
-[cf-units]: https://github.com/SciTools/cf-units
 [Imagecodecs (fork)]: https://github.com/czaki/imagecodecs_build
 [pillow-heif]: https://github.com/bigcat88/pillow_heif
 [power-grid-model]: https://github.com/alliander-opensource/power-grid-model
+[cf-units]: https://github.com/SciTools/cf-units
 [clang-format]: https://github.com/ssciwr/clang-format-wheel
 [numpythia]: https://github.com/scikit-hep/numpythia
 [pybind11 scikit_build_example]: https://github.com/pybind/scikit_build_example
 [pyjet]: https://github.com/scikit-hep/pyjet
 [ninja]: https://github.com/scikit-build/ninja-python-distributions
 [GSD]: https://github.com/glotzerlab/gsd
-[pyinstrument_cext]: https://github.com/joerick/pyinstrument_cext
 [CorrectionLib]: https://github.com/cms-nanoAOD/correctionlib
-[xmlstarlet]: https://github.com/dimitern/xmlstarlet
+[pyinstrument_cext]: https://github.com/joerick/pyinstrument_cext
 [SiPM]: https://github.com/EdoPro98/SimSiPM
+[xmlstarlet]: https://github.com/dimitern/xmlstarlet
 [ril]: https://github.com/Cryptex-github/ril-py

 [appveyor icon]: data/readme_icons/appveyor.svg
@@ -227,109 +227,109 @@ title: Working examples
 [apple icon]: data/readme_icons/apple.svg
 [linux icon]: data/readme_icons/linux.svg

-<!-- scikit-learn: 51403, last pushed 0 days ago -->
-<!-- NumPy: 21474, last pushed 0 days ago -->
-<!-- Tornado: 20743, last pushed 12 days ago -->
-<!-- pytorch-fairseq: 19191, last pushed 2 days ago -->
-<!-- Matplotlib: 16136, last pushed 0 days ago -->
-<!-- NCNN: 15506, last pushed 0 days ago -->
-<!-- Kivy: 15023, last pushed 6 days ago -->
-<!-- Prophet: 14915, last pushed 1 days ago -->
-<!-- MyPy: 13792, last pushed 0 days ago -->
-<!-- pydantic: 11091, last pushed 2 days ago -->
-<!-- MemRay: 9238, last pushed 0 days ago -->
-<!-- uvloop: 8881, last pushed 2 days ago -->
-<!-- psutil: 8696, last pushed 0 days ago -->
-<!-- vaex: 7296, last pushed 2 days ago -->
-<!-- Google Benchmark: 6836, last pushed 4 days ago -->
-<!-- duckdb: 6390, last pushed 0 days ago -->
-<!-- Apache Beam: 5862, last pushed 0 days ago -->
-<!-- asyncpg: 5635, last pushed 1 days ago -->
-<!-- PyGame: 5210, last pushed 0 days ago -->
-<!-- cmake: 5079, last pushed 0 days ago -->
-<!-- scikit-image: 5042, last pushed 0 days ago -->
-<!-- twisted-iocpsupport: 4749, last pushed 0 days ago -->
-<!-- PyOxidizer: 4292, last pushed 0 days ago -->
-<!-- websockets: 4163, last pushed 2 days ago -->
-<!-- cvxpy: 4082, last pushed 0 days ago -->
-<!-- Triton: 4009, last pushed 0 days ago -->
-<!-- UltraJSON: 3840, last pushed 3 days ago -->
-<!-- River: 3622, last pushed 3 days ago -->
-<!-- OpenSpiel: 3318, last pushed 1 days ago -->
-<!-- pyzmq: 3156, last pushed 2 days ago -->
-<!-- aiortc: 3072, last pushed 12 days ago -->
-<!-- Implicit: 2946, last pushed 18 days ago -->
-<!-- Confluent client for Kafka: 2932, last pushed 1 days ago -->
-<!-- vispy: 2931, last pushed 0 days ago -->
-<!-- tinyobjloader: 2643, last pushed 75 days ago -->
-<!-- Dependency Injector: 2361, last pushed 10 days ago -->
-<!-- coverage.py: 2196, last pushed 1 days ago -->
-<!-- PyCryptodome: 2125, last pushed 16 days ago -->
-<!-- PyYAML: 1932, last pushed 5 days ago -->
-<!-- numexpr: 1813, last pushed 13 days ago -->
-<!-- h5py: 1778, last pushed 1 days ago -->
-<!-- Wrapt: 1743, last pushed 25 days ago -->
-<!-- PyAV: 1659, last pushed 5 days ago -->
-<!-- SimpleJSON: 1519, last pushed 79 days ago -->
-<!-- pikepdf: 1491, last pushed 0 days ago -->
-<!-- Line Profiler: 1372, last pushed 2 days ago -->
-<!-- OpenColorIO: 1364, last pushed 8 days ago -->
-<!-- PyTables: 1148, last pushed 3 days ago -->
-<!-- OpenTimelineIO: 1096, last pushed 0 days ago -->
-<!-- aioquic: 1055, last pushed 1 days ago -->
-<!-- ruptures: 1043, last pushed 24 days ago -->
-<!-- envd: 988, last pushed 0 days ago -->
-<!-- Psycopg 3: 784, last pushed 0 days ago -->
-<!-- DeepForest: 777, last pushed 0 days ago -->
-<!-- google neuroglancer: 753, last pushed 10 days ago -->
-<!-- Parselmouth: 695, last pushed 70 days ago -->
-<!-- AutoPy: 674, last pushed 267 days ago -->
-<!-- H3-py: 560, last pushed 21 days ago -->
-<!-- Rtree: 502, last pushed 152 days ago -->
-<!-- markupsafe: 494, last pushed 13 days ago -->
-<!-- python-rapidjson: 459, last pushed 60 days ago -->
-<!-- python-snappy: 443, last pushed 186 days ago -->
-<!-- pybind11 cmake_example: 441, last pushed 2 days ago -->
-<!-- KDEpy: 404, last pushed 220 days ago -->
-<!-- tgcalls: 390, last pushed 79 days ago -->
-<!-- pybind11 python_example: 363, last pushed 0 days ago -->
-<!-- dd-trace-py: 357, last pushed 0 days ago -->
-<!-- CTranslate2: 334, last pushed 2 days ago -->
-<!-- time-machine: 330, last pushed 6 days ago -->
-<!-- sourmash: 321, last pushed 0 days ago -->
-<!-- cyvcf2: 305, last pushed 34 days ago -->
-<!-- matrixprofile: 285, last pushed 76 days ago -->
-<!-- abess: 282, last pushed 7 days ago -->
-<!-- jq.py: 229, last pushed 6 days ago -->
-<!-- iminuit: 212, last pushed 23 days ago -->
-<!-- Tokenizer: 187, last pushed 5 days ago -->
-<!-- PyGLM: 151, last pushed 174 days ago -->
-<!-- bx-python: 118, last pushed 21 days ago -->
-<!-- boost-histogram: 116, last pushed 1 days ago -->
-<!-- TgCrypto: 110, last pushed 198 days ago -->
-<!-- mosec: 109, last pushed 2 days ago -->
-<!-- iDynTree: 108, last pushed 3 days ago -->
-<!-- Python-WebRTC: 94, last pushed 192 days ago -->
-<!-- pybase64: 88, last pushed 5 days ago -->
-<!-- Arbor: 80, last pushed 1 days ago -->
-<!-- fathon: 68, last pushed 108 days ago -->
-<!-- etebase-py: 58, last pushed 74 days ago -->
-<!-- polaroid: 54, last pushed 130 days ago -->
+<!-- scikit-learn: 51616, last pushed 0 days ago -->
+<!-- NumPy: 21640, last pushed 0 days ago -->
+<!-- Tornado: 20782, last pushed 2 days ago -->
+<!-- pytorch-fairseq: 19374, last pushed 0 days ago -->
+<!-- Matplotlib: 16230, last pushed 0 days ago -->
+<!-- NCNN: 15677, last pushed 0 days ago -->
+<!-- Kivy: 15103, last pushed 1 days ago -->
+<!-- Prophet: 14975, last pushed 18 days ago -->
+<!-- MyPy: 13907, last pushed 0 days ago -->
+<!-- pydantic: 11233, last pushed 2 days ago -->
+<!-- MemRay: 9338, last pushed 5 days ago -->
+<!-- uvloop: 8927, last pushed 8 days ago -->
+<!-- psutil: 8752, last pushed 1 days ago -->
+<!-- vaex: 7335, last pushed 2 days ago -->
+<!-- Google Benchmark: 6899, last pushed 3 days ago -->
+<!-- duckdb: 6753, last pushed 0 days ago -->
+<!-- Apache Beam: 5927, last pushed 0 days ago -->
+<!-- asyncpg: 5661, last pushed 5 days ago -->
+<!-- PyGame: 5272, last pushed 0 days ago -->
+<!-- cmake: 5138, last pushed 0 days ago -->
+<!-- scikit-image: 5073, last pushed 0 days ago -->
+<!-- twisted-iocpsupport: 4778, last pushed 0 days ago -->
+<!-- PyOxidizer: 4339, last pushed 6 days ago -->
+<!-- websockets: 4192, last pushed 0 days ago -->
+<!-- cvxpy: 4115, last pushed 0 days ago -->
+<!-- Triton: 4085, last pushed 0 days ago -->
+<!-- UltraJSON: 3863, last pushed 5 days ago -->
+<!-- River: 3723, last pushed 1 days ago -->
+<!-- OpenSpiel: 3334, last pushed 0 days ago -->
+<!-- pyzmq: 3173, last pushed 6 days ago -->
+<!-- aiortc: 3089, last pushed 11 days ago -->
+<!-- Confluent client for Kafka: 2976, last pushed 4 days ago -->
+<!-- Implicit: 2963, last pushed 5 days ago -->
+<!-- vispy: 2941, last pushed 1 days ago -->
+<!-- tinyobjloader: 2666, last pushed 0 days ago -->
+<!-- Dependency Injector: 2411, last pushed 31 days ago -->
+<!-- coverage.py: 2222, last pushed 0 days ago -->
+<!-- PyCryptodome: 2143, last pushed 9 days ago -->
+<!-- PyYAML: 1951, last pushed 8 days ago -->
+<!-- numexpr: 1822, last pushed 34 days ago -->
+<!-- h5py: 1789, last pushed 8 days ago -->
+<!-- Wrapt: 1764, last pushed 46 days ago -->
+<!-- PyAV: 1677, last pushed 17 days ago -->
+<!-- SimpleJSON: 1525, last pushed 100 days ago -->
+<!-- pikepdf: 1522, last pushed 5 days ago -->
+<!-- Line Profiler: 1405, last pushed 6 days ago -->
+<!-- OpenColorIO: 1374, last pushed 3 days ago -->
+<!-- PyTables: 1151, last pushed 3 days ago -->
+<!-- OpenTimelineIO: 1105, last pushed 0 days ago -->
+<!-- aioquic: 1084, last pushed 8 days ago -->
+<!-- envd: 1068, last pushed 0 days ago -->
+<!-- ruptures: 1055, last pushed 2 days ago -->
+<!-- Psycopg 3: 801, last pushed 3 days ago -->
+<!-- DeepForest: 783, last pushed 9 days ago -->
+<!-- google neuroglancer: 763, last pushed 2 days ago -->
+<!-- Parselmouth: 713, last pushed 4 days ago -->
+<!-- AutoPy: 678, last pushed 19 days ago -->
+<!-- H3-py: 566, last pushed 0 days ago -->
+<!-- Rtree: 504, last pushed 14 days ago -->
+<!-- markupsafe: 497, last pushed 6 days ago -->
+<!-- python-rapidjson: 460, last pushed 81 days ago -->
+<!-- pybind11 cmake_example: 452, last pushed 6 days ago -->
+<!-- python-snappy: 445, last pushed 207 days ago -->
+<!-- KDEpy: 407, last pushed 7 days ago -->
+<!-- tgcalls: 392, last pushed 100 days ago -->
+<!-- pybind11 python_example: 366, last pushed 13 days ago -->
+<!-- dd-trace-py: 363, last pushed 0 days ago -->
+<!-- CTranslate2: 344, last pushed 6 days ago -->
+<!-- time-machine: 339, last pushed 1 days ago -->
+<!-- sourmash: 325, last pushed 3 days ago -->
+<!-- cyvcf2: 305, last pushed 11 days ago -->
+<!-- matrixprofile: 289, last pushed 3 days ago -->
+<!-- abess: 288, last pushed 28 days ago -->
+<!-- jq.py: 233, last pushed 20 days ago -->
+<!-- iminuit: 213, last pushed 7 days ago -->
+<!-- Tokenizer: 191, last pushed 26 days ago -->
+<!-- PyGLM: 151, last pushed 195 days ago -->
+<!-- mosec: 120, last pushed 1 days ago -->
+<!-- bx-python: 119, last pushed 42 days ago -->
+<!-- boost-histogram: 116, last pushed 3 days ago -->
+<!-- TgCrypto: 113, last pushed 219 days ago -->
+<!-- iDynTree: 109, last pushed 24 days ago -->
+<!-- Python-WebRTC: 95, last pushed 213 days ago -->
+<!-- pybase64: 89, last pushed 3 days ago -->
+<!-- Arbor: 81, last pushed 3 days ago -->
+<!-- fathon: 72, last pushed 129 days ago -->
+<!-- etebase-py: 58, last pushed 95 days ago -->
+<!-- polaroid: 56, last pushed 151 days ago -->
+<!-- Imagecodecs (fork): 50, last pushed 13 days ago -->
+<!-- pillow-heif: 49, last pushed 5 days ago -->
+<!-- power-grid-model: 49, last pushed 2 days ago -->
 <!-- cf-units: 49, last pushed 0 days ago -->
-<!-- Imagecodecs (fork): 48, last pushed 41 days ago -->
-<!-- pillow-heif: 48, last pushed 6 days ago -->
-<!-- power-grid-model: 48, last pushed 2 days ago -->
-<!-- clang-format: 43, last pushed 12 days ago -->
-<!-- numpythia: 34, last pushed 18 days ago -->
-<!-- pybind11 scikit_build_example: 33, last pushed 0 days ago -->
-<!-- pyjet: 32, last pushed 18 days ago -->
-<!-- ninja: 25, last pushed 0 days ago -->
+<!-- clang-format: 44, last pushed 8 days ago -->
+<!-- numpythia: 35, last pushed 8 days ago -->
+<!-- pybind11 scikit_build_example: 34, last pushed 13 days ago -->
+<!-- pyjet: 33, last pushed 8 days ago -->
+<!-- ninja: 26, last pushed 11 days ago -->
 <!-- GSD: 19, last pushed 6 days ago -->
-<!-- pyinstrument_cext: 10, last pushed 345 days ago -->
-<!-- CorrectionLib: 10, last pushed 4 days ago -->
-<!-- xmlstarlet: 9, last pushed 34 days ago -->
-<!-- SiPM: 8, last pushed 109 days ago -->
-<!-- ril: 5, last pushed 5 days ago -->
+<!-- CorrectionLib: 11, last pushed 3 days ago -->
+<!-- pyinstrument_cext: 10, last pushed 366 days ago -->
+<!-- SiPM: 10, last pushed 130 days ago -->
+<!-- xmlstarlet: 8, last pushed 6 days ago -->
+<!-- ril: 8, last pushed 26 days ago -->

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

@@ -12,7 +12,7 @@ stack: python 3.7
 init:
 - cmd: set PATH=C:\Python37;C:\Python37\Scripts;%PATH%

-install: python -m pip install cibuildwheel==2.10.2
+install: python -m pip install cibuildwheel==2.11.0

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

@@ -1,12 +1,12 @@
 jobs:
 - job: linux
-  pool: {vmImage: 'Ubuntu-16.04'}
+  pool: {vmImage: 'Ubuntu-20.04'}
  steps:
    - task: UsePythonVersion@0
    - bash: |
        set -o errexit
        python3 -m pip install --upgrade pip
-        pip3 install cibuildwheel==2.10.2
+        pip3 install cibuildwheel==2.11.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.10.2
+        python3 -m pip install cibuildwheel==2.11.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.10.2
+        pip install cibuildwheel==2.11.0
      displayName: Install dependencies
    - bash: cibuildwheel --output-dir wheelhouse .
      displayName: Build wheels
@@ -11,11 +11,28 @@ jobs:
      - run:
          name: Build the Linux wheels.
          command: |
-            pip3 install --user cibuildwheel==2.10.2
+            pip3 install --user cibuildwheel==2.11.0
            cibuildwheel --output-dir wheelhouse
      - store_artifacts:
          path: wheelhouse/

+  linux-aarch64-wheels:
+    working_directory: ~/linux-aarch64-wheels
+    machine:
+      image: ubuntu-2004:2022.04.1
+    # resource_class is what tells CircleCI to use an ARM worker for native arm builds
+    # https://circleci.com/product/features/resource-classes/
+    resource_class: arm.medium
+    steps:
+      - checkout
+      - run:
+          name: Build the Linux aarch64 wheels.
+          command: |
+            python3 -m pip install --user cibuildwheel==2.11.0
+            python3 -m cibuildwheel --output-dir wheelhouse
+      - store_artifacts:
+          path: wheelhouse/
+
  osx-wheels:
    working_directory: ~/osx-wheels
    macos:
@@ -25,7 +42,7 @@ jobs:
      - run:
          name: Build the OS X wheels.
          command: |
-            pip3 install cibuildwheel==2.10.2
+            pip3 install cibuildwheel==2.11.0
            cibuildwheel --output-dir wheelhouse
      - store_artifacts:
          path: wheelhouse/
@@ -35,4 +52,5 @@ workflows:
  all-tests:
    jobs:
      - linux-wheels
+      - linux-aarch64-wheels
      - osx-wheels
@@ -1,6 +1,6 @@
 build_and_store_wheels: &BUILD_AND_STORE_WHEELS
  install_cibuildwheel_script:
-    - python -m pip install cibuildwheel==2.10.2
+    - python -m pip install cibuildwheel==2.11.0
  run_cibuildwheel_script:
    - cibuildwheel
  wheels_artifacts:
@@ -1,6 +1,6 @@
 build_and_store_wheels: &BUILD_AND_STORE_WHEELS
  install_cibuildwheel_script:
-    - python -m pip install cibuildwheel==2.10.2
+    - python -m pip install cibuildwheel==2.11.0
  run_cibuildwheel_script:
    - cibuildwheel
  wheels_artifacts:
@@ -10,7 +10,7 @@ jobs:
      - uses: actions/checkout@v3

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

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

      - name: Build wheels
-        uses: pypa/cibuildwheel@v2.10.2
+        uses: pypa/cibuildwheel@v2.11.0

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

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

      - name: Build wheels
-        uses: pypa/cibuildwheel@v2.10.2
+        uses: pypa/cibuildwheel@v2.11.0
        env:
          # configure cibuildwheel to build native archs ('auto'), and some
          # emulated ones
@@ -12,8 +12,22 @@ linux:
    DOCKER_TLS_CERTDIR: ""
  script:
    - curl -sSL https://get.docker.com/ | sh
-    - python -m pip install cibuildwheel==2.10.2
+    - python -m pip install cibuildwheel==2.11.0
    - cibuildwheel --output-dir wheelhouse
  artifacts:
    paths:
      - wheelhouse/
+
+windows:
+  image: mcr.microsoft.com/windows/servercore:1809
+  before_script:
+    - choco install python -y --version 3.8.6
+    - choco install git.install -y
+    - py -m pip install cibuildwheel==2.11.0
+  script:
+    - py -m cibuildwheel --output-dir wheelhouse --platform windows
+  artifacts:
+    paths:
+      - wheelhouse/
+  tags:
+    - windows
@@ -0,0 +1,22 @@
+linux:
+  image: python:3.8
+  # make a docker daemon available for cibuildwheel to use
+  services:
+    - name: docker:dind
+      entrypoint: ["env", "-u", "DOCKER_HOST"]
+      command: ["dockerd-entrypoint.sh"]
+  variables:
+    DOCKER_HOST: tcp://docker:2375/
+    DOCKER_DRIVER: overlay2
+    # See https://github.com/docker-library/docker/pull/166
+    DOCKER_TLS_CERTDIR: ""
+  script:
+    - 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.0
+    # Assuming your CI runner's default architecture is x86_64...
+    - cibuildwheel --output-dir wheelhouse --platform linux --archs aarch64
+  artifacts:
+    paths:
+      - wheelhouse/
@@ -4,6 +4,7 @@
 os: linux
 dist: focal
 language: python
+python: "3.9"

 jobs:
  include:
@@ -19,7 +20,7 @@ jobs:
        - ln -s /c/Python38/python.exe /c/Python38/python3.exe

 install:
-  - python3 -m pip install cibuildwheel==2.10.2
+  - python3 -m pip install cibuildwheel==2.11.0

 script:
  # build the wheels, put them into './dist'
@@ -1,6 +1,7 @@
 os: linux
 dist: focal
 language: python
+python: "3.9"

 jobs:
  include:
@@ -25,7 +26,7 @@ jobs:
        - ln -s /c/Python38/python.exe /c/Python38/python3.exe

 install:
-  - python3 -m pip install cibuildwheel==2.10.2
+  - python3 -m pip install cibuildwheel==2.11.0

 script:
  # build the wheels, put them into './wheelhouse'
@@ -54,7 +54,7 @@ jobs:
    - stage: deploy
      name: Build and deploy Linux wheels
      services: docker
-      install: python3 -m pip install cibuildwheel==2.10.2 twine
+      install: python3 -m pip install cibuildwheel==2.11.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.10.2 twine
+      install: python3 -m pip install cibuildwheel==2.11.0 twine
      script: python3 -m cibuildwheel --output-dir wheelhouse
      after_success: python3 -m twine upload --skip-existing wheelhouse/*.whl

@@ -1,6 +1,6 @@
 [metadata]
 name = cibuildwheel
-version = 2.10.2
+version = 2.11.0
 description = Build Python wheels on CI with minimal configuration.
 long_description = file: README.md
 long_description_content_type = text/markdown
@@ -8,6 +8,12 @@ def pytest_addoption(parser) -> None:
        "--run-emulation", action="store_true", default=False, help="run emulation tests"
    )
    parser.addoption("--run-podman", action="store_true", default=False, help="run podman tests")
+    parser.addoption(
+        "--run-cp38-universal2",
+        action="store_true",
+        default=False,
+        help="macOS cp38 uses the universal2 installer",
+    )


@pytest.fixture(
@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+import platform
+import subprocess
+
+import pytest
+
+from . import test_projects, utils
+
+
+def test_python_exist(tmp_path, capfd):
+    if utils.platform != "linux":
+        pytest.skip("the test is only relevant to the linux build")
+    machine = platform.machine()
+    if machine not in ["x86_64", "i686"]:
+        pytest.skip(
+            "this test is currently only possible on x86_64/i686 due to availability of alternative images"
+        )
+
+    project_dir = tmp_path / "project"
+    basic_project = test_projects.new_c_project()
+    basic_project.generate(project_dir)
+
+    with pytest.raises(subprocess.CalledProcessError):
+        utils.cibuildwheel_run(
+            project_dir,
+            add_env={
+                "CIBW_MANYLINUX_X86_64_IMAGE": "manylinux2010",
+                "CIBW_MANYLINUX_I686_IMAGE": "manylinux2010",
+                "CIBW_BUILD": "cp3{10,11}-manylinux*",
+            },
+        )
+
+    captured = capfd.readouterr()
+    print("out", captured.out)
+    print("err", captured.err)
+    assert f" to build 'cp310-manylinux_{machine}'." not in captured.err
+    message = (
+        "'/opt/python/cp311-cp311/bin/python' executable doesn't exist"
+        f" in image 'quay.io/pypa/manylinux2010_{machine}:2022-08-05-4535177'"
+        f" to build 'cp311-manylinux_{machine}'."
+    )
+    assert message in captured.err
@@ -167,3 +167,33 @@ def test_cp38_arm64_testing(tmp_path, capfd):
    expected_wheels = [w for w in ALL_MACOS_WHEELS if "cp38" in w]

    assert set(actual_wheels) == set(expected_wheels)
+
+
+def test_cp38_arm64_testing_universal2_installer(tmp_path, capfd, request):
+    if not request.config.getoption("--run-cp38-universal2"):
+        pytest.skip("needs --run-cp38-universal2 option to run")
+
+    project_dir = tmp_path / "project"
+    basic_project.generate(project_dir)
+
+    actual_wheels = utils.cibuildwheel_run(
+        project_dir,
+        add_env={
+            "CIBW_BUILD": "cp38-*",
+            "CIBW_TEST_COMMAND": '''python -c "import platform; print('running tests on ' + platform.machine())"''',
+            "CIBW_ARCHS": "x86_64,universal2,arm64",
+            "MACOSX_DEPLOYMENT_TARGET": "11.0",
+        },
+    )
+
+    captured = capfd.readouterr()
+
+    assert "running tests on x86_64" in captured.out
+    assert "running tests on arm64" in captured.out
+
+    warning_message = "While cibuildwheel can build CPython 3.8 universal2/arm64 wheels, we cannot test the arm64 part of them"
+    assert warning_message not in captured.err
+
+    expected_wheels = [w.replace("10_9", "11_0") for w in ALL_MACOS_WHEELS if "cp38" in w]
+
+    assert set(actual_wheels) == set(expected_wheels)
@@ -0,0 +1,77 @@
+from __future__ import annotations
+
+import os
+import subprocess
+import textwrap
+
+import pytest
+
+from . import test_projects, utils
+
+basic_project = test_projects.new_c_project()
+
+
+def skip_if_no_msvc(arm64=False):
+    programfiles = os.getenv("ProgramFiles(x86)", "") or os.getenv("ProgramFiles", "")
+    if not programfiles:
+        pytest.skip("Requires %ProgramFiles(x86)% variable to be set")
+
+    vswhere = os.path.join(programfiles, "Microsoft Visual Studio", "Installer", "vswhere.exe")
+    if not os.path.isfile(vswhere):
+        pytest.skip("Requires Visual Studio installation")
+
+    require = "Microsoft.VisualStudio.Component.VC.Tools.x86.x64"
+    if arm64:
+        require = "Microsoft.VisualStudio.Component.VC.Tools.ARM64"
+
+    if not subprocess.check_output(
+        [
+            vswhere,
+            "-latest",
+            "-prerelease",
+            "-property",
+            "installationPath",
+            "-requires",
+            require,
+        ]
+    ):
+        pytest.skip("Requires ARM64 compiler to be installed")
+
+
+@pytest.mark.parametrize("use_pyproject_toml", [True, False])
+def test_wheel_tag_is_correct_when_using_windows_cross_compile(tmp_path, use_pyproject_toml):
+    if utils.platform != "windows":
+        pytest.skip("This test is only relevant to Windows")
+
+    skip_if_no_msvc(arm64=True)
+
+    if use_pyproject_toml:
+        basic_project.files["pyproject.toml"] = textwrap.dedent(
+            """
+            [build-system]
+            requires = ["setuptools"]
+            build-backend = "setuptools.build_meta"
+            """
+        )
+
+    project_dir = tmp_path / "project"
+    basic_project.generate(project_dir)
+
+    # build the wheels
+    actual_wheels = utils.cibuildwheel_run(
+        project_dir,
+        add_env={
+            "CIBW_BUILD": "cp310-*",
+        },
+        add_args=["--archs", "ARM64"],
+    )
+
+    # check that the expected wheels are produced
+    expected_wheels = [
+        "spam-0.1.0-cp310-cp310-win_arm64.whl",
+    ]
+
+    print("actual_wheels", actual_wheels)
+    print("expected_wheels", expected_wheels)
+
+    assert set(actual_wheels) == set(expected_wheels)
@@ -12,6 +12,8 @@ import subprocess
 import sys
 from tempfile import TemporaryDirectory

+from cibuildwheel.util import CIBW_CACHE_PATH
+
 platform: str

 if "CIBW_PLATFORM" in os.environ:
@@ -47,6 +49,20 @@ def cibuildwheel_get_build_identifiers(project_path, env=None, *, prerelease_pyt
    return cmd_output.strip().split("\n")


+def _update_pip_cache_dir(env: dict[str, str]) -> None:
+    # Fix for pip concurrency bug https://github.com/pypa/pip/issues/11340
+    # See https://github.com/pypa/cibuildwheel/issues/1254 for discussion.
+    if platform == "linux":
+        return
+    if "PIP_CACHE_DIR" in env:
+        return
+    worker_id = os.environ.get("PYTEST_XDIST_WORKER")
+    if worker_id is None or worker_id == "gw0":
+        return
+    pip_cache_dir = CIBW_CACHE_PATH / "test_cache" / f"pip_cache_dir_{worker_id}"
+    env["PIP_CACHE_DIR"] = str(pip_cache_dir)
+
+
 def cibuildwheel_run(
    project_path, package_dir=".", env=None, add_env=None, output_dir=None, add_args=None
 ):
@@ -76,6 +92,8 @@ def cibuildwheel_run(
    if add_env is not None:
        env.update(add_env)

+    _update_pip_cache_dir(env)
+
    with TemporaryDirectory() as tmp_output_dir:
        subprocess.run(
            [
@@ -11,6 +11,12 @@ MOCK_PACKAGE_DIR = Path("some_package_dir")
 def pytest_addoption(parser):
    parser.addoption("--run-docker", action="store_true", default=False, help="run docker tests")
    parser.addoption("--run-podman", action="store_true", default=False, help="run podman tests")
+    parser.addoption(
+        "--run-cp38-universal2",
+        action="store_true",
+        default=False,
+        help="macOS cp38 uses the universal2 installer",
+    )


@pytest.fixture
Author	SHA1	Message	Date
Joe Rickerby	a9ad61c87f	Bump version: v2.11.0	2022-10-13 09:54:44 +01:00
Joe Rickerby	563b1c159b	Merge pull request #1296 from pypa/example-configs CI updates, fix up example configs	2022-10-13 09:07:15 +01:00
Joe Rickerby	bea8df945a	Merge pull request #1307 from minrk/circle-aarch64 docs for native arm building on circleci	2022-10-13 09:05:37 +01:00
Min RK	4c3062199e	add linux-aarch64 to circleci tests	2022-10-12 13:43:33 +02:00
Min RK	76b3bfcf95	Merge branch 'main' into circle-aarch64	2022-10-12 13:38:52 +02:00
Joe Rickerby	d7f615add6	Merge pull request #1295 from wbarnha/extend-gitlab-qemu Update GitLab support	2022-10-12 09:19:06 +01:00
Min RK	b34af8dcc7	README: circleci supports linux arm	2022-10-12 09:31:45 +02:00
Min RK	ea535dca43	add native arm builds to circleci-minimal example	2022-10-12 09:23:58 +02:00
Min RK	344d3e5845	pyzmq uses circleci for native arm builds	2022-10-12 09:23:43 +02:00
cibuildwheel-bot[bot]andcibuildwheel-bot[bot] <83877280+cibuildwheel-bot[bot]@users.noreply.github.com>	27be463f2e	[Bot] Update dependencies (#1302 ) Update dependencies Co-authored-by: cibuildwheel-bot[bot] <83877280+cibuildwheel-bot[bot]@users.noreply.github.com>	2022-10-11 10:06:49 -04:00
Henry Schreiner	13b92f9c2d	fix: hide root pip warning on Linux (#1304 ) Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com> Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>	2022-10-11 10:06:35 -04:00
Joe Rickerby	f8699095c6	Merge remote-tracking branch 'origin/main' into extend-gitlab-qemu	2022-10-11 09:07:22 +01:00
Joe Rickerby	cc638121b5	Merge pull request #1305 from pypa/pre-commit-ci-update-config [pre-commit.ci] pre-commit autoupdate	2022-10-11 09:00:17 +01:00
Joe Rickerby	61999a886b	Merge pull request #1144 from zooba/arm64 Enable building for Windows ARM64 on a non-ARM64 device	2022-10-11 08:52:23 +01:00
Matthieu Darbois	cdb1c5a49e	fix(tests): use a specific `PIP_CACHE_DIR` per worker (#1301 ) This should most likely resolve random failures seen with pip when running tests in parallel.	2022-10-10 22:02:28 -04:00
pre-commit-ci[bot]	c5e88d2dfe	[pre-commit.ci] pre-commit autoupdate updates: - [github.com/asottile/pyupgrade: v2.38.2 → v3.0.0](https://github.com/asottile/pyupgrade/compare/v2.38.2...v3.0.0) - [github.com/psf/black: 22.8.0 → 22.10.0](https://github.com/psf/black/compare/22.8.0...22.10.0) - [github.com/pre-commit/mirrors-mypy: v0.981 → v0.982](https://github.com/pre-commit/mirrors-mypy/compare/v0.981...v0.982)	2022-10-10 20:30:10 +00:00
William Barnhart	08d5c4b408	Merge branch 'main' into extend-gitlab-qemu	2022-10-10 09:50:56 -04:00
Matthieu Darbois	758dfec593	chore: better error message when python is missing in an OCI image (#1298 )	2022-10-09 16:44:14 +02:00
Henry Schreiner	1ee0692f68	Revert "ci: avoid editable installs with old pip" This reverts commit `0fe600eea3`.	2022-10-08 15:58:04 -04:00
Henry Schreiner	0fe600eea3	ci: avoid editable installs with old pip	2022-10-08 15:53:46 -04:00
William Barnhart	309fc010b9	add cross building for pybind on gitlab to example	2022-10-07 11:20:11 -04:00
William Barnhart	89c04635b5	Merge branch 'main' into extend-gitlab-qemu	2022-10-07 10:45:21 -04:00
William Barnhart	768f964056	cleanup and add windows to .gitlab-ci.yml	2022-10-07 10:44:39 -04:00
Henry Schreiner	7c4bbf8cb3	chore: minor cleanups from reverb (#1293 ) Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com> Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>	2022-10-07 08:47:31 -04:00
Joe Rickerby	6086673d33	Fix badge URL	2022-10-07 12:16:57 +01:00
Joe Rickerby	ac403a6e88	Update azure image to 20.04 in example and our CI	2022-10-07 12:16:50 +01:00
Joe Rickerby	c940b2ee0c	Fix Gitlab support for bin/run_example_ci_config.py	2022-10-07 10:11:22 +01:00
Joe Rickerby	7a40973ed4	Specify python version Travis still defaults to 3.6, which is EOL!	2022-10-07 10:06:51 +01:00
Joe Rickerby	d4e4886f55	Update azure image	2022-10-07 10:06:21 +01:00
Joe Rickerby	3b75524632	Fix badge URLs	2022-10-07 10:04:37 +01:00
William Barnhart	d961fbd89a	remove submodule checkout	2022-10-07 00:48:01 -04:00
William Barnhart	dd4314f570	Update windows support on GitLab	2022-10-07 00:46:01 -04:00
William Barnhart	ee6b4fdf2d	Be more explicit about platform and arch	2022-10-06 18:59:01 -04:00
William Barnhart	543f077829	Update support for Linux ARM on GitLab	2022-10-06 14:09:30 -04:00
Joe Rickerby	c85450161c	Merge pull request #1283 from mayeut/test-macos-cp38-arm64 feature: allow testing cp38-macosx_arm64 wheel	2022-10-04 18:41:17 +01:00
Steve Dower	afdae3f47f	AppVeyor supports ARM64 builds	2022-10-04 16:41:34 +01:00
Steve Dower	91284650b3	Merge remote-tracking branch 'upstream/main' into arm64	2022-10-04 16:36:44 +01:00
Steve Dower	aa79b6eda9	Revert default archs on ARM64 change	2022-10-04 16:36:44 +01:00
Henry Schreiner	35f2b8db78	chore: clean up a little typing (#1291 )	2022-10-03 23:23:11 -04:00
pre-commit-ci[bot]andpre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>	e98c3eb3da	[pre-commit.ci] pre-commit autoupdate (#1292 ) updates: - [github.com/pre-commit/mirrors-mypy: v0.971 → v0.981](https://github.com/pre-commit/mirrors-mypy/compare/v0.971...v0.981) Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>	2022-10-03 20:34:56 -04:00
Steve Dower	ae58080d01	Merge remote-tracking branch 'upstream/main' into arm64	2022-10-04 00:38:23 +01:00
Steve Dower	18ced3c39b	Update docs and fix default architectures	2022-10-04 00:38:05 +01:00
cibuildwheel-bot[bot]andcibuildwheel-bot[bot] <83877280+cibuildwheel-bot[bot]@users.noreply.github.com>	3300709573	[Bot] Update dependencies (#1284 ) Update dependencies Co-authored-by: cibuildwheel-bot[bot] <83877280+cibuildwheel-bot[bot]@users.noreply.github.com>	2022-10-03 16:43:45 -04:00
Joe Rickerby	3545d1bc0d	Merge pull request #1290 from pypa/brew-docs-update	2022-10-03 08:39:45 +01:00
Joe Rickerby	bfcff06662	Tidy up the Tips and Tricks page and add information about Homebrew deps	2022-10-01 14:32:32 +01:00
Steve Dower	ea1d15b235	For mypy	2022-09-28 23:44:40 +01:00
pre-commit-ci[bot]	7a9bd57729	[pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci	2022-09-28 22:40:29 +00:00
Steve Dower	7fd4a2210a	Merge branch 'arm64' of https://github.com/zooba/cibuildwheel into arm64	2022-09-28 23:39:54 +01:00
Steve Dower	b8e47894b0	Add skip for missing ARM64 tools	2022-09-28 23:39:46 +01:00
Steve Dower	063b8e4d15	Merge branch 'main' into arm64	2022-09-28 16:02:06 +01:00
pre-commit-ci[bot]andpre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>	d98c07c26b	[pre-commit.ci] pre-commit autoupdate (#1286 ) updates: - [github.com/asottile/pyupgrade: v2.38.0 → v2.38.2](https://github.com/asottile/pyupgrade/compare/v2.38.0...v2.38.2) Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>	2022-09-27 22:20:12 +02:00
Steve Dower	4531370573	Rename variable to match one added to setuptools	2022-09-26 17:26:16 +01:00
Steve Dower	10a4e30a0b	Merge remote-tracking branch 'upstream/main' into arm64	2022-09-26 17:25:03 +01:00
pre-commit-ci[bot]	9ba7e7e6fb	[pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci	2022-09-25 10:41:01 +00:00
mayeut	6286d9c33d	feature: allow testing cp38-macosx_arm64 wheel Per discussion in https://github.com/pypa/cibuildwheel/pull/1169, the default installer used for cp38 is an Intel installer. It makes sense to skip testing arm64 wheels in this case. However, if the user choose to manually install the universal2 CPython version, then, tests shall be run on arm64. This allows users that either target 11.0+ on intel, universal2 or only build for arm64 to get the arm64 wheel tested on AppleSilicon.	2022-09-25 12:34:36 +02:00
Joe Rickerby	9d343cede3	Fix/improve changelog formatting in the docs	2022-09-25 10:08:38 +01:00
Steve Dower	9815b9c580	Merge remote-tracking branch 'upstream/main' into arm64	2022-09-09 11:51:13 +01:00
Steve Dower	5030c2c698	Remove unused names	2022-09-02 17:49:38 +01:00
Steve Dower	ff2d9de338	Flow through tmp directory	2022-09-01 22:15:57 +01:00
Steve Dower	1d7054c022	Switch to potential new distutils environment variable	2022-09-01 22:13:08 +01:00
Steve Dower	44ebbc4460	Remove unused import	2022-08-31 21:28:25 +01:00
Steve Dower	9dc55127ff	Fix typing	2022-08-31 21:24:47 +01:00
Steve Dower	4242fe9f13	Merge branch 'arm64' of https://github.com/zooba/cibuildwheel into arm64	2022-08-31 21:09:10 +01:00
Steve Dower	b94aceb682	Merge remote-tracking branch 'upstream/main' into arm64	2022-08-31 21:09:04 +01:00
pre-commit-ci[bot]	7b0ac9e107	[pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci	2022-08-31 20:08:59 +00:00
Steve Dower	f277099850	Skip ARM64 tests automatically with warning, and improved cleanup	2022-08-31 21:08:15 +01:00
Steve Dower	9a4e8f671f	Actually call unlink, and add more typing	2022-08-25 16:48:49 +01:00
Steve Dower	9e07dae579	Skip ARM64 test run when not running on ARM64	2022-08-25 00:30:38 +01:00
Steve Dower	dcc5c00a3d	Ensure cfg is removed, and add a message	2022-08-24 00:32:20 +01:00
pre-commit-ci[bot]	b8ac98ee9f	[pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci	2022-08-23 19:39:24 +00:00
Steve Dower	09e08f6342	Write to ~/pydistutils.cfg instead, preserving any existing file	2022-08-23 20:38:23 +01:00
Steve Dower	f5c82fc0ef	Merge branch 'main' into arm64	2022-08-23 17:27:00 +01:00
Steve Dower	634a3f733d	Expect correct wheel tag	2022-08-23 16:39:01 +01:00
Steve Dower	5f391d6a72	Merge branch 'main' into arm64	2022-08-22 23:25:40 +01:00
Steve Dower	15288bee96	Merge branch 'main' into arm64	2022-08-22 21:46:42 +01:00
Steve Dower	46cc2629e2	Merge branch 'main' into arm64	2022-08-15 17:11:37 +01:00
Steve Dower	c3dcb07fb6	Revert type names	2022-08-01 20:29:51 +01:00
pre-commit-ci[bot]	4c73245a7f	[pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci	2022-08-01 19:26:31 +00:00
Steve Dower	9405d827b1	Merge branch 'arm64' of https://github.com/zooba/cibuildwheel into arm64	2022-08-01 20:23:57 +01:00
Steve Dower	94a053e024	Apply some PR feedback	2022-08-01 20:23:30 +01:00
pre-commit-ci[bot]	a2386a2d80	[pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci	2022-08-01 19:12:17 +00:00
Steve Dower	59febc16d1	Add setup_rust_cross_compile	2022-08-01 20:11:47 +01:00
Steve Dower	71df33df55	Merge remote-tracking branch 'upstream/main' into arm64	2022-08-01 19:54:50 +01:00
Joe Rickerby	b5b8e128d0	Add a pyproject.toml to the windows arm64 cross compile test	2022-07-04 15:29:30 +01:00
Steve Dower	36442d5caa	Merge branch 'arm64' of https://github.com/zooba/cibuildwheel into arm64	2022-06-17 17:12:59 +01:00
Steve Dower	222d56bb5a	Allow more arch values in get_nuget_args	2022-06-17 17:11:09 +01:00
pre-commit-ci[bot]	07041908e2	[pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci	2022-06-17 16:07:47 +00:00
Steve Dower	dc14bd126e	Add cross-compiler test	2022-06-17 17:07:11 +01:00
Steve Dower	e18c21aec6	Merge branch 'arm64' of https://github.com/zooba/cibuildwheel into arm64	2022-06-17 16:44:34 +01:00
Steve Dower	6bcca2d7ca	Satisfy MyPy	2022-06-17 16:44:17 +01:00
pre-commit-ci[bot]	310cfda8b5	[pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci	2022-06-17 15:42:07 +00:00
Steve Dower	ea559af808	Enable building for Windows ARM64 on a non-ARM64 device	2022-06-17 16:39:56 +01:00