Bump version: v2.10.2

Merge pull request #1258 from henryiii/henryiii/chore/dev
chore: nicer tracebacks and dev improvements
2022-09-25 09:48:12 +01:00 · 2022-09-25 09:34:05 +01:00 · 2022-09-25 09:31:25 +01:00 · 2022-09-25 08:33:28 +01:00 · 2022-09-25 08:32:16 +01:00 · 2022-09-24 23:12:32 +01:00
81 changed files with 1577 additions and 396 deletions
@@ -0,0 +1,58 @@
+run_tests: &RUN_TESTS
+  install_cibuildwheel_script:
+    - python -m pip install -e ".[dev]" pytest-custom-exit-code
+  run_cibuildwheel_tests_script:
+    - python ./bin/run_tests.py
+
+
+linux_x86_task:
+  timeout_in: 120m
+  compute_engine_instance:
+    image_project: cirrus-images
+    image: family/docker-builder
+    platform: linux
+    cpu: 8
+    memory: 8G
+
+  install_pre_requirements_script:
+    - apt install -y python3-venv python-is-python3
+  <<: *RUN_TESTS
+
+linux_aarch64_task:
+  compute_engine_instance:
+    image_project: cirrus-images
+    image: family/docker-builder-arm64
+    architecture: arm64
+    platform: linux
+    cpu: 4
+    memory: 4G
+
+  install_pre_requirements_script:
+    - apt install -y python3-venv python-is-python3
+  <<: *RUN_TESTS
+
+windows_x86_task:
+  # The task takes ~55 minutes while the timeout happens
+  # after 60 minutes by default, let's allow some wiggle room.
+  timeout_in: 120m
+  windows_container:
+    image: cirrusci/windowsservercore:visualstudio2022
+    cpu: 8
+    memory: 8G
+
+  install_pre_requirements_script:
+    - choco install -y --no-progress python3 --version 3.10.6
+    - refreshenv
+    - echo PATH=%PATH% >> "%CIRRUS_ENV%"
+  <<: *RUN_TESTS
+
+macos_arm64_task:
+  macos_instance:
+    image: ghcr.io/cirruslabs/macos-monterey-xcode
+
+  env:
+    PATH: /opt/homebrew/opt/python@3.10/bin:$PATH
+  install_pre_requirements_script:
+    - brew install python@3.10
+    - ln -s python3 /opt/homebrew/opt/python@3.10/bin/python
+  <<: *RUN_TESTS
@@ -14,7 +14,7 @@ repos:
  - id: trailing-whitespace

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

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

@@ -84,7 +84,7 @@ repos:
  rev: 5.0.4
  hooks:
  - id: flake8
-    exclude: cibuildwheel/resources/
+    exclude: ^cibuildwheel/resources/
    additional_dependencies: *flake8-dependencies

 - repo: https://github.com/pre-commit/pygrep-hooks
@@ -109,6 +109,7 @@ repos:
    entry: PyBind|Numpy|Cmake|Github|PyTest
    types:
    - markdown
+    exclude: ^docs/working-examples\.md$  # Autogenerated
  - id: update-readme-changelog
    name: Update README changelog
    language: python
@@ -116,7 +117,8 @@ repos:
    files: ^docs/changelog.md$

 - repo: https://github.com/codespell-project/codespell
-  rev: v2.1.0
+  rev: v2.2.1
  hooks:
  - id: codespell
    args: ["-L", "sur"]
+    exclude: ^docs/working-examples\.md$  # Autogenerated
@@ -1,10 +1,10 @@
 This is a summary of the Python versions and platforms covered by the different CI platforms:

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

 > ¹ AppVeyor only runs the "basic" test to reduce load.

@@ -8,6 +8,7 @@ cibuildwheel
 [![Appveyor status](https://ci.appveyor.com/api/projects/status/gt3vwl88yt0y3hur/branch/main?svg=true)](https://ci.appveyor.com/project/joerick/cibuildwheel/branch/main)
 [![CircleCI Status](https://img.shields.io/circleci/build/gh/pypa/cibuildwheel/main?logo=circleci)](https://circleci.com/gh/pypa/cibuildwheel)
 [![Azure Status](https://dev.azure.com/joerick0429/cibuildwheel/_apis/build/status/pypa.cibuildwheel?branchName=main)](https://dev.azure.com/joerick0429/cibuildwheel/_build/latest?definitionId=4&branchName=main)
+[![Cirrus CI Status](https://img.shields.io/cirrus/github/pypa/cibuildwheel/main?logo=cirrusci)](https://cirrus-ci.com/github/pypa/cibuildwheel)


 [Documentation](https://cibuildwheel.readthedocs.org)
@@ -39,7 +40,7 @@ What does it do?
 <sup>³ Alpine 3.14 and very briefly 3.15's default python3 [was not able to load](https://github.com/pypa/cibuildwheel/issues/934) musllinux wheels. This has been fixed; please upgrade the python package if using Alpine from before the fix.</sup><br>

 - Builds manylinux, musllinux, macOS 10.9+, and Windows wheels for CPython and PyPy
- Works on GitHub Actions, Azure Pipelines, Travis CI, AppVeyor, CircleCI, and GitLab CI
+- Works on GitHub Actions, Azure Pipelines, Travis CI, AppVeyor, CircleCI, GitLab CI, and Cirrus CI
 - Bundles shared library dependencies on Linux and macOS through [auditwheel](https://github.com/pypa/auditwheel) and [delocate](https://github.com/matthew-brett/delocate)
 - Runs your library's tests against the wheel-installed version of your library

@@ -50,16 +51,19 @@ Usage

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

-|                 | Linux | macOS | Windows | Linux ARM |
-|-----------------|-------|-------|---------|--------------|
-| GitHub Actions  | ✅    | ✅    | ✅      | ✅¹          |
-| Azure Pipelines | ✅    | ✅    | ✅      |              |
-| Travis CI       | ✅    |       | ✅      | ✅           |
-| AppVeyor        | ✅    | ✅    | ✅      |              |
-| CircleCI        | ✅    | ✅    |         |              |
-| Gitlab CI       | ✅    |       |         |              |
+|                 | Linux | macOS | Windows | Linux ARM | macOS 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>

 <!--intro-end-->

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

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

      - name: Build wheels
        run: python -m cibuildwheel --output-dir wheelhouse
@@ -179,6 +183,7 @@ Here are some repos that use cibuildwheel.
 [circleci icon]: docs/data/readme_icons/circleci.svg
 [gitlab icon]: docs/data/readme_icons/gitlab.svg
 [travisci icon]: docs/data/readme_icons/travisci.svg
+[cirrusci icon]: docs/data/readme_icons/cirrusci.svg
 [windows icon]: docs/data/readme_icons/windows.svg
 [apple icon]: docs/data/readme_icons/apple.svg
 [linux icon]: docs/data/readme_icons/linux.svg
@@ -203,6 +208,32 @@ Changelog

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

+### v2.10.2
+
+_25 September 2022_
+
+- 🐛 Fix a bug that caused `win32` identifiers to fail when used with `--only`. (#1282)
+- 🐛 Fix computation of `auto`/`auto64`/`auto32` archs when targeting a different platform to the one that you're running cibuildwheel on. (#1266)
+- 📚 Fix an mistake in the 'how it works' diagram. (#1274)
+
+### v2.10.1
+
+_18 September 2022_
+
+- 🐛 Fix a bug that stopped environment variables specified in TOML from being expanded. (#1273)
+
+### v2.10.0
+
+_13 September 2022_
+
+- 🌟 Adds support for [building wheels on Cirrus CI](https://cibuildwheel.readthedocs.io/en/stable/setup/#cirrus-ci). This is exciting for us, as it's the first public CI platform that natively supports macOS Apple Silicon (aka. M1, `arm64`) runners. As such, it's the first platform that you can natively build _and test_ macOS `arm64` wheels. It also has native Linux ARM (aarch64) runners, for fast, native builds there. (#1191)
+- 🌟 Adds support for running cibuildwheel on Apple Silicon machines. For a while, we've supported cross-compilation of Apple Silicon wheels on `x86_64`, but now that we have Cirrus CI we can run our test suite and officially support running cibuildwheel on `arm64`. (#1191)
+- ✨ Adds the `--only` [command line option](https://cibuildwheel.readthedocs.io/en/stable/options/#command-line), to specify a single build to run. Previously, it could be cumbersome to set all the build selection options to target a specific build - for example, you might have to run something like `CIBW_BUILD=cp39-manylinux_x86_64 cibuildwheel --platform linux --archs x86_64`. The new `--only` option overrides all the build selection options to simplify running a single build, which now looks like `cibuildwheel --only cp39-manylinux_x86_64`. (#1098)
+- ✨ Adds the [`CIBW_CONFIG_SETTINGS`](https://cibuildwheel.readthedocs.io/en/stable/options/#config-settings) option, so you can pass arguments to your package's build backend (#1244)
+- 🛠 Updates the CPython 3.11 version to the latest release candidate - v3.11.0rc2. (#1265)
+- 🐛 Fix a bug that can cause a RecursionError on Windows when building from an sdist. (#1253)
+- 🛠 Add support for the s390x architecture on manylinux_2_28 (#1255)
+
 ### v2.9.0

 _11 August 2022_
@@ -221,34 +252,6 @@ _18 July 2022_
 - 🛠 The GitHub Action will ensure a compatible version of Python is installed on the runner (#1114)
 - 📚 A few docs improvements

-### v2.8.0
-
-_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.
-
-  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.
-
-### v2.7.0
-
-_17 June 2022_
-
- 🌟 Added support for the new `manylinux_2_28` images. These new images are based on AlmaLinux, the community-driven successor to CentOS, unlike manylinux_2_24, which was based on Debian. To build on these images, set your [`CIBW_MANYLINUX_*_IMAGE`](https://cibuildwheel.readthedocs.io/en/stable/options/#linux-image) option to `manylinux_2_28`. (#1026)
- 🐛 Fix a bug where tests were not being run on CPython 3.11 (when CIBW_PRERELEASE_PYTHONS was set) (#1138)
- ✨ You can now build Linux wheels on Windows, as long as you have Docker installed and set to 'Linux containers' (#1117)
- 🐛 Fix a bug on macOS that caused cibuildwheel to crash trying to overwrite a previously-built wheel of the same name. (#1129)
-
-### v2.6.1
-
-_7 June 2022_
-
- 🛠 Update the prerelease CPython 3.11 to 3.11.0b3
-
 <!-- END bin/update_readme_changelog.py -->

 ---
@@ -273,6 +276,7 @@ Maintainers
 - Yannick Jadoul [@YannickJadoul](https://github.com/YannickJadoul)
 - Matthieu Darbois [@mayeut](https://github.com/mayeut)
 - Henry Schreiner [@henryiii](https://github.com/henryiii)
+- Grzegorz Bokota [@Czaki](https://github.com/Czaki)

 Credits
 -------
@@ -13,6 +13,10 @@ inputs:
    description: 'File containing the config, defaults to {package}/pyproject.toml'
    required: false
    default: ''
+  only:
+    description: 'Build a specific wheel only. No need for arch/platform if this is set'
+    required: false
+    default: ''
 branding:
  icon: package
  color: yellow
@@ -36,5 +40,6 @@ runs:
        ${{ inputs.package-dir }}
        --output-dir ${{ inputs.output-dir }}
        --config-file "${{ inputs.config-file }}"
+        --only "${{ inputs.only }}"
        2>&1
      shell: bash
@@ -1,4 +1,17 @@
 #!/usr/bin/env python3
+
+"""
+Check known projects for usage of requires-python.
+
+Usage:
+
+    ./bin/inspect_all_known_projects.py --online=$GITHUB_TOKEN
+
+This will cache the results to all_known_setup.yaml; you can reprint
+the results without the `--online` setting.
+"""
+
+
 from __future__ import annotations

 import ast
@@ -7,7 +20,7 @@ from typing import Iterator

 import click
 import yaml
-from ghapi.core import GhApi, HTTP404NotFoundError
+from github import Github, GithubException
 from rich import print

 from cibuildwheel.projectfiles import Analyzer
@@ -47,33 +60,38 @@ def check_repo(name: str, contents: str) -> str:


 class MaybeRemote:
-    def __init__(self, cached_file: Path | str, *, online: bool) -> None:
-        self.online = online
-        if self.online:
-            self.contents: dict[str, dict[str, str | None]] = {
+    github: Github | None
+    contents: dict[str, dict[str, str | None]]
+
+    def __init__(self, cached_file: Path | str, *, online: str | None) -> None:
+        if online is not None:
+            self.github = Github(online)
+            self.contents = {
                "setup.py": {},
                "setup.cfg": {},
                "pyproject.toml": {},
            }
        else:
+            self.github = None
            with open(cached_file) as f:
                self.contents = yaml.safe_load(f)

    def get(self, repo: str, filename: str) -> str | None:
-        if self.online:
+        if self.github:
            try:
-                self.contents[filename][repo] = (
-                    GhApi(*repo.split("/")).get_content(filename).decode()
-                )
-            except HTTP404NotFoundError:
+                gh_file = self.github.get_repo(repo).get_contents(filename)
+            except GithubException:
                self.contents[filename][repo] = None
+            else:
+                assert not isinstance(gh_file, list)
+                self.contents[filename][repo] = gh_file.decoded_content.decode(encoding="utf-8")
+
            return self.contents[filename][repo]
        elif repo in self.contents[filename]:
            return self.contents[filename][repo]
        else:
-            raise RuntimeError(
-                f"Trying to access {repo}:{filename} and not in cache, rebuild cache"
-            )
+            msg = f"Trying to access {repo}:{filename} and not in cache, rebuild cache"
+            raise RuntimeError(msg)

    def save(self, filename: Path | str) -> None:
        with open(filename, "w") as f:
@@ -87,8 +105,8 @@ class MaybeRemote:


@click.command()
-@click.option("--online", is_flag=True, help="Remember to set GITHUB_TOKEN")
-def main(online: bool) -> None:
+@click.option("--online", help="Set to $GITHUB_TOKEN")
+def main(online: str | None) -> None:
    with open(DIR / "../docs/data/projects.yml") as f:
        known = yaml.safe_load(f)

@@ -32,6 +32,7 @@ ICONS = (
    "circleci",
    "gitlab",
    "travisci",
+    "cirrusci",
    "windows",
    "apple",
    "linux",
@@ -66,6 +66,11 @@ services = [
        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})",
    ),
+    CIService(
+        name="cirrus-ci",
+        dst_config_path=".cirrus.yml",
+        badge_md="[![Cirrus CI](https://api.cirrus-ci.com/github/pypa/cibuildwheel.svg?branch={branch})](https://cirrus-ci.com/github/pypa/cibuildwheel/{branch})",
+    ),
 ]


@@ -76,7 +81,8 @@ def ci_service_for_config_file(config_file):
        if service.name == service_name:
            return service

-    raise ValueError(f"unknown ci service for config file {config_file}")
+    msg = f"unknown ci service for config file {config_file}"
+    raise ValueError(msg)


@click.command()
@@ -95,7 +101,8 @@ def run_example_ci_configs(config_files=None):
    for config_file in config_files:
        service = ci_service_for_config_file(config_file)
        if service.name in configs_by_service:
-            raise Exception("You cannot specify more than one config per CI service")
+            msg = "You cannot specify more than one config per CI service"
+            raise Exception(msg)
        configs_by_service[service.name] = config_file

    if git_repo_has_changes():
@@ -50,6 +50,7 @@ images = [
    Image("manylinux_2_28", "x86_64", "quay.io/pypa/manylinux_2_28_x86_64", None),
    Image("manylinux_2_28", "aarch64", "quay.io/pypa/manylinux_2_28_aarch64", None),
    Image("manylinux_2_28", "ppc64le", "quay.io/pypa/manylinux_2_28_ppc64le", None),
+    Image("manylinux_2_28", "s390x", "quay.io/pypa/manylinux_2_28_s390x", None),
    Image("manylinux_2_28", "pypy_x86_64", "quay.io/pypa/manylinux_2_28_x86_64", None),
    Image("manylinux_2_28", "pypy_aarch64", "quay.io/pypa/manylinux_2_28_aarch64", None),
    # musllinux_1_1 images
@@ -0,0 +1,52 @@
+#!/usr/bin/env python3
+
+from __future__ import annotations
+
+import subprocess
+import sys
+from pathlib import Path
+
+try:
+    from html2image import Html2Image  # type: ignore[import]
+except ImportError:
+    sys.exit(
+        """
+        html2image not found. Ensure you have Chrome (on Mac/Windows) or
+        Chromium (on Linux) installed, and then do:
+            pip install html2image
+        """
+    )
+
+
+def main():
+    subprocess.run(["mkdocs", "build"])
+
+    hti = Html2Image(custom_flags=["--force-device-scale-factor=2"])
+
+    html_str = Path("docs/diagram.md").read_text()
+    css_tags = f"""
+        <style>{Path("site/css/theme.css").read_text()}</style>
+        <style>{Path("site/css/theme_extra.css").read_text()}</style>
+        <style>{Path("site/extra.css").read_text()}</style>
+        <style>
+            body {{
+                background: white;
+            }}
+        </style>
+    """
+    html_str = css_tags + html_str
+
+    [screenshot, *_] = hti.screenshot(
+        html_str=html_str,
+        size=(830, 405),
+    )
+
+    dest_path = Path("docs/data/how-it-works.png")
+    if dest_path.exists():
+        dest_path.unlink()
+
+    Path(screenshot).rename(dest_path)
+
+
+if __name__ == "__main__":
+    main()
@@ -141,7 +141,8 @@ class PyPyVersions:
        releases = [r for r in releases if self.get_arch_file(r)]

        if not releases:
-            raise RuntimeError(f"PyPy Win {self.arch} not found for {spec}! {self.releases}")
+            msg = f"PyPy Win {self.arch} not found for {spec}! {self.releases}"
+            raise RuntimeError(msg)

        version_arch = "win32" if self.arch == "32" else "win_amd64"

@@ -159,13 +160,15 @@ class PyPyVersions:

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

        releases = [r for r in self.releases if spec.contains(r["python_version"])]
        releases = sorted(releases, key=lambda r: r["pypy_version"])  # type: ignore[no-any-return]

        if not releases:
-            raise RuntimeError(f"PyPy macOS {self.arch} not found for {spec}!")
+            msg = f"PyPy macOS {self.arch} not found for {spec}!"
+            raise RuntimeError(msg)

        release = releases[-1]
        version = release["python_version"]
@@ -1,3 +1,3 @@
 from __future__ import annotations

-__version__ = "2.9.0"
+__version__ = "2.10.2"
@@ -5,8 +5,8 @@ import os
 import shutil
 import sys
 import tarfile
-import tempfile
 import textwrap
+import typing
 from pathlib import Path
 from tempfile import mkdtemp

@@ -41,7 +41,7 @@ def main() -> None:
    parser.add_argument(
        "--platform",
        choices=["auto", "linux", "macos", "windows"],
-        default=os.environ.get("CIBW_PLATFORM", "auto"),
+        default=None,
        help="""
            Platform to build for. Use this option to override the
            auto-detected platform or to run cibuildwheel on your development
@@ -65,6 +65,16 @@ def main() -> None:
        """,
    )

+    parser.add_argument(
+        "--only",
+        default=None,
+        help="""
+            Force a single wheel build when given an identifier. Overrides
+            CIBW_BUILD/CIBW_SKIP. --platform and --arch cannot be specified
+            if this is given.
+        """,
+    )
+
    parser.add_argument(
        "--output-dir",
        type=Path,
@@ -130,8 +140,8 @@ def main() -> None:
        return

    # Tarfile builds require extraction and changing the directory
-    with tempfile.TemporaryDirectory(prefix="cibw-sdist-") as temp_dir_str:
-        temp_dir = Path(temp_dir_str)
+    temp_dir = Path(mkdtemp(prefix="cibw-sdist-")).resolve(strict=True)
+    try:
        with tarfile.open(args.package_dir) as tar:
            tar.extractall(path=temp_dir)

@@ -139,20 +149,57 @@ def main() -> None:
        try:
            (project_dir,) = temp_dir.iterdir()
        except ValueError:
-            raise SystemExit("invalid sdist: didn't contain a single dir") from None
+            msg = "invalid sdist: didn't contain a single dir"
+            raise SystemExit(msg) from None

        # This is now the new package dir
        args.package_dir = project_dir.resolve()

        with chdir(temp_dir):
            build_in_directory(args)
+    finally:
+        # avoid https://github.com/python/cpython/issues/86962 by performing
+        # 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)}'")


 def build_in_directory(args: CommandLineArguments) -> None:
+    platform_option_value = args.platform or os.environ.get("CIBW_PLATFORM", "auto")
    platform: PlatformName

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

-    if platform not in PLATFORMS:
-        print(f"cibuildwheel: Unsupported platform: {platform}", file=sys.stderr)
-        sys.exit(2)
-
    options = compute_options(platform=platform, command_line_arguments=args)

    package_dir = options.globals.package_dir
@@ -253,6 +296,8 @@ def build_in_directory(args: CommandLineArguments) -> None:
            else:
                assert_never(platform)
    finally:
+        # avoid https://github.com/python/cpython/issues/86962 by performing
+        # 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)}'")
@@ -3,12 +3,19 @@ from __future__ import annotations
 import functools
 import platform as platform_module
 import re
+import sys
 from enum import Enum

 from .typing import Final, Literal, PlatformName, assert_never

 PRETTY_NAMES: Final = {"linux": "Linux", "macos": "macOS", "windows": "Windows"}

+ARCH_SYNONYMS: Final[list[dict[PlatformName, str | None]]] = [
+    {"linux": "x86_64", "macos": "x86_64", "windows": "AMD64"},
+    {"linux": "i686", "macos": None, "windows": "x86"},
+    {"linux": "aarch64", "macos": "arm64", "windows": "ARM64"},
+]
+

@functools.total_ordering
 class Architecture(Enum):
@@ -56,14 +63,37 @@ class Architecture(Enum):

    @staticmethod
    def auto_archs(platform: PlatformName) -> set[Architecture]:
-        native_architecture = Architecture(platform_module.machine())
+        native_machine = platform_module.machine()
+
+        # Cross-platform support. Used for --print-build-identifiers or docker builds.
+        host_platform: PlatformName = (
+            "windows"
+            if sys.platform.startswith("win")
+            else ("macos" if sys.platform.startswith("darwin") else "linux")
+        )
+
+        native_architecture = Architecture(native_machine)
+
+        # we might need to rename the native arch to the machine we're running
+        # on, as the same arch can have different names on different platforms
+        if host_platform != platform:
+            for arch_synonym in ARCH_SYNONYMS:
+                if native_machine == arch_synonym.get(host_platform):
+                    synonym = arch_synonym[platform]
+
+                    if synonym is None:
+                        # can't build anything on this platform
+                        return set()
+
+                    native_architecture = Architecture(synonym)
+
        result = {native_architecture}

-        if platform == "linux" and native_architecture == Architecture.x86_64:
+        if platform == "linux" and Architecture.x86_64 in result:
            # x86_64 machines can run i686 containers
            result.add(Architecture.i686)

-        if platform == "windows" and native_architecture == Architecture.AMD64:
+        if platform == "windows" and Architecture.AMD64 in result:
            result.add(Architecture.x86)

        return result
@@ -32,7 +32,8 @@ def evaluate(
    command_node = bashlex.parsesingle(value)

    if len(command_node.parts) != 1:
-        raise ValueError(f'"{value}" has too many parts')
+        msg = f"{value!r} has too many parts"
+        raise ValueError(msg)

    value_word_node = command_node.parts[0]

@@ -54,7 +55,8 @@ def evaluate_node(node: bashlex.ast.node, context: NodeExecutionContext) -> str:
    elif node.kind == "parameter":
        return evaluate_parameter_node(node, context=context)
    else:
-        raise ValueError(f'Unsupported bash construct: "{node.kind}"')
+        msg = f"Unsupported bash construct: {node.kind!r}"
+        raise ValueError(msg)


 def evaluate_word_node(node: bashlex.ast.node, context: NodeExecutionContext) -> str:
@@ -65,10 +67,8 @@ def evaluate_word_node(node: bashlex.ast.node, context: NodeExecutionContext) ->
        part_value = evaluate_node(part, context=context)

        if part_string not in value:
-            raise RuntimeError(
-                f'bash parse failed. part "{part_string}" not found in "{value}". '
-                f'Word was "{node.word}". Full input was "{context.input}"'
-            )
+            msg = f"bash parse failed. part {part_string!r} not found in {value!r}. Word was {node.word!r}. Full input was {context.input!r}"
+            raise RuntimeError(msg)

        value = value.replace(part_string, part_value, 1)

@@ -95,9 +95,11 @@ def evaluate_nodes_as_compound_command(
            result += evaluate_command_node(node, context=context)
        elif node.kind == "operator":
            if node.op != ";":
-                raise ValueError(f'Unsupported bash operator: "{node.op}"')
+                msg = f"Unsupported bash operator: {node.op!r}"
+                raise ValueError(msg)
        else:
-            raise ValueError(f'Unsupported bash node in compound command: "{node.kind}"')
+            msg = f"Unsupported bash node in compound command: {node.kind!r}"
+            raise ValueError(msg)

    return result

@@ -4,6 +4,7 @@ import dataclasses
 from typing import Any, Mapping, Sequence

 import bashlex
+import bashlex.errors

 from cibuildwheel.typing import Protocol

@@ -33,7 +34,11 @@ def split_env_items(env_string: str) -> list[str]:
    if not env_string:
        return []

-    command_node = bashlex.parsesingle(env_string)
+    try:
+        command_node = bashlex.parsesingle(env_string)
+    except bashlex.errors.ParsingError as e:
+        raise EnvironmentParseError(env_string) from e
+
    result = []

    for word_node in command_node.parts:
@@ -21,10 +21,8 @@ class cached_property(Generic[_T]):
        if self.attrname is None:
            self.attrname = name
        elif name != self.attrname:
-            raise TypeError(
-                "Cannot assign the same cached_property to two different names "
-                f"({self.attrname!r} and {name!r})."
-            )
+            msg = f"Cannot assign the same cached_property to two different names ({self.attrname!r} and {name!r})."
+            raise TypeError(msg)

    @overload
    def __get__(self, instance: None, owner: type[Any] | None = ...) -> cached_property[_T]:
@@ -38,9 +36,8 @@ class cached_property(Generic[_T]):
        if instance is None:
            return self
        if self.attrname is None:
-            raise TypeError(
-                "Cannot use cached_property instance without calling __set_name__ on it."
-            )
+            msg = "Cannot use cached_property instance without calling __set_name__ on it."
+            raise TypeError(msg)
        try:
            cache = instance.__dict__
        except AttributeError:  # not all objects have __dict__ (e.g. class defines slots)
@@ -20,6 +20,7 @@ from .util import (
    get_build_verbosity_extra_flags,
    prepare_command,
    read_python_configs,
+    split_config_settings,
    unwrap,
 )

@@ -212,8 +213,10 @@ def build_in_container(
            container.call(["mkdir", "-p", built_wheel_dir])

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

            if build_options.build_frontend == "pip":
+                extra_flags += verbosity_flags
                container.call(
                    [
                        "python",
@@ -223,12 +226,13 @@ def build_in_container(
                        container_package_dir,
                        f"--wheel-dir={built_wheel_dir}",
                        "--no-deps",
-                        *verbosity_flags,
+                        *extra_flags,
                    ],
                    env=env,
                )
            elif build_options.build_frontend == "build":
-                config_setting = " ".join(verbosity_flags)
+                verbosity_setting = " ".join(verbosity_flags)
+                extra_flags += (f"--config-setting={verbosity_setting}",)
                container.call(
                    [
                        "python",
@@ -237,7 +241,7 @@ def build_in_container(
                        container_package_dir,
                        "--wheel",
                        f"--outdir={built_wheel_dir}",
-                        f"--config-setting={config_setting}",
+                        *extra_flags,
                    ],
                    env=env,
                )
@@ -349,6 +353,7 @@ def build(options: Options, tmp_path: Path) -> None:  # pylint: disable=unused-a
                If you're building on Travis CI, add `services: [docker]` to
                your .travis.yml. If you're building on Circle CI in Linux,
                add a `setup_remote_docker` step to your .circleci/config.yml.
+                If you're building on Cirrus CI, use `docker_builder` task.
                """
            ),
            file=sys.stderr,
@@ -362,7 +367,8 @@ def build(options: Options, tmp_path: Path) -> None:  # pylint: disable=unused-a
    cwd = Path.cwd()
    abs_package_dir = options.globals.package_dir.resolve()
    if cwd != abs_package_dir and cwd not in abs_package_dir.parents:
-        raise Exception("package_dir must be inside the working directory")
+        msg = "package_dir must be inside the working directory"
+        raise Exception(msg)

    container_project_path = PurePosixPath("/project")
    container_package_dir = container_project_path / abs_package_dir.relative_to(cwd)
@@ -197,14 +197,16 @@ def build_description_from_identifier(identifier: str) -> str:
    elif python_interpreter == "pp":
        build_description += "PyPy"
    else:
-        raise Exception("unknown python")
+        msg = f"unknown python {python_interpreter!r}"
+        raise Exception(msg)

    build_description += f" {python_version[0]}.{python_version[1:]} "

    try:
        build_description += PLATFORM_IDENTIFIER_DESCRIPTIONS[platform_identifier]
    except KeyError as e:
-        raise Exception("unknown platform") from e
+        msg = f"unknown platform {platform_identifier!r}"
+        raise Exception(msg) from e

    return build_description

@@ -34,6 +34,7 @@ from .util import (
    prepare_command,
    read_python_configs,
    shell,
+    split_config_settings,
    unwrap,
    virtualenv,
 )
@@ -145,7 +146,8 @@ def setup_python(
    elif implementation_id.startswith("pp"):
        base_python = install_pypy(tmp, python_configuration.url)
    else:
-        raise ValueError("Unknown Python implementation")
+        msg = "Unknown Python implementation"
+        raise ValueError(msg)
    assert base_python.exists()

    log.step("Setting up build environment...")
@@ -345,8 +347,10 @@ def build(options: Options, tmp_path: Path) -> None:
                built_wheel_dir.mkdir()

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

                if build_options.build_frontend == "pip":
+                    extra_flags += verbosity_flags
                    # Path.resolve() is needed. Without it pip wheel may try to fetch package from pypi.org
                    # see https://github.com/pypa/cibuildwheel/pull/369
                    call(
@@ -357,11 +361,12 @@ def build(options: Options, tmp_path: Path) -> None:
                        build_options.package_dir.resolve(),
                        f"--wheel-dir={built_wheel_dir}",
                        "--no-deps",
-                        *verbosity_flags,
+                        *extra_flags,
                        env=env,
                    )
                elif build_options.build_frontend == "build":
-                    config_setting = " ".join(verbosity_flags)
+                    verbosity_setting = " ".join(verbosity_flags)
+                    extra_flags += (f"--config-setting={verbosity_setting}",)
                    build_env = env.copy()
                    if build_options.dependency_constraints:
                        constraint_path = (
@@ -378,7 +383,7 @@ def build(options: Options, tmp_path: Path) -> None:
                        build_options.package_dir,
                        "--wheel",
                        f"--outdir={built_wheel_dir}",
-                        f"--config-setting={config_setting}",
+                        *extra_flags,
                        env=build_env,
                    )
                else:
@@ -462,7 +467,8 @@ def build(options: Options, tmp_path: Path) -> None:
                                )
                            )
                        else:
-                            raise RuntimeError("unreachable")
+                            msg = "unreachable"
+                            raise RuntimeError(msg)

                        # skip this test
                        continue
@@ -58,7 +58,8 @@ class OCIContainer:
        engine: ContainerEngine = "docker",
    ):
        if not image:
-            raise ValueError("Must have a non-empty image to run.")
+            msg = "Must have a non-empty image to run."
+            raise ValueError(msg)

        self.image = image
        self.simulate_32_bit = simulate_32_bit
@@ -3,13 +3,14 @@ from __future__ import annotations
 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, Dict, Generator, List, Mapping, Union, cast
+from typing import Any, Callable, Dict, Generator, Iterator, List, Mapping, Union, cast

 if sys.version_info >= (3, 11):
    import tomllib
@@ -22,7 +23,7 @@ from .architecture import Architecture
 from .environment import EnvironmentParseError, ParsedEnvironment, parse_environment
 from .oci_container import ContainerEngine
 from .projectfiles import get_requires_python_str
-from .typing import PLATFORMS, Literal, PlatformName, TypedDict
+from .typing import PLATFORMS, Literal, NotRequired, PlatformName, TypedDict
 from .util import (
    MANYLINUX_ARCHS,
    MUSLLINUX_ARCHS,
@@ -41,9 +42,10 @@ from .util import (

@dataclass
 class CommandLineArguments:
-    platform: Literal["auto", "linux", "macos", "windows"]
+    platform: Literal["auto", "linux", "macos", "windows"] | None
    archs: str | None
    output_dir: Path
+    only: str | None
    config_file: str
    package_dir: Path
    print_build_identifiers: bool
@@ -77,6 +79,7 @@ class BuildOptions:
    test_extras: str
    build_verbosity: int
    build_frontend: BuildFrontend
+    config_settings: str

    @property
    def package_dir(self) -> Path:
@@ -120,6 +123,7 @@ DISALLOWED_OPTIONS = {
 class TableFmt(TypedDict):
    item: str
    sep: str
+    quote: NotRequired[Callable[[str], str]]


 class ConfigOptionError(KeyError):
@@ -134,7 +138,8 @@ def _dig_first(*pairs: tuple[Mapping[str, Setting], str], ignore_empty: bool = F
    _dig_first((dict1, "key1"), (dict2, "key2"), ...)
    """
    if not pairs:
-        raise ValueError("pairs cannot be empty")
+        msg = "pairs cannot be empty"
+        raise ValueError(msg)

    for dict_like, key in pairs:
        if key in dict_like:
@@ -204,13 +209,15 @@ class OptionsReader:

        if config_overrides is not None:
            if not isinstance(config_overrides, list):
-                raise ConfigOptionError("'tool.cibuildwheel.overrides' must be a list")
+                msg = "'tool.cibuildwheel.overrides' must be a list"
+                raise ConfigOptionError(msg)

            for config_override in config_overrides:
                select = config_override.pop("select", None)

                if not select:
-                    raise ConfigOptionError("'select' must be set in an override")
+                    msg = "'select' must be set in an override"
+                    raise ConfigOptionError(msg)

                if isinstance(select, list):
                    select = " ".join(select)
@@ -293,8 +300,9 @@ class OptionsReader:
        accept platform versions of the environment variable. If this is an
        array it will be merged with "sep" before returning. If it is a table,
        it will be formatted with "table['item']" using {k} and {v} and merged
-        with "table['sep']". Empty variables will not override if ignore_empty
-        is True.
+        with "table['sep']". If sep is also given, it will be used for arrays
+        inside the table (must match table['sep']). Empty variables will not
+        override if ignore_empty is True.
        """

        if name not in self.default_options and name not in self.default_platform_options:
@@ -323,12 +331,16 @@ class OptionsReader:

        if isinstance(result, dict):
            if table is None:
-                raise ConfigOptionError(f"{name!r} does not accept a table")
-            return table["sep"].join(table["item"].format(k=k, v=v) for k, v in result.items())
+                msg = f"{name!r} does not accept a table"
+                raise ConfigOptionError(msg)
+            return table["sep"].join(
+                item for k, v in result.items() for item in _inner_fmt(k, v, table)
+            )

        if isinstance(result, list):
            if sep is None:
-                raise ConfigOptionError(f"{name!r} does not accept a list")
+                msg = f"{name!r} does not accept a list"
+                raise ConfigOptionError(msg)
            return sep.join(result)

        if isinstance(result, int):
@@ -337,6 +349,18 @@ class OptionsReader:
        return result


+def _inner_fmt(k: str, v: Any, table: TableFmt) -> Iterator[str]:
+    quote_function = table.get("quote", lambda a: a)
+
+    if isinstance(v, list):
+        for inner_v in v:
+            qv = quote_function(inner_v)
+            yield table["item"].format(k=k, v=qv)
+    else:
+        qv = quote_function(v)
+        yield table["item"].format(k=k, v=qv)
+
+
 class Options:
    def __init__(self, platform: PlatformName, command_line_arguments: CommandLineArguments):
        self.platform = platform
@@ -388,6 +412,15 @@ class Options:
        )
        requires_python = None if requires_python_str is None else SpecifierSet(requires_python_str)

+        archs_config_str = args.archs or self.reader.get("archs", sep=" ")
+        architectures = Architecture.parse_config(archs_config_str, platform=self.platform)
+
+        # Process `--only`
+        if args.only:
+            build_config = args.only
+            skip_config = ""
+            architectures = Architecture.all_archs(self.platform)
+
        build_selector = BuildSelector(
            build_config=build_config,
            skip_config=skip_config,
@@ -396,9 +429,6 @@ class Options:
        )
        test_selector = TestSelector(skip_config=test_skip)

-        archs_config_str = args.archs or self.reader.get("archs", sep=" ")
-        architectures = Architecture.parse_config(archs_config_str, platform=self.platform)
-
        container_engine_str = self.reader.get("container-engine")

        if container_engine_str not in ["docker", "podman"]:
@@ -432,6 +462,9 @@ class Options:
            environment_pass = self.reader.get("environment-pass", sep=" ").split()
            before_build = self.reader.get("before-build", sep=" && ")
            repair_command = self.reader.get("repair-wheel-command", sep=" && ")
+            config_settings = self.reader.get(
+                "config-settings", table={"item": "{k}={v}", "sep": " ", "quote": shlex.quote}
+            )

            dependency_versions = self.reader.get("dependency-versions")
            test_command = self.reader.get("test-command", sep=" && ")
@@ -537,6 +570,7 @@ class Options:
                manylinux_images=manylinux_images or None,
                musllinux_images=musllinux_images or None,
                build_frontend=build_frontend,
+                config_settings=config_settings,
            )

    def check_for_invalid_configuration(self, identifiers: list[str]) -> None:
@@ -569,6 +603,9 @@ class Options:
        ]

        build_option_defaults = self.build_options(identifier=None)
+        build_options_for_identifier = {
+            identifier: self.build_options(identifier) for identifier in identifiers
+        }

        for option_name, default_value in sorted(asdict(build_option_defaults).items()):
            if option_name == "globals":
@@ -578,7 +615,7 @@ class Options:

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

@@ -81,12 +81,12 @@ python_configurations = [
  { identifier = "cp39-macosx_x86_64", version = "3.9", url = "https://www.python.org/ftp/python/3.9.13/python-3.9.13-macos11.pkg" },
  { identifier = "cp39-macosx_arm64", version = "3.9", url = "https://www.python.org/ftp/python/3.9.13/python-3.9.13-macos11.pkg" },
  { identifier = "cp39-macosx_universal2", version = "3.9", url = "https://www.python.org/ftp/python/3.9.13/python-3.9.13-macos11.pkg" },
-  { identifier = "cp310-macosx_x86_64", version = "3.10", url = "https://www.python.org/ftp/python/3.10.6/python-3.10.6-macos11.pkg" },
-  { identifier = "cp310-macosx_arm64", version = "3.10", url = "https://www.python.org/ftp/python/3.10.6/python-3.10.6-macos11.pkg" },
-  { identifier = "cp310-macosx_universal2", version = "3.10", url = "https://www.python.org/ftp/python/3.10.6/python-3.10.6-macos11.pkg" },
-  { identifier = "cp311-macosx_x86_64", version = "3.11", url = "https://www.python.org/ftp/python/3.11.0/python-3.11.0rc1-macos11.pkg" },
-  { identifier = "cp311-macosx_arm64", version = "3.11", url = "https://www.python.org/ftp/python/3.11.0/python-3.11.0rc1-macos11.pkg" },
-  { identifier = "cp311-macosx_universal2", version = "3.11", url = "https://www.python.org/ftp/python/3.11.0/python-3.11.0rc1-macos11.pkg" },
+  { identifier = "cp310-macosx_x86_64", version = "3.10", url = "https://www.python.org/ftp/python/3.10.7/python-3.10.7-macos11.pkg" },
+  { identifier = "cp310-macosx_arm64", version = "3.10", url = "https://www.python.org/ftp/python/3.10.7/python-3.10.7-macos11.pkg" },
+  { identifier = "cp310-macosx_universal2", version = "3.10", url = "https://www.python.org/ftp/python/3.10.7/python-3.10.7-macos11.pkg" },
+  { identifier = "cp311-macosx_x86_64", version = "3.11", url = "https://www.python.org/ftp/python/3.11.0/python-3.11.0rc2-macos11.pkg" },
+  { identifier = "cp311-macosx_arm64", version = "3.11", url = "https://www.python.org/ftp/python/3.11.0/python-3.11.0rc2-macos11.pkg" },
+  { identifier = "cp311-macosx_universal2", version = "3.11", url = "https://www.python.org/ftp/python/3.11.0/python-3.11.0rc2-macos11.pkg" },
  { identifier = "pp37-macosx_x86_64", version = "3.7", url = "https://downloads.python.org/pypy/pypy3.7-v7.3.9-osx64.tar.bz2" },
  { identifier = "pp38-macosx_x86_64", version = "3.8", url = "https://downloads.python.org/pypy/pypy3.8-v7.3.9-osx64.tar.bz2" },
  { identifier = "pp39-macosx_x86_64", version = "3.9", url = "https://downloads.python.org/pypy/pypy3.9-v7.3.9-osx64.tar.bz2" },
@@ -102,13 +102,13 @@ python_configurations = [
  { identifier = "cp38-win_amd64", version = "3.8.10", arch = "64" },
  { identifier = "cp39-win32", version = "3.9.13", arch = "32" },
  { identifier = "cp39-win_amd64", version = "3.9.13", arch = "64" },
-  { identifier = "cp310-win32", version = "3.10.6", arch = "32" },
-  { identifier = "cp310-win_amd64", version = "3.10.6", arch = "64" },
-  { identifier = "cp311-win32", version = "3.11.0-rc1", arch = "32" },
-  { identifier = "cp311-win_amd64", version = "3.11.0-rc1", arch = "64" },
+  { identifier = "cp310-win32", version = "3.10.7", arch = "32" },
+  { identifier = "cp310-win_amd64", version = "3.10.7", arch = "64" },
+  { identifier = "cp311-win32", version = "3.11.0-rc2", arch = "32" },
+  { identifier = "cp311-win_amd64", version = "3.11.0-rc2", arch = "64" },
  { identifier = "cp39-win_arm64", version = "3.9.10", arch = "ARM64" },
-  { identifier = "cp310-win_arm64", version = "3.10.6", arch = "ARM64" },
-  { identifier = "cp311-win_arm64", version = "3.11.0-rc1", arch = "ARM64" },
+  { identifier = "cp310-win_arm64", version = "3.10.7", arch = "ARM64" },
+  { identifier = "cp311-win_arm64", version = "3.11.0-rc2", arch = "ARM64" },
  { identifier = "pp37-win_amd64", version = "3.7", arch = "64", url = "https://downloads.python.org/pypy/pypy3.7-v7.3.9-win64.zip" },
  { identifier = "pp38-win_amd64", version = "3.8", arch = "64", url = "https://downloads.python.org/pypy/pypy3.8-v7.3.9-win64.zip" },
  { identifier = "pp39-win_amd64", version = "3.9", arch = "64", url = "https://downloads.python.org/pypy/pypy3.9-v7.3.9-win64.zip" },
@@ -6,7 +6,7 @@
 #
 delocate==0.10.2
    # via -r cibuildwheel/resources/constraints.in
-distlib==0.3.5
+distlib==0.3.6
    # via virtualenv
 filelock==3.8.0
    # via virtualenv
@@ -14,7 +14,7 @@ platformdirs==2.5.2
    # via virtualenv
 typing-extensions==4.3.0
    # via delocate
-virtualenv==20.16.3
+virtualenv==20.16.5
    # via -r cibuildwheel/resources/constraints.in
 wheel==0.37.1
    # via
@@ -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==63.4.2
+setuptools==65.3.0
    # via -r cibuildwheel/resources/constraints.in
@@ -6,7 +6,7 @@
 #
 delocate==0.10.2
    # via -r cibuildwheel/resources/constraints.in
-distlib==0.3.5
+distlib==0.3.6
    # via virtualenv
 filelock==3.8.0
    # via virtualenv
@@ -14,7 +14,7 @@ platformdirs==2.5.2
    # via virtualenv
 typing-extensions==4.3.0
    # via delocate
-virtualenv==20.16.3
+virtualenv==20.16.5
    # via -r cibuildwheel/resources/constraints.in
 wheel==0.37.1
    # via
@@ -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==63.4.2
+setuptools==65.3.0
    # via -r cibuildwheel/resources/constraints.in
@@ -6,7 +6,7 @@
 #
 delocate==0.10.2
    # via -r cibuildwheel/resources/constraints.in
-distlib==0.3.5
+distlib==0.3.6
    # via virtualenv
 filelock==3.4.1
    # via virtualenv
@@ -20,7 +20,7 @@ typing-extensions==4.1.1
    # via
    #   delocate
    #   importlib-metadata
-virtualenv==20.16.3
+virtualenv==20.16.5
    # via -r cibuildwheel/resources/constraints.in
 wheel==0.37.1
    # via
@@ -6,7 +6,7 @@
 #
 delocate==0.10.2
    # via -r cibuildwheel/resources/constraints.in
-distlib==0.3.5
+distlib==0.3.6
    # via virtualenv
 filelock==3.8.0
    # via virtualenv
@@ -18,7 +18,7 @@ typing-extensions==4.3.0
    # via
    #   delocate
    #   importlib-metadata
-virtualenv==20.16.3
+virtualenv==20.16.5
    # via -r cibuildwheel/resources/constraints.in
 wheel==0.37.1
    # via
@@ -30,5 +30,5 @@ zipp==3.8.1
 # The following packages are considered to be unsafe in a requirements file:
 pip==22.2.2
    # via -r cibuildwheel/resources/constraints.in
-setuptools==63.4.2
+setuptools==65.3.0
    # via -r cibuildwheel/resources/constraints.in
@@ -6,7 +6,7 @@
 #
 delocate==0.10.2
    # via -r cibuildwheel/resources/constraints.in
-distlib==0.3.5
+distlib==0.3.6
    # via virtualenv
 filelock==3.8.0
    # via virtualenv
@@ -14,7 +14,7 @@ platformdirs==2.5.2
    # via virtualenv
 typing-extensions==4.3.0
    # via delocate
-virtualenv==20.16.3
+virtualenv==20.16.5
    # via -r cibuildwheel/resources/constraints.in
 wheel==0.37.1
    # via
@@ -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==63.4.2
+setuptools==65.3.0
    # via -r cibuildwheel/resources/constraints.in
@@ -6,7 +6,7 @@
 #
 delocate==0.10.2
    # via -r cibuildwheel/resources/constraints.in
-distlib==0.3.5
+distlib==0.3.6
    # via virtualenv
 filelock==3.8.0
    # via virtualenv
@@ -14,7 +14,7 @@ platformdirs==2.5.2
    # via virtualenv
 typing-extensions==4.3.0
    # via delocate
-virtualenv==20.16.3
+virtualenv==20.16.5
    # via -r cibuildwheel/resources/constraints.in
 wheel==0.37.1
    # via
@@ -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==63.4.2
+setuptools==65.3.0
    # via -r cibuildwheel/resources/constraints.in
@@ -6,7 +6,7 @@
 #
 delocate==0.10.2
    # via -r cibuildwheel/resources/constraints.in
-distlib==0.3.5
+distlib==0.3.6
    # via virtualenv
 filelock==3.8.0
    # via virtualenv
@@ -14,7 +14,7 @@ platformdirs==2.5.2
    # via virtualenv
 typing-extensions==4.3.0
    # via delocate
-virtualenv==20.16.3
+virtualenv==20.16.5
    # via -r cibuildwheel/resources/constraints.in
 wheel==0.37.1
    # via
@@ -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==63.4.2
+setuptools==65.3.0
    # via -r cibuildwheel/resources/constraints.in
@@ -5,6 +5,7 @@ test-skip = ""

 archs = ["auto"]
 build-frontend = "pip"
+config-settings = {}
 dependency-versions = "pinned"
 environment = {}
 environment-pass = []
@@ -1,48 +1,49 @@
 [x86_64]
-manylinux1 = quay.io/pypa/manylinux1_x86_64:2022-08-08-7292f33
+manylinux1 = quay.io/pypa/manylinux1_x86_64:2022-09-18-e2e56b7
 manylinux2010 = quay.io/pypa/manylinux2010_x86_64:2022-08-05-4535177
-manylinux2014 = quay.io/pypa/manylinux2014_x86_64:2022-08-09-51a01be
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_x86_64:2022-08-09-51a01be
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_x86_64:2022-08-09-51a01be
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_x86_64:2022-08-09-51a01be
+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

 [i686]
-manylinux1 = quay.io/pypa/manylinux1_i686:2022-08-08-7292f33
+manylinux1 = quay.io/pypa/manylinux1_i686:2022-09-18-e2e56b7
 manylinux2010 = quay.io/pypa/manylinux2010_i686:2022-08-05-4535177
-manylinux2014 = quay.io/pypa/manylinux2014_i686:2022-08-09-51a01be
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_i686:2022-08-09-51a01be
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_i686:2022-08-09-51a01be
+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

 [pypy_x86_64]
 manylinux2010 = quay.io/pypa/manylinux2010_x86_64:2022-08-05-4535177
-manylinux2014 = quay.io/pypa/manylinux2014_x86_64:2022-08-09-51a01be
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_x86_64:2022-08-09-51a01be
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_x86_64:2022-08-09-51a01be
+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

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

 [aarch64]
-manylinux2014 = quay.io/pypa/manylinux2014_aarch64:2022-08-09-51a01be
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_aarch64:2022-08-09-51a01be
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_aarch64:2022-08-09-51a01be
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_aarch64:2022-08-09-51a01be
+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

 [ppc64le]
-manylinux2014 = quay.io/pypa/manylinux2014_ppc64le:2022-08-09-51a01be
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_ppc64le:2022-08-09-51a01be
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_ppc64le:2022-08-09-51a01be
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_ppc64le:2022-08-09-51a01be
+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

 [s390x]
-manylinux2014 = quay.io/pypa/manylinux2014_s390x:2022-08-09-51a01be
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_s390x:2022-08-09-51a01be
-musllinux_1_1 = quay.io/pypa/musllinux_1_1_s390x:2022-08-09-51a01be
+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

 [pypy_aarch64]
-manylinux2014 = quay.io/pypa/manylinux2014_aarch64:2022-08-09-51a01be
-manylinux_2_24 = quay.io/pypa/manylinux_2_24_aarch64:2022-08-09-51a01be
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_aarch64:2022-08-09-51a01be
+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

@@ -1,2 +1,2 @@
-version = "20.16.3"
-url = "https://github.com/pypa/get-virtualenv/blob/20.16.3/public/virtualenv.pyz?raw=true"
+version = "20.16.5"
+url = "https://github.com/pypa/get-virtualenv/blob/20.16.5/public/virtualenv.pyz?raw=true"
@@ -10,6 +10,10 @@ if sys.version_info < (3, 8):
 else:
    from typing import Final, Literal, OrderedDict, Protocol, TypedDict

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

 __all__ = (
    "Final",
@@ -26,6 +30,7 @@ __all__ = (
    "OrderedDict",
    "Union",
    "assert_never",
+    "NotRequired",
 )


@@ -60,15 +60,16 @@ __all__ = [
    "strtobool",
    "cached_property",
    "chdir",
+    "split_config_settings",
 ]

-resources_dir: Final = Path(__file__).parent / "resources"
+resources_dir: Final[Path] = Path(__file__).parent / "resources"

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

 BuildFrontend = Literal["pip", "build"]

-MANYLINUX_ARCHS: Final = (
+MANYLINUX_ARCHS: Final[tuple[str, ...]] = (
    "x86_64",
    "i686",
    "pypy_x86_64",
@@ -79,7 +80,7 @@ MANYLINUX_ARCHS: Final = (
    "pypy_i686",
 )

-MUSLLINUX_ARCHS: Final = (
+MUSLLINUX_ARCHS: Final[tuple[str, ...]] = (
    "x86_64",
    "i686",
    "aarch64",
@@ -87,10 +88,12 @@ MUSLLINUX_ARCHS: Final = (
    "s390x",
 )

-DEFAULT_CIBW_CACHE_PATH: Final = user_cache_path(appname="cibuildwheel", appauthor="pypa")
-CIBW_CACHE_PATH: Final = Path(os.environ.get("CIBW_CACHE_PATH", DEFAULT_CIBW_CACHE_PATH)).resolve()
+DEFAULT_CIBW_CACHE_PATH: Final[Path] = user_cache_path(appname="cibuildwheel", appauthor="pypa")
+CIBW_CACHE_PATH: Final[Path] = Path(
+    os.environ.get("CIBW_CACHE_PATH", DEFAULT_CIBW_CACHE_PATH)
+).resolve()

-IS_WIN: Final = sys.platform.startswith("win")
+IS_WIN: Final[bool] = sys.platform.startswith("win")


@overload
@@ -144,7 +147,7 @@ def shell(*commands: str, env: dict[str, str] | None = None, cwd: PathOrStr | No
    subprocess.run(command, env=env, cwd=cwd, shell=True, check=True)


-def format_safe(template: str, **kwargs: Any) -> str:
+def format_safe(template: str, **kwargs: str | os.PathLike[str]) -> str:
    """
    Works similarly to `template.format(**kwargs)`, except that unmatched
    fields in `template` are passed through untouched.
@@ -172,11 +175,9 @@ def format_safe(template: str, **kwargs: Any) -> str:
            re.VERBOSE,
        )

-        # we use a function for repl to prevent re.sub interpreting backslashes
-        # in repl as escape sequences.
        result = re.sub(
            pattern=find_pattern,
-            repl=lambda _: str(value),  # pylint: disable=cell-var-from-loop
+            repl=str(value).replace("\\", r"\\"),
            string=result,
        )

@@ -205,6 +206,11 @@ def get_build_verbosity_extra_flags(level: int) -> list[str]:
        return []


+def split_config_settings(config_settings: str) -> list[str]:
+    config_settings_list = shlex.split(config_settings)
+    return [f"--config-setting={setting}" for setting in config_settings_list]
+
+
 def read_python_configs(config: PlatformName) -> list[dict[str, str]]:
    input_file = resources_dir / "build-platforms.toml"
    with input_file.open("rb") as f:
@@ -393,6 +399,7 @@ class CIProvider(Enum):
    azure_pipelines = "azure_pipelines"
    github_actions = "github_actions"
    gitlab = "gitlab"
+    cirrus_ci = "cirrus_ci"
    other = "other"


@@ -409,6 +416,8 @@ def detect_ci_provider() -> CIProvider | None:
        return CIProvider.github_actions
    elif "GITLAB_CI" in os.environ:
        return CIProvider.gitlab
+    elif "CIRRUS_CI" in os.environ:
+        return CIProvider.cirrus_ci
    elif strtobool(os.environ.get("CI", "false")):
        return CIProvider.other
    else:
@@ -32,6 +32,7 @@ from .util import (
    prepare_command,
    read_python_configs,
    shell,
+    split_config_settings,
    virtualenv,
 )

@@ -136,7 +137,8 @@ def setup_python(
        assert python_configuration.url is not None
        base_python = install_pypy(tmp, python_configuration.arch, python_configuration.url)
    else:
-        raise ValueError("Unknown Python implementation")
+        msg = "Unknown Python implementation"
+        raise ValueError(msg)
    assert base_python.exists()

    log.step("Setting up build environment...")
@@ -302,8 +304,10 @@ def build(options: Options, tmp_path: Path) -> None:
                built_wheel_dir.mkdir()

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

                if build_options.build_frontend == "pip":
+                    extra_flags += verbosity_flags
                    # Path.resolve() is needed. Without it pip wheel may try to fetch package from pypi.org
                    # see https://github.com/pypa/cibuildwheel/pull/369
                    call(
@@ -314,11 +318,12 @@ def build(options: Options, tmp_path: Path) -> None:
                        options.globals.package_dir.resolve(),
                        f"--wheel-dir={built_wheel_dir}",
                        "--no-deps",
-                        *get_build_verbosity_extra_flags(build_options.build_verbosity),
+                        *extra_flags,
                        env=env,
                    )
                elif build_options.build_frontend == "build":
-                    config_setting = " ".join(verbosity_flags)
+                    verbosity_setting = " ".join(verbosity_flags)
+                    extra_flags += (f"--config-setting={verbosity_setting}",)
                    build_env = env.copy()
                    if build_options.dependency_constraints:
                        constraints_path = (
@@ -345,7 +350,7 @@ def build(options: Options, tmp_path: Path) -> None:
                            build_options.package_dir,
                            "--wheel",
                            f"--outdir={built_wheel_dir}",
-                            f"--config-setting={config_setting}",
+                            *extra_flags,
                            env=build_env,
                        )
                else:
@@ -2,6 +2,34 @@
 title: Changelog
 ---

+# Changelog
+
+### v2.10.2
+
+_25 September 2022_
+
+- 🐛 Fix a bug that caused `win32` identifiers to fail when used with `--only`. (#1282)
+- 🐛 Fix computation of `auto`/`auto64`/`auto32` archs when targeting a different platform to the one that you're running cibuildwheel on. (#1266)
+- 📚 Fix an mistake in the 'how it works' diagram. (#1274)
+
+### v2.10.1
+
+_18 September 2022_
+
+- 🐛 Fix a bug that stopped environment variables specified in TOML from being expanded. (#1273)
+
+### v2.10.0
+
+_13 September 2022_
+
+- 🌟 Adds support for [building wheels on Cirrus CI](https://cibuildwheel.readthedocs.io/en/stable/setup/#cirrus-ci). This is exciting for us, as it's the first public CI platform that natively supports macOS Apple Silicon (aka. M1, `arm64`) runners. As such, it's the first platform that you can natively build _and test_ macOS `arm64` wheels. It also has native Linux ARM (aarch64) runners, for fast, native builds there. (#1191)
+- 🌟 Adds support for running cibuildwheel on Apple Silicon machines. For a while, we've supported cross-compilation of Apple Silicon wheels on `x86_64`, but now that we have Cirrus CI we can run our test suite and officially support running cibuildwheel on `arm64`. (#1191)
+- ✨ Adds the `--only` [command line option](https://cibuildwheel.readthedocs.io/en/stable/options/#command-line), to specify a single build to run. Previously, it could be cumbersome to set all the build selection options to target a specific build - for example, you might have to run something like `CIBW_BUILD=cp39-manylinux_x86_64 cibuildwheel --platform linux --archs x86_64`. The new `--only` option overrides all the build selection options to simplify running a single build, which now looks like `cibuildwheel --only cp39-manylinux_x86_64`. (#1098)
+- ✨ Adds the [`CIBW_CONFIG_SETTINGS`](https://cibuildwheel.readthedocs.io/en/stable/options/#config-settings) option, so you can pass arguments to your package's build backend (#1244)
+- 🛠 Updates the CPython 3.11 version to the latest release candidate - v3.11.0rc2. (#1265)
+- 🐛 Fix a bug that can cause a RecursionError on Windows when building from an sdist. (#1253)
+- 🛠 Add support for the s390x architecture on manylinux_2_28 (#1255)
+
 ### v2.9.0

 _11 August 2022_
@@ -2,6 +2,8 @@
 title: Contributing
 ---

+# Contributing
+
 Wheel-building can be pretty complex. We expect users to find edge-cases - please help the rest of the community out by documenting these, adding features to support them, and reporting bugs.

 If you have an idea for a modification or feature, it's probably best to raise an issue first and discuss it with the maintainer team. Once we have rough consensus on a design, begin work in a PR.
@@ -2,6 +2,8 @@
 title: Modern C++ standards
 ---

+# Modern C++ standards
+
 Building Python wheels with modern C++ standards (C++11 and later) requires a few tricks.


@@ -4,7 +4,7 @@
 # stars: GitHub repo (optional, if different from package, such as for Twisted)
 # pypi: The pypi name, if different from the GitHub package name
 # os: Operating system list, [windows, apple, linux] (optional)
-# ci: [appveyor, github, azurepipelines, circleci, gitlab, travisci] (optional)
+# ci: [appveyor, github, azurepipelines, circleci, gitlab, travisci, cirrusci] (optional)
 # notes: (text, optional)

 - name: abess
@@ -606,3 +606,10 @@
  ci: [github]
  os: [linux, apple]
  note: A machine learning model serving framework powered by Rust
+
+- name: ril
+  gh: Cryptex-github/ril-py
+  ci: [github]
+  os: [windows, apple, linux]
+  pypi: pyril
+  notes: A python binding to Rust Imaging library using maturin and Pyo3, utilizes Github Action cache to improve speed. Builds abi3 wheels.
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" role="img" viewBox="0 0 24 24" width="16px" fill="#606060"><title>Cirrus CI icon</title><path d="M19.422.453a1.113 1.113 0 0 0-1.113 1.115 1.113 1.113 0 0 0 1.112 1.114c1.31 0 2.35 1.042 2.35 2.363 0 1.32-1.04 2.363-2.35 2.363H1.112A1.113 1.113 0 0 0 0 8.52a1.113 1.113 0 0 0 1.113 1.117h18.31c1.308 0 2.35 1.042 2.35 2.363 0 1.32-1.042 2.363-2.35 2.363H1.112A1.113 1.113 0 0 0 0 15.48a1.113 1.113 0 0 0 1.113 1.112h18.31c1.308 0 2.35 1.042 2.35 2.363 0 1.32-1.042 2.363-2.35 2.363H1.112A1.113 1.113 0 0 0 0 22.432a1.113 1.113 0 0 0 1.113 1.115h18.31a1.113 1.113 0 0 0 .206-.022c2.42-.112 4.37-2.12 4.37-4.57 0-1.393-.642-2.634-1.63-3.478C23.356 14.632 24 13.393 24 12c0-1.393-.643-2.632-1.63-3.477C23.357 7.68 24 6.438 24 5.045c0-2.52-2.06-4.592-4.578-4.592z"/></svg>
@@ -2,6 +2,8 @@
 title: Delivering to PyPI
 ---

+# Delivering to PyPI
+
 After you've built your wheels, you'll probably want to deliver them to PyPI.

 ## Manual method
@@ -29,7 +29,7 @@
    </div>
    <div class="grid-column-label"
         style="grid-row: 2 / span 1;
-                grid-column: 8 / -3;
+                grid-column: 9 / -3;
                margin-bottom: 0.5em;">
      <div class="label">If tests are configured</div>
    </div>
@@ -382,7 +382,7 @@
  }
  .grid-column-label .label {
    background: #fcfcfc;
-    padding: 0 2em;
+    padding: 0 1em;
    position: relative;
  }
  .grid-row-label {
@@ -420,7 +420,7 @@
    grid-column: 3 / -2;
  }
  .grid-outline.testVenv {
-    grid-column: 8 / span 4;
+    grid-column: 9 / span 3;
  }
  .grid-outline .outline {
    position: absolute;
@@ -4,6 +4,7 @@
 body {
    overflow-wrap: break-word;
    overflow-x: hidden;
+    -webkit-font-smoothing: antialiased;
 }

 p {
@@ -62,6 +63,13 @@ h1, h2, h3, h4, h5, h6 {
  border: none;
 }

+@media screen and (max-width: 768px) {
+  .wy-nav-content-wrap .wy-nav-content {
+      padding: 1em;
+  }
+}
+
+
 /*
    Code block filename style

@@ -105,10 +113,10 @@ h1, h2, h3, h4, h5, h6 {
 .code-block-filename + pre code {
    padding-top: 0.9em;
 }
-
+/*
 .toctree-l3 {
  border-left: 10px solid transparent;
-}
+} */

 /* import font awesome 4 for icons */
@import url(https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css);
@@ -226,3 +234,84 @@ h1, h2, h3, h4, h5, h6 {
  padding-right: 0;
  margin-bottom: 0.5em;
 }
+
+/* mkdocs update theme fix-ups */
+
+.rst-content code, .rst-content tt, code {
+  /* border: none; */
+  /* background-color: #f0f1f1; */
+  color: inherit;
+}
+.rst-content pre code {
+  border: none;
+}
+
+.rst-content h1 code,
+.rst-content h2 code,
+.rst-content h3 code,
+.rst-content h4 code,
+.rst-content h5 code,
+.rst-content h6 code {
+  border: none;
+  color: inherit;
+  background-color: #f0f1f1;
+  font-size: 100%;
+}
+
+
+/* expand all the toctree entries */
+.wy-menu-vertical .toctree-l1.current .toctree-l2>ul,
+.wy-menu-vertical .toctree-l2.current .toctree-l3>ul,
+.wy-menu-vertical .toctree-l3.current .toctree-l4>ul,
+.wy-menu-vertical .toctree-l4.current .toctree-l5>ul,
+.wy-menu-vertical .toctree-l5.current .toctree-l6>ul,
+.wy-menu-vertical .toctree-l6.current .toctree-l7>ul,
+.wy-menu-vertical .toctree-l7.current .toctree-l8>ul,
+.wy-menu-vertical .toctree-l8.current .toctree-l9>ul,
+.wy-menu-vertical .toctree-l9.current .toctree-l10>ul,
+.wy-menu-vertical .toctree-l10.current .toctree-l11>ul {
+  display: block;
+}
+
+/* hide all the buttons */
+.wy-menu-vertical li.current>a button.toctree-expand,
+.wy-menu-vertical li.on a button.toctree-expand,
+.wy-menu-vertical li.toctree-l2 button.toctree-expand,
+.wy-menu-vertical li a button.toctree-expand {
+  display: none;
+}
+
+/* toctree layout improvements */
+.wy-menu-vertical a {
+  padding: 0.4em 1.2em;
+}
+.wy-menu-vertical li.current>a,
+.wy-menu-vertical li.on a {
+  font-weight: normal;
+  padding: 0.4em 1.2em;
+  /* border-right: 1px solid #f0f0f0; */
+}
+.wy-menu-vertical li.current a {
+  padding: 0.4em 1.2em;
+}
+.wy-menu-vertical li.toctree-l3 a,
+.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a {
+  padding-left: 1.8em;
+}
+.wy-menu-vertical li.toctree-l2.current>a {
+  padding: 0.4em 1.2em;
+}
+.wy-menu-vertical li.toctree-l2.current>a,
+.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a {
+  background: transparent;
+}
+.wy-menu-vertical li.toctree-l2.current>a:hover,
+.wy-menu-vertical li.toctree-l2.current li.toctree-l3>a:hover {
+  background: #d6d6d6;
+}
+.wy-menu-vertical li.current>a.current {
+  background: #fafafa !important;
+}
+.wy-menu-vertical li.current a {
+
+}
@@ -2,6 +2,8 @@
 title: Tips and tricks
 ---

+# Tips and tricks
+
 ## Tips

 ### Linux builds in containers
@@ -81,6 +83,14 @@ Here's an example GitHub Actions workflow with a job that builds for Apple Silic
 {% include "../examples/github-apple-silicon.yml" %}
 ```

+Here's an example Cirrus CI workflow with a job that builds for macOS Intel through Rosetta 2 emulation and for Apple Silicon natively:
+
+> .cirrus.yml
+
+```yml
+{% include "../examples/cirrus-ci-intel-mac.yml" %}
+```
+
 ### Building non-native architectures using emulation  {: #emulation}

 cibuildwheel supports building non-native architectures on Linux, via
@@ -132,7 +142,7 @@ There are two suggested methods for keeping cibuildwheel up to date that instead
 If you use GitHub Actions for builds, you can use cibuildwheel as an action:

 ```yaml
-uses: pypa/cibuildwheel@v2.9.0
+uses: pypa/cibuildwheel@v2.10.2
 ```

 This is a composite step that just runs cibuildwheel using pipx. You can set command-line options as `with:` parameters, and use `env:` as normal.
@@ -154,7 +164,7 @@ The second option, and the only one that supports other CI systems, is using a `

 ```bash
 # requirements-cibw.txt
-cibuildwheel==2.9.0
+cibuildwheel==2.10.2
 ```

 Then your install step would have `python -m pip install -r requirements-cibw.txt` in it. Your `.github/dependabot.yml` file could look like this:
@@ -2,6 +2,8 @@
 title: Home
 ---

+# cibuildwheel
+
 {%
   include-markdown "../README.md"
   start="<!--intro-start-->"
@@ -1,3 +1,5 @@
+# Options
+
 ## Setting options

 cibuildwheel can either be configured using environment variables, or from
@@ -73,6 +75,16 @@ cibuildwheel to run tests, add the following YAML to your CI config file:
        CIBW_TEST_COMMAND: "pytest {project}/tests"
    ```

+!!! tab "Cirrus CI"
+
+    > .cirrus.yml ([docs](https://cirrus-ci.org/guide/writing-tasks/#environment-variables))
+
+    ```yaml
+    env:
+      CIBW_TEST_REQUIRES: pytest
+      CIBW_TEST_COMMAND: "pytest {project}/tests"
+    ```
+
 ### Configuration file {: #configuration-file}

 You can configure cibuildwheel with a config file, such as `pyproject.toml`.
@@ -101,7 +113,7 @@ The complete set of defaults for the current version of cibuildwheel are shown b

 !!! tip
    Static configuration works across all CI systems, and can be used locally if
-    you run `cibuildwheel --plat linux`. This is preferred, but environment
+    you run `cibuildwheel --platform linux`. This is preferred, but environment
    variables are better if you need to change per-matrix element
    (`CIBW_BUILD` is often in this category, for example), or if you cannot or do
    not want to change a `pyproject.toml` file. You can specify a different file to
@@ -190,6 +202,10 @@ This option can also be set using the [command-line option](#command-line) `--pl

    This is even more convenient if you store your cibuildwheel config in [`pyproject.toml`](#configuration-file).

+    You can also run a single identifier with `--only <identifier>`. This will
+    not require `--platform` or `--arch`, and will override any build/skip
+    configuration.
+
 ### `CIBW_BUILD`, `CIBW_SKIP` {: #build-skip}

 > Choose the Python versions to build
@@ -517,6 +533,36 @@ Choose which build backend to use. Can either be "pip", which will run
    build-frontend = "pip"
    ```

+### `CIBW_CONFIG_SETTINGS` {: #config-settings}
+> Specify config-settings for the build backend.
+
+Specify config settings for the build backend. Each space separated
+item will be passed via `--config-setting`. In TOML, you can specify
+a table of items, including arrays.
+
+!!! tip
+    Currently, "build" supports arrays for options, but "pip" only supports
+    single values.
+
+Platform-specific environment variables also available:<br/>
+`CIBW_BEFORE_ALL_MACOS` | `CIBW_BEFORE_ALL_WINDOWS` | `CIBW_BEFORE_ALL_LINUX`
+
+
+#### Examples
+
+!!! tab examples "Environment variables"
+
+    ```yaml
+    CIBW_CONFIG_SETTINGS: "--build-option=--use-mypyc"
+    ```
+
+!!! tab examples "pyproject.toml"
+
+    ```toml
+    [tool.cibuildwheel.config-settings]
+    --build-option = "--use-mypyc"
+    ```
+

 ### `CIBW_ENVIRONMENT` {: #environment}
 > Set environment variables needed during the build
@@ -899,7 +945,7 @@ The available options are (default value):
 Set an alternative Docker image to be used for building [manylinux / musllinux](https://github.com/pypa/manylinux) wheels.

 For `CIBW_MANYLINUX_*_IMAGE`, the value of this option can either be set to `manylinux1`, `manylinux2010`, `manylinux2014`, `manylinux_2_24` or `manylinux_2_28` to use a pinned version of the [official manylinux images](https://github.com/pypa/manylinux). Alternatively, set these options to any other valid Docker image name. For PyPy, the `manylinux1` image is not available. For architectures other
-than x86 (x86\_64 and i686) `manylinux2014`, `manylinux_2_24` or `manylinux_2_28` must be used, because the first version of the manylinux specification that supports additional architectures is `manylinux2014`. `manylinux_2_28` is not supported for `i686` & `s390x` architectures.
+than x86 (x86\_64 and i686) `manylinux2014`, `manylinux_2_24` or `manylinux_2_28` must be used, because the first version of the manylinux specification that supports additional architectures is `manylinux2014`. `manylinux_2_28` is not supported for `i686` architecture.

 For `CIBW_MUSLLINUX_*_IMAGE`, the value of this option can either be set to `musllinux_1_1` to use a pinned version of the [official musllinux images](https://github.com/pypa/musllinux). Alternatively, set these options to any other valid Docker image name.

@@ -1352,6 +1398,12 @@ Some options support placeholders, like `{project}`, `{package}` or `{wheel}`, t
    margin-top: 28px;
    overflow-x: auto;
  }
+  @media screen and (max-width: 768px) {
+    .options-toc {
+      grid-gap: 1em 0.5em;
+      gap: 1em 0.5em;
+    }
+  }
  .options-toc .header {
    grid-column: 1 / 3;
    font-weight: bold;
@@ -2,7 +2,9 @@
 title: 'Setup'
 ---

-# Run cibuildwheel locally (optional) {: #local}
+# Setup
+
+## Run cibuildwheel locally (optional) {: #local}

 Before getting to CI setup, it can be convenient to test cibuildwheel
 locally to quickly iterate and track down issues without even touching CI.
@@ -89,7 +91,7 @@ You should see the builds taking place. You can experiment with options using en
    cibuildwheel --platform linux
    ```

-## Linux builds
+### Linux builds

 If you've got [Docker](https://www.docker.com/products/docker-desktop) installed on
 your development machine, you can run a Linux build.
@@ -105,7 +107,7 @@ they're perfectly reproducible.

 The only side effect to your system will be docker images being pulled.

-## macOS / Windows builds
+### macOS / Windows builds

 Pre-requisite: you need to have native build tools installed.

@@ -137,9 +139,9 @@ You can override the cache folder using the ``CIBW_CACHE_PATH`` environment vari
    ```


-# Configure a CI service
+## Configure a CI service

-## GitHub Actions [linux/mac/windows] {: #github-actions}
+### GitHub Actions [linux/mac/windows] {: #github-actions}

 To build Linux, Mac, and Windows wheels using GitHub Actions, create a `.github/workflows/build_wheels.yml` file in your repo.

@@ -182,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.9.0
+            run: pipx run cibuildwheel==2.10.2

          - uses: actions/upload-artifact@v3
            with:
@@ -217,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.9.0
+            run: python -m pip install cibuildwheel==2.10.2

          - name: Build wheels
            run: python -m cibuildwheel --output-dir wheelhouse
@@ -235,7 +237,7 @@ For more info on this file, check out the [docs](https://help.github.com/en/acti
 [`examples/github-deploy.yml`](https://github.com/pypa/cibuildwheel/blob/main/examples/github-deploy.yml) extends this minimal example with a demonstration of how to automatically upload the built wheels to PyPI.


-## Azure Pipelines [linux/mac/windows] {: #azure-pipelines}
+### Azure Pipelines [linux/mac/windows] {: #azure-pipelines}

 To build Linux, Mac, and Windows wheels on Azure Pipelines, create a `azure-pipelines.yml` file in your repo.

@@ -249,7 +251,7 @@ Commit this file, enable building of your repo on Azure Pipelines, and push.

 Wheels will be stored for you and available through the Pipelines interface. For more info on this file, check out the [docs](https://docs.microsoft.com/en-us/azure/devops/pipelines/yaml-schema).

-## Travis CI [linux/windows] {: #travis-ci}
+### Travis CI [linux/windows] {: #travis-ci}

 To build Linux and Windows wheels on Travis CI, create a `.travis.yml` file in your repo.

@@ -265,7 +267,7 @@ Then setup a deployment method by following the [Travis CI deployment docs](http

 [`examples/travis-ci-deploy.yml`](https://github.com/pypa/cibuildwheel/blob/main/examples/travis-ci-deploy.yml) extends this minimal example with a demonstration of how to automatically upload the built wheels to PyPI.

-## AppVeyor [linux/mac/windows] {: #appveyor}
+### AppVeyor [linux/mac/windows] {: #appveyor}

 To build Linux, Mac, and Windows wheels on AppVeyor, create an `appveyor.yml` file in your repo.

@@ -281,7 +283,7 @@ AppVeyor will store the built wheels for you - you can access them from the proj

 For more info on this config file, check out the [docs](https://www.appveyor.com/docs/).

-## CircleCI [linux/mac] {: #circleci}
+### CircleCI [linux/mac] {: #circleci}

 To build Linux and Mac wheels on CircleCI, create a `.circleci/config.yml` file in your repo,

@@ -298,7 +300,7 @@ Commit this file, enable building of your repo on CircleCI, and push.

 CircleCI will store the built wheels for you - you can access them from the project console. Check out the CircleCI [docs](https://circleci.com/docs/2.0/configuration-reference/#section=configuration) for more info on this config file.

-## Gitlab CI [linux] {: #gitlab-ci}
+### Gitlab CI [linux] {: #gitlab-ci}

 To build Linux wheels on Gitlab CI, create a `.gitlab-ci.yml` file in your repo,

@@ -312,15 +314,29 @@ Commit this file, and push to Gitlab. The pipeline should start automatically.

 Gitlab will store the built wheels for you - you can access them from the Pipelines view. Check out the Gitlab [docs](https://docs.gitlab.com/ee/ci/yaml/) for more info on this config file.

+### Cirrus CI [linux/mac/windows] {: #cirrus-ci}
+
+To build Linux, Mac, and Windows wheels on Cirrus CI, create a `.cirrus.yml` file in your repo,
+
+> .cirrus.yml
+
+```yaml
+{% include "../examples/cirrus-ci-minimal.yml" %}
+```
+
+Commit this file, enable building of your repo on Cirrus CI, and push.
+
+Cirrus CI will store the built wheels for you - you can access them from the individual task view. Check out the Cirrus CI [docs](https://cirrus-ci.org/guide/writing-tasks/) for more info on this config file.
+
 > ⚠️ Got an error? Check the [FAQ](faq.md).

-# Next steps
+## Next steps

 Once you've got the wheel building successfully, you might want to set up [testing](options.md#test-command) or [automatic releases to PyPI](deliver-to-pypi.md#automatic-method).

 <script>
  document.addEventListener('DOMContentLoaded', function() {
-    $('a.toctree-l3, .rst-content h2').each(function(i, el) {
+    $('.toctree-l3>a, .rst-content h3').each(function(i, el) {
      var text = $(el).text()
      var match = text.match(/(.*) \[([a-z/]+)\]/);

@@ -0,0 +1,271 @@
+// imported from
+// https://github.com/readthedocs/sphinx_rtd_theme/blob/bc73ad84068b4ee7d8ddae7e51f5b767e8fd377b/src/theme.js
+// modified to suit our documentation structure, to not scroll the nav sidebar
+// when clicked - this is disorienting
+
+var jQuery = window.jQuery;
+
+// Sphinx theme nav state
+function ThemeNav () {
+
+    var nav = {
+        navBar: null,
+        win: null,
+        winScroll: false,
+        winResize: false,
+        linkScroll: false,
+        winPosition: 0,
+        winHeight: null,
+        docHeight: null,
+        isRunning: false
+    };
+
+    nav.enable = function (withStickyNav) {
+        var self = this;
+
+        // TODO this can likely be removed once the theme javascript is broken
+        // out from the RTD assets. This just ensures old projects that are
+        // calling `enable()` get the sticky menu on by default. All other cals
+        // to `enable` should include an argument for enabling the sticky menu.
+        if (typeof(withStickyNav) == 'undefined') {
+            withStickyNav = true;
+        }
+
+        if (self.isRunning) {
+            // Only allow enabling nav logic once
+            return;
+        }
+
+        self.isRunning = true;
+        jQuery(function ($) {
+            self.init($);
+
+            self.reset();
+            self.win.on('hashchange', self.reset);
+
+            if (withStickyNav) {
+                // Set scroll monitor
+                self.win.on('scroll', function () {
+                    if (!self.linkScroll) {
+                        if (!self.winScroll) {
+                            self.winScroll = true;
+                            requestAnimationFrame(function() { self.onScroll(); });
+                        }
+                    }
+                });
+            }
+
+            // Set resize monitor
+            self.win.on('resize', function () {
+                if (!self.winResize) {
+                    self.winResize = true;
+                    requestAnimationFrame(function() { self.onResize(); });
+                }
+            });
+
+            self.onResize();
+        });
+
+    };
+
+    // TODO remove this with a split in theme and Read the Docs JS logic as
+    // well, it's only here to support 0.3.0 installs of our theme.
+    nav.enableSticky = function() {
+        this.enable(true);
+    };
+
+    nav.init = function ($) {
+        var doc = $(document),
+            self = this;
+
+        this.navBar = $('div.wy-side-scroll:first');
+        this.win = $(window);
+
+        // Set up javascript UX bits
+        $(document)
+            // Shift nav in mobile when clicking the menu.
+            .on('click', "[data-toggle='wy-nav-top']", function() {
+                $("[data-toggle='wy-nav-shift']").toggleClass("shift");
+                $("[data-toggle='rst-versions']").toggleClass("shift");
+            })
+
+            // Nav menu link click operations
+            .on('click', ".wy-menu-vertical .current ul li a", function() {
+                var target = $(this);
+                // Close menu when you click a link.
+                $("[data-toggle='wy-nav-shift']").removeClass("shift");
+                $("[data-toggle='rst-versions']").toggleClass("shift");
+                // Handle dynamic display of l3 and l4 nav lists
+                self.toggleCurrent(target);
+                self.hashChange();
+            })
+            .on('click', "[data-toggle='rst-current-version']", function() {
+                $("[data-toggle='rst-versions']").toggleClass("shift-up");
+            })
+
+        // Make tables responsive
+        $("table.docutils:not(.field-list,.footnote,.citation)")
+            .wrap("<div class='wy-table-responsive'></div>");
+
+        // Add extra class to responsive tables that contain
+        // footnotes or citations so that we can target them for styling
+        $("table.docutils.footnote")
+            .wrap("<div class='wy-table-responsive footnote'></div>");
+        $("table.docutils.citation")
+            .wrap("<div class='wy-table-responsive citation'></div>");
+
+        // Add expand links to all parents of nested ul
+        $('.wy-menu-vertical ul').not('.simple').siblings('a').each(function () {
+            var link = $(this);
+                expand =
+                    $('<button class="toctree-expand" title="Open/close menu"></button>');
+            expand.on('click', function (ev) {
+                self.toggleCurrent(link);
+                ev.stopPropagation();
+                return false;
+            });
+            link.prepend(expand);
+        });
+    };
+
+    nav.reset = function () {
+        // Get anchor from URL and open up nested nav
+        var anchor = encodeURI(window.location.hash) || '#';
+
+        try {
+            var vmenu = $('.wy-menu-vertical');
+            var link = vmenu.find('[href="' + anchor + '"]');
+            if (link.length === 0) {
+                // this link was not found in the sidebar.
+                // Find associated id element, then its closest section
+                // in the document and try with that one.
+                var id_elt = $('.document [id="' + anchor.substring(1) + '"]');
+                var closest_section = id_elt.closest('div.section');
+                link = vmenu.find('[href="#' + closest_section.attr("id") + '"]');
+                if (link.length === 0) {
+                    // still not found in the sidebar. fall back to main section
+                    link = vmenu.find('[href="#"]');
+                }
+            }
+            // If we found a matching link then reset current and re-apply
+            // otherwise retain the existing match
+            if (link.length > 0) {
+                $('.wy-menu-vertical .current')
+                    .removeClass('current')
+                    .attr('aria-expanded','false');
+                link.addClass('current')
+                    .attr('aria-expanded','true');
+                link.closest('li.toctree-l1')
+                    .parent()
+                    .addClass('current')
+                    .attr('aria-expanded','true');
+                for (let i = 1; i <= 10; i++) {
+                    link.closest('li.toctree-l' + i)
+                        .addClass('current')
+                        .attr('aria-expanded','true');
+                }
+
+                // EDIT by joerick
+                console.log('no scroll')
+                // link[0].scrollIntoView();
+            }
+        }
+        catch (err) {
+            console.log("Error expanding nav for anchor", err);
+        }
+
+    };
+
+    nav.onScroll = function () {
+        this.winScroll = false;
+        var newWinPosition = this.win.scrollTop(),
+            winBottom = newWinPosition + this.winHeight,
+            navPosition = this.navBar.scrollTop(),
+            newNavPosition = navPosition + (newWinPosition - this.winPosition);
+        if (newWinPosition < 0 || winBottom > this.docHeight) {
+            return;
+        }
+        this.navBar.scrollTop(newNavPosition);
+        this.winPosition = newWinPosition;
+    };
+
+    nav.onResize = function () {
+        this.winResize = false;
+        this.winHeight = this.win.height();
+        this.docHeight = $(document).height();
+    };
+
+    nav.hashChange = function () {
+        this.linkScroll = true;
+        this.win.one('hashchange', function () {
+            this.linkScroll = false;
+        });
+    };
+
+    nav.toggleCurrent = function (elem) {
+        var parent_li = elem.closest('li');
+        parent_li
+            .siblings('li.current')
+            .removeClass('current')
+            .attr('aria-expanded','false');
+        parent_li
+            .siblings()
+            .find('li.current')
+            .removeClass('current')
+            .attr('aria-expanded','false');
+        var children = parent_li.find('> ul li');
+        // Don't toggle terminal elements.
+        if (children.length) {
+            children
+                .removeClass('current')
+                .attr('aria-expanded','false');
+            parent_li
+                .toggleClass('current')
+                .attr('aria-expanded', function(i, old) {
+                    return old == 'true' ? 'false' : 'true';
+                });
+        }
+    }
+
+    return nav;
+};
+
+const ThemeNavInstance = ThemeNav();
+
+  window.SphinxRtdTheme = {
+      Navigation: ThemeNavInstance,
+      // TODO remove this once static assets are split up between the theme
+      // and Read the Docs. For now, this patches 0.3.0 to be backwards
+      // compatible with a pre-0.3.0 layout.html
+      StickyNav: ThemeNavInstance,
+  };
+
+
+// requestAnimationFrame polyfill by Erik Möller. fixes from Paul Irish and Tino Zijdel
+// https://gist.github.com/paulirish/1579671
+// MIT license
+
+(function() {
+    var lastTime = 0;
+    var vendors = ['ms', 'moz', 'webkit', 'o'];
+    for(var x = 0; x < vendors.length && !window.requestAnimationFrame; ++x) {
+        window.requestAnimationFrame = window[vendors[x]+'RequestAnimationFrame'];
+        window.cancelAnimationFrame = window[vendors[x]+'CancelAnimationFrame']
+                                   || window[vendors[x]+'CancelRequestAnimationFrame'];
+    }
+
+    if (!window.requestAnimationFrame)
+        window.requestAnimationFrame = function(callback, element) {
+            var currTime = new Date().getTime();
+            var timeToCall = Math.max(0, 16 - (currTime - lastTime));
+            var id = window.setTimeout(function() { callback(currTime + timeToCall); },
+              timeToCall);
+            lastTime = currTime + timeToCall;
+            return id;
+        };
+
+    if (!window.cancelAnimationFrame)
+        window.cancelAnimationFrame = function(id) {
+            clearTimeout(id);
+        };
+}());
@@ -26,12 +26,12 @@ title: Working examples
 | [duckdb][]                        | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | DuckDB is an in-process SQL OLAP Database Management System |
 | [Apache Beam][]                   | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Apache Beam is a unified programming model for Batch and Streaming data processing. |
 | [asyncpg][]                       | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | A fast PostgreSQL Database Client Library for Python/asyncio. |
-| [PyGame][]                        | ![github icon][] | ![apple icon][] ![linux icon][] | pygame (the library) is a Free and Open Source python programming language library for making multimedia applications like games built on top of the excellent SDL library. C, Python, Native, OpenGL. |
-| [scikit-image][]                  | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Image processing library. Uses cibuildwheel to build and test a project that uses Cython with platform-native code.  |
+| [PyGame][]                        | ![github icon][] | ![apple icon][] ![linux icon][] | 🐍🎮 pygame (the library) is a Free and Open Source python programming language library for making multimedia applications like games built on top of the excellent SDL library. C, Python, Native, OpenGL. |
 | [cmake][]                         | ![github icon][] ![travisci icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Multitagged binary builds for all supported platforms, using cibw 2 config configuration. |
+| [scikit-image][]                  | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Image processing library. Uses cibuildwheel to build and test a project that uses Cython with platform-native code.  |
 | [twisted-iocpsupport][]           | ![github icon][] | ![windows icon][] | A submodule of Twisted that hooks into native C APIs using Cython. |
-| [websockets][]                    | ![travisci icon][] | ![apple icon][] ![linux icon][] | Library for building WebSocket servers and clients. Mostly written in Python, with a small C 'speedups' extension module.  |
 | [PyOxidizer][]                    | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | A modern Python application packaging and distribution tool |
+| [websockets][]                    | ![travisci icon][] | ![apple icon][] ![linux icon][] | Library for building WebSocket servers and clients. Mostly written in Python, with a small C 'speedups' extension module.  |
 | [cvxpy][]                         | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | A Python-embedded modeling language for convex optimization problems. |
 | [Triton][]                        | ![github icon][] | ![linux icon][] | Self hosted runners |
 | [UltraJSON][]                     | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Ultra fast JSON decoder and encoder written in C with Python bindings |
@@ -39,9 +39,9 @@ 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. |
-| [vispy][]                         | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Main repository for Vispy |
 | [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` |
+| [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 |
 | [coverage.py][]                   | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | The coverage tool for Python |
@@ -53,14 +53,15 @@ title: Working examples
 | [PyAV][]                          | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Pythonic bindings for FFmpeg's libraries. |
 | [SimpleJSON][]                    | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | simplejson is a simple, fast, extensible JSON encoder/decoder for Python  |
 | [pikepdf][]                       | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A Python library for reading and writing PDF, powered by qpdf |
-| [OpenColorIO][]                   | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | A color management framework for visual effects and animation. |
 | [Line Profiler][]                 | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Line-by-line profiling for Python |
+| [OpenColorIO][]                   | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | A color management framework for visual effects and animation. |
 | [PyTables][]                      | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A Python package to manage extremely large amounts of data |
 | [OpenTimelineIO][]                | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Open Source API and interchange format for editorial timeline information. |
 | [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. |
-| [DeepForest][]                    | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | An Efficient, Scalable and Optimized Python Framework for Deep Forest (2021.2.1) |
+| [envd][]                          | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | 🏕️ Development environment for AI/ML, based on buildkit |
 | [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 |
 | [Parselmouth][]                   | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A Python interface to the Praat software package, using pybind11, C++17 and CMake, with the core Praat static library built only once and shared between wheels. |
 | [AutoPy][]                        | ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Includes a Windows Travis build. |
@@ -72,21 +73,22 @@ title: Working examples
 | [pybind11 cmake_example][]        | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Example pybind11 module built with a CMake-based build system |
 | [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. |
-| [dd-trace-py][]                   | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Uses custom alternate arch emulation on GitHub |
 | [pybind11 python_example][]       | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Example pybind11 module built with a Python-based build system |
+| [dd-trace-py][]                   | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Uses custom alternate arch emulation on GitHub |
+| [CTranslate2][]                   | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Includes libraries from the [Intel oneAPI toolkit](https://www.intel.com/content/www/us/en/developer/tools/oneapi/base-toolkit.html) and CUDA kernels compiled for multiple GPU architectures. |
 | [time-machine][]                  | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Time mocking library using only the CPython C API. |
 | [sourmash][]                      | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Quickly search, compare, and analyze genomic and metagenomic data sets. |
-| [CTranslate2][]                   | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Includes libraries from the [Intel oneAPI toolkit](https://www.intel.com/content/www/us/en/developer/tools/oneapi/base-toolkit.html) and CUDA kernels compiled for multiple GPU architectures. |
 | [cyvcf2][]                        | ![github icon][] | ![apple icon][] ![linux icon][] | cython + htslib == fast VCF and BCF processing |
-| [abess][]                         | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A fast best-subset selection library. It uses cibuildwheel to build a large project with C++ extensions. |
 | [matrixprofile][]                 | ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A Python 3 library making time series data mining tasks, utilizing matrix profile algorithms, accessible to everyone. |
+| [abess][]                         | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A fast best-subset selection library. It uses cibuildwheel to build a large project with C++ extensions. |
 | [jq.py][]                         | ![travisci icon][] | ![apple icon][] ![linux icon][] | Python bindings for jq |
 | [iminuit][]                       | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Jupyter-friendly Python interface for C++ MINUIT2 |
 | [Tokenizer][]                     | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Fast and customizable text tokenization library with BPE and SentencePiece support |
 | [PyGLM][]                         | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Fast OpenGL Mathematics (GLM) for Python |
-| [boost-histogram][]               | ![github icon][] ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Supports full range of wheels, including PyPy and alternate archs. |
 | [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 |
@@ -100,14 +102,15 @@ title: Working examples
 | [power-grid-model][]              | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Python/C++ library for distribution power system analysis |
 | [clang-format][]                  | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | Scikit-build wrapper around LLVM's CMake, all platforms, generic wheels. |
 | [numpythia][]                     | ![github icon][] | ![apple icon][] ![linux icon][] | The interface between PYTHIA and NumPy |
-| [pyjet][]                         | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | The interface between FastJet and NumPy |
 | [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. |
 | [SiPM][]                          | ![github icon][] | ![apple icon][] ![linux icon][] | High performance library for SiPM detectors simulation using C++17, OpenMP and AVX2 intrinsics. |
+| [ril][]                           | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | A python binding to Rust Imaging library using maturin and Pyo3, utilizes Github Action cache to improve speed. Builds abi3 wheels. |

 [scikit-learn]: https://github.com/scikit-learn/scikit-learn
 [NumPy]: https://github.com/numpy/numpy
@@ -128,11 +131,11 @@ title: Working examples
 [Apache Beam]: https://github.com/apache/beam
 [asyncpg]: https://github.com/MagicStack/asyncpg
 [PyGame]: https://github.com/pygame/pygame
-[scikit-image]: https://github.com/scikit-image/scikit-image
 [cmake]: https://github.com/scikit-build/cmake-python-distributions
+[scikit-image]: https://github.com/scikit-image/scikit-image
 [twisted-iocpsupport]: https://github.com/twisted/twisted-iocpsupport
-[websockets]: https://github.com/aaugustin/websockets
 [PyOxidizer]: https://github.com/indygreg/PyOxidizer
+[websockets]: https://github.com/aaugustin/websockets
 [cvxpy]: https://github.com/cvxpy/cvxpy
 [Triton]: https://github.com/openai/triton
 [UltraJSON]: https://github.com/ultrajson/ultrajson
@@ -140,9 +143,9 @@ title: Working examples
 [OpenSpiel]: https://github.com/deepmind/open_spiel
 [pyzmq]: https://github.com/zeromq/pyzmq
 [aiortc]: https://github.com/aiortc/aiortc
-[vispy]: https://github.com/vispy/vispy
 [Implicit]: https://github.com/benfred/implicit
 [Confluent client for Kafka]: https://github.com/confluentinc/confluent-kafka-python
+[vispy]: https://github.com/vispy/vispy
 [tinyobjloader]: https://github.com/tinyobjloader/tinyobjloader
 [Dependency Injector]: https://github.com/ets-labs/python-dependency-injector
 [coverage.py]: https://github.com/nedbat/coveragepy
@@ -154,14 +157,15 @@ title: Working examples
 [PyAV]: https://github.com/PyAV-Org/PyAV
 [SimpleJSON]: https://github.com/simplejson/simplejson
 [pikepdf]: https://github.com/pikepdf/pikepdf
-[OpenColorIO]: https://github.com/AcademySoftwareFoundation/OpenColorIO
 [Line Profiler]: https://github.com/pyutils/line_profiler
+[OpenColorIO]: https://github.com/AcademySoftwareFoundation/OpenColorIO
 [PyTables]: https://github.com/PyTables/PyTables
 [OpenTimelineIO]: https://github.com/PixarAnimationStudios/OpenTimelineIO
 [aioquic]: https://github.com/aiortc/aioquic
 [ruptures]: https://github.com/deepcharles/ruptures
-[DeepForest]: https://github.com/LAMDA-NJU/Deep-Forest
+[envd]: https://github.com/tensorchord/envd
 [Psycopg 3]: https://github.com/psycopg/psycopg
+[DeepForest]: https://github.com/LAMDA-NJU/Deep-Forest
 [google neuroglancer]: https://github.com/google/neuroglancer
 [Parselmouth]: https://github.com/YannickJadoul/Parselmouth
 [AutoPy]: https://github.com/autopilot-rs/autopy
@@ -173,21 +177,22 @@ title: Working examples
 [pybind11 cmake_example]: https://github.com/pybind/cmake_example
 [KDEpy]: https://github.com/tommyod/KDEpy
 [tgcalls]: https://github.com/MarshalX/tgcalls
-[dd-trace-py]: https://github.com/DataDog/dd-trace-py
 [pybind11 python_example]: https://github.com/pybind/python_example
+[dd-trace-py]: https://github.com/DataDog/dd-trace-py
+[CTranslate2]: https://github.com/OpenNMT/CTranslate2
 [time-machine]: https://github.com/adamchainz/time-machine
 [sourmash]: https://github.com/dib-lab/sourmash
-[CTranslate2]: https://github.com/OpenNMT/CTranslate2
 [cyvcf2]: https://github.com/brentp/cyvcf2
-[abess]: https://github.com/abess-team/abess
 [matrixprofile]: https://github.com/matrix-profile-foundation/matrixprofile
+[abess]: https://github.com/abess-team/abess
 [jq.py]: https://github.com/mwilliamson/jq.py
 [iminuit]: https://github.com/scikit-hep/iminuit
 [Tokenizer]: https://github.com/OpenNMT/Tokenizer
 [PyGLM]: https://github.com/Zuzu-Typ/PyGLM
-[boost-histogram]: https://github.com/scikit-hep/boost-histogram
 [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
@@ -201,14 +206,15 @@ title: Working examples
 [power-grid-model]: https://github.com/alliander-opensource/power-grid-model
 [clang-format]: https://github.com/ssciwr/clang-format-wheel
 [numpythia]: https://github.com/scikit-hep/numpythia
-[pyjet]: https://github.com/scikit-hep/pyjet
 [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
 [SiPM]: https://github.com/EdoPro98/SimSiPM
+[ril]: https://github.com/Cryptex-github/ril-py

 [appveyor icon]: data/readme_icons/appveyor.svg
 [github icon]: data/readme_icons/github.svg
@@ -216,110 +222,114 @@ title: Working examples
 [circleci icon]: data/readme_icons/circleci.svg
 [gitlab icon]: data/readme_icons/gitlab.svg
 [travisci icon]: data/readme_icons/travisci.svg
+[cirrusci icon]: data/readme_icons/cirrusci.svg
 [windows icon]: data/readme_icons/windows.svg
 [apple icon]: data/readme_icons/apple.svg
 [linux icon]: data/readme_icons/linux.svg

-<!-- scikit-learn: 51026, last pushed 0 days ago -->
-<!-- NumPy: 21131, last pushed 0 days ago -->
-<!-- Tornado: 20669, last pushed 9 days ago -->
-<!-- pytorch-fairseq: 18851, last pushed 0 days ago -->
-<!-- Matplotlib: 15939, last pushed 0 days ago -->
-<!-- NCNN: 15158, last pushed 0 days ago -->
-<!-- Kivy: 14873, last pushed 0 days ago -->
-<!-- Prophet: 14779, last pushed 4 days ago -->
-<!-- MyPy: 13581, last pushed 0 days ago -->
-<!-- pydantic: 10706, last pushed 0 days ago -->
-<!-- MemRay: 8980, last pushed 0 days ago -->
-<!-- uvloop: 8778, last pushed 3 days ago -->
-<!-- psutil: 8593, last pushed 7 days ago -->
-<!-- vaex: 7216, last pushed 1 days ago -->
-<!-- Google Benchmark: 6724, last pushed 0 days ago -->
-<!-- duckdb: 5814, last pushed 0 days ago -->
-<!-- Apache Beam: 5766, last pushed 0 days ago -->
-<!-- asyncpg: 5591, last pushed 6 days ago -->
-<!-- PyGame: 5104, last pushed 0 days ago -->
-<!-- scikit-image: 5010, last pushed 1 days ago -->
-<!-- cmake: 4975, last pushed 0 days ago -->
-<!-- twisted-iocpsupport: 4697, last pushed 1 days ago -->
-<!-- websockets: 4103, last pushed 0 days ago -->
-<!-- PyOxidizer: 4064, last pushed 0 days ago -->
-<!-- cvxpy: 4038, last pushed 0 days ago -->
-<!-- Triton: 3860, last pushed 0 days ago -->
-<!-- UltraJSON: 3784, last pushed 1 days ago -->
-<!-- River: 3517, last pushed 2 days ago -->
-<!-- OpenSpiel: 3275, last pushed 0 days ago -->
-<!-- pyzmq: 3138, last pushed 1 days ago -->
-<!-- aiortc: 3032, last pushed 46 days ago -->
-<!-- vispy: 2913, last pushed 4 days ago -->
-<!-- Implicit: 2906, last pushed 0 days ago -->
-<!-- Confluent client for Kafka: 2885, last pushed 6 days ago -->
-<!-- tinyobjloader: 2606, last pushed 36 days ago -->
-<!-- Dependency Injector: 2277, last pushed 6 days ago -->
-<!-- coverage.py: 2136, last pushed 3 days ago -->
-<!-- PyCryptodome: 2085, last pushed 7 days ago -->
-<!-- PyYAML: 1897, last pushed 24 days ago -->
-<!-- numexpr: 1793, last pushed 21 days ago -->
-<!-- h5py: 1762, last pushed 8 days ago -->
-<!-- Wrapt: 1716, last pushed 100 days ago -->
-<!-- PyAV: 1626, last pushed 15 days ago -->
-<!-- SimpleJSON: 1507, last pushed 40 days ago -->
-<!-- pikepdf: 1449, last pushed 1 days ago -->
-<!-- OpenColorIO: 1351, last pushed 29 days ago -->
-<!-- Line Profiler: 1310, last pushed 18 days ago -->
-<!-- PyTables: 1142, last pushed 113 days ago -->
-<!-- OpenTimelineIO: 1083, last pushed 0 days ago -->
-<!-- aioquic: 1012, last pushed 23 days ago -->
-<!-- ruptures: 1011, last pushed 34 days ago -->
-<!-- DeepForest: 768, last pushed 88 days ago -->
-<!-- Psycopg 3: 750, last pushed 1 days ago -->
-<!-- google neuroglancer: 744, last pushed 0 days ago -->
-<!-- Parselmouth: 673, last pushed 31 days ago -->
-<!-- AutoPy: 666, last pushed 228 days ago -->
-<!-- H3-py: 552, last pushed 0 days ago -->
-<!-- Rtree: 497, last pushed 113 days ago -->
-<!-- markupsafe: 487, last pushed 8 days ago -->
-<!-- python-rapidjson: 456, last pushed 21 days ago -->
-<!-- python-snappy: 443, last pushed 147 days ago -->
-<!-- pybind11 cmake_example: 426, last pushed 12 days ago -->
-<!-- KDEpy: 394, last pushed 181 days ago -->
-<!-- tgcalls: 382, last pushed 39 days ago -->
-<!-- dd-trace-py: 350, last pushed 0 days ago -->
-<!-- pybind11 python_example: 349, last pushed 9 days ago -->
-<!-- time-machine: 317, last pushed 1 days ago -->
-<!-- sourmash: 317, last pushed 0 days ago -->
-<!-- CTranslate2: 315, last pushed 5 days ago -->
-<!-- cyvcf2: 300, last pushed 6 days ago -->
-<!-- abess: 275, last pushed 1 days ago -->
-<!-- matrixprofile: 275, last pushed 37 days ago -->
-<!-- jq.py: 223, last pushed 185 days ago -->
-<!-- iminuit: 209, last pushed 1 days ago -->
+<!-- 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: 148, last pushed 134 days ago -->
-<!-- boost-histogram: 115, last pushed 1 days ago -->
-<!-- bx-python: 114, last pushed 217 days ago -->
-<!-- TgCrypto: 110, last pushed 159 days ago -->
-<!-- iDynTree: 109, last pushed 3 days ago -->
-<!-- Python-WebRTC: 92, last pushed 152 days ago -->
-<!-- pybase64: 85, last pushed 1 days ago -->
-<!-- Arbor: 77, last pushed 0 days ago -->
-<!-- fathon: 65, last pushed 69 days ago -->
-<!-- etebase-py: 58, last pushed 34 days ago -->
-<!-- polaroid: 51, last pushed 90 days ago -->
-<!-- cf-units: 49, last pushed 1 days ago -->
-<!-- Imagecodecs (fork): 47, last pushed 1 days ago -->
-<!-- pillow-heif: 44, last pushed 0 days ago -->
-<!-- power-grid-model: 42, last pushed 1 days ago -->
-<!-- clang-format: 41, last pushed 8 days ago -->
-<!-- numpythia: 34, last pushed 7 days ago -->
-<!-- pyjet: 33, last pushed 7 days ago -->
-<!-- pybind11 scikit_build_example: 31, last pushed 9 days ago -->
-<!-- ninja: 24, last pushed 1 days ago -->
-<!-- GSD: 19, last pushed 9 days ago -->
-<!-- pyinstrument_cext: 10, last pushed 306 days ago -->
-<!-- CorrectionLib: 10, last pushed 0 days ago -->
-<!-- xmlstarlet: 9, last pushed 9 days ago -->
-<!-- SiPM: 7, last pushed 70 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 -->
+<!-- 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 -->
+<!-- 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 -->

 <!-- 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.9.0
+install: python -m pip install cibuildwheel==2.10.2

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

@@ -6,7 +6,7 @@ jobs:
    - bash: |
        set -o errexit
        python3 -m pip install --upgrade pip
-        pip3 install cibuildwheel==2.9.0
+        pip3 install cibuildwheel==2.10.2
      displayName: Install dependencies
    - bash: cibuildwheel --output-dir wheelhouse .
      displayName: Build wheels
@@ -20,7 +20,7 @@ jobs:
    - bash: |
        set -o errexit
        python3 -m pip install --upgrade pip
-        python3 -m pip install cibuildwheel==2.9.0
+        python3 -m pip install cibuildwheel==2.10.2
      displayName: Install dependencies
    - bash: cibuildwheel --output-dir wheelhouse .
      displayName: Build wheels
@@ -34,7 +34,7 @@ jobs:
    - bash: |
        set -o errexit
        python -m pip install --upgrade pip
-        pip install cibuildwheel==2.9.0
+        pip install cibuildwheel==2.10.2
      displayName: Install dependencies
    - bash: cibuildwheel --output-dir wheelhouse .
      displayName: Build wheels
@@ -11,7 +11,7 @@ jobs:
      - run:
          name: Build the Linux wheels.
          command: |
-            pip3 install --user cibuildwheel==2.9.0
+            pip3 install --user cibuildwheel==2.10.2
            cibuildwheel --output-dir wheelhouse
      - store_artifacts:
          path: wheelhouse/
@@ -25,7 +25,7 @@ jobs:
      - run:
          name: Build the OS X wheels.
          command: |
-            pip3 install cibuildwheel==2.9.0
+            pip3 install cibuildwheel==2.10.2
            cibuildwheel --output-dir wheelhouse
      - store_artifacts:
          path: wheelhouse/
@@ -0,0 +1,21 @@
+build_and_store_wheels: &BUILD_AND_STORE_WHEELS
+  install_cibuildwheel_script:
+    - python -m pip install cibuildwheel==2.10.2
+  run_cibuildwheel_script:
+    - cibuildwheel
+  wheels_artifacts:
+    path: "wheelhouse/*"
+
+
+macos_task:
+  name: Build macOS x86_64 and arm64 wheels.
+  macos_instance:
+    image: ghcr.io/cirruslabs/macos-monterey-xcode
+
+  env:
+    PATH: /opt/homebrew/opt/python@3.10/bin:$PATH
+    CIBW_ARCHS_MACOS: x86_64 arm64
+  install_pre_requirements_script:
+    - brew install python@3.10
+    - ln -s python3 /opt/homebrew/opt/python@3.10/bin/python
+  <<: *BUILD_AND_STORE_WHEELS
@@ -0,0 +1,60 @@
+build_and_store_wheels: &BUILD_AND_STORE_WHEELS
+  install_cibuildwheel_script:
+    - python -m pip install cibuildwheel==2.10.2
+  run_cibuildwheel_script:
+    - cibuildwheel
+  wheels_artifacts:
+    path: "wheelhouse/*"
+
+
+linux_x86_task:
+  name: Build Linux x86 wheels.
+  compute_engine_instance:
+    image_project: cirrus-images
+    image: family/docker-builder
+    platform: linux
+    cpu: 4
+    memory: 4G
+
+  install_pre_requirements_script:
+    - apt install -y python3-venv python-is-python3
+  <<: *BUILD_AND_STORE_WHEELS
+
+linux_aarch64_task:
+  name: Build Linux aarch64 wheels.
+  compute_engine_instance:
+    image_project: cirrus-images
+    image: family/docker-builder-arm64
+    architecture: arm64
+    platform: linux
+    cpu: 4
+    memory: 4G
+
+  install_pre_requirements_script:
+    - apt install -y python3-venv python-is-python3
+  <<: *BUILD_AND_STORE_WHEELS
+
+windows_x86_task:
+  name: Build Windows x86 wheels.
+  windows_container:
+    image: cirrusci/windowsservercore:visualstudio2022
+    cpu: 4
+    memory: 4G
+
+  install_pre_requirements_script:
+    - choco install -y --no-progress python3 --version 3.10.6
+    - refreshenv
+    - echo PATH=%PATH% >> "%CIRRUS_ENV%"
+  <<: *BUILD_AND_STORE_WHEELS
+
+macos_arm64_task:
+  name: Build macOS arm64 wheels.
+  macos_instance:
+    image: ghcr.io/cirruslabs/macos-monterey-xcode
+
+  env:
+    PATH: /opt/homebrew/opt/python@3.10/bin:$PATH
+  install_pre_requirements_script:
+    - brew install python@3.10
+    - ln -s python3 /opt/homebrew/opt/python@3.10/bin/python
+  <<: *BUILD_AND_STORE_WHEELS
@@ -10,7 +10,7 @@ jobs:
      - uses: actions/checkout@v3

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

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

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

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

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

      - name: Build wheels
-        uses: pypa/cibuildwheel@v2.9.0
+        uses: pypa/cibuildwheel@v2.10.2
        env:
          # configure cibuildwheel to build native archs ('auto'), and some
          # emulated ones
@@ -12,7 +12,7 @@ linux:
    DOCKER_TLS_CERTDIR: ""
  script:
    - curl -sSL https://get.docker.com/ | sh
-    - python -m pip install cibuildwheel==2.9.0
+    - python -m pip install cibuildwheel==2.10.2
    - cibuildwheel --output-dir wheelhouse
  artifacts:
    paths:
@@ -19,7 +19,7 @@ jobs:
        - ln -s /c/Python38/python.exe /c/Python38/python3.exe

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

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

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

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

@@ -5,6 +5,9 @@ theme:
  highlightjs: true
  hljs_languages:
      - yaml
+  collapse_navigation: false
+  navigation_depth: 3
+  custom_dir: docs/theme_overrides
 repo_url: https://github.com/pypa/cibuildwheel
 edit_uri: edit/main/docs/

@@ -14,6 +17,7 @@ extra_css:
 extra_javascript:
  - extra.js

+
 nav:
  - Home: index.md
  - setup.md
@@ -66,8 +66,8 @@ module = [
    "setuptools",
    "pytest", # ignored in pre-commit to speed up check
    "bashlex",
+    "bashlex.*",
    "importlib_resources",
-    "ghapi.*",
 ]
 ignore_missing_imports = true

@@ -1,6 +1,6 @@
 [metadata]
 name = cibuildwheel
-version = 2.9.0
+version = 2.10.2
 description = Build Python wheels on CI with minimal configuration.
 long_description = file: README.md
 long_description_content_type = text/markdown
@@ -37,7 +37,7 @@ install_requires =
    packaging>=20.9
    platformdirs
    tomli;python_version < '3.11'
-    typing-extensions>=3.10.0.0;python_version < '3.8'
+    typing-extensions>=4.1.0;python_version < '3.11'
 python_requires = >=3.7
 include_package_data = True
 zip_safe = False
@@ -5,11 +5,10 @@ from setuptools import setup
 extras = {
    "docs": [
        "mkdocs-include-markdown-plugin==2.8.0",
-        "mkdocs==1.0.4",  # Doesn't support Python 3.10+
-        "jinja2==3.0.3",
+        "mkdocs==1.3.1",
+        "jinja2>=3.1.2",
        "pymdown-extensions",
        "mkdocs-macros-plugin",
-        "markdown<3.4",  # Breaks mkdocs 1.0.4
    ],
    "test": [
        "jinja2",
@@ -21,7 +20,6 @@ extras = {
    ],
    "bin": [
        "click",
-        "ghapi",
        "pip-tools",
        "pygithub",
        "pyyaml",
@@ -47,6 +45,4 @@ extras["dev"] = [
    *extras["bin"],
 ]

-extras["all"] = sum(extras.values(), [])
-
 setup(extras_require=extras)
@@ -1,5 +1,6 @@
 from __future__ import annotations

+import platform
 import re
 import textwrap

@@ -60,6 +61,8 @@ def test_pinned_versions(tmp_path, python_version, build_frontend_env):
    build_environment = {}

    if python_version == "3.6":
+        if utils.platform == "macos" and platform.machine() == "arm64":
+            pytest.skip("macOS arm64 does not support Python 3.6")
        constraint_filename = "constraints-python36.txt"
        build_pattern = "[cp]p36-*"
    elif python_version == "3.7":
@@ -105,7 +108,8 @@ def test_pinned_versions(tmp_path, python_version, build_frontend_env):
            w for w in utils.expected_wheels("spam", "0.1.0") if "-cp39" in w or "-pp39" in w
        ]
    else:
-        raise ValueError("unhandled python version")
+        msg = "unhandled python version"
+        raise ValueError(msg)

    assert set(actual_wheels) == set(expected_wheels)

@@ -120,7 +124,7 @@ def test_dependency_constraints_file(tmp_path, build_frontend_env):
    tool_versions = {
        "pip": "20.0.2",
        "setuptools": "53.0.0",
-        "wheel": "0.34.2",
+        "wheel": "0.36.2",
        "virtualenv": "20.11.2",
    }

@@ -59,8 +59,6 @@ def test(manylinux_image, tmp_path):
    elif platform.machine() not in ["x86_64", "i686"]:
        if manylinux_image in ["manylinux1", "manylinux2010"]:
            pytest.skip("manylinux1 and 2010 doesn't exist for non-x86 architectures")
-        elif manylinux_image == "manylinux_2_28" and platform.machine() == "s390x":
-            pytest.skip("manylinux_2_28 doesn't exist for s390x architecture")
    elif manylinux_image == "manylinux_2_28" and platform.machine() == "i686":
        pytest.skip("manylinux_2_28 doesn't exist for i686 architecture")

@@ -51,13 +51,13 @@ def test(capfd, tmp_path):
        add_env={
            "CIBW_BEFORE_BUILD": "python {project}/bin/before_build.py",
            "CIBW_TEST_COMMAND": "python {package}/test/run_tests.py",
-            # this shouldn't depend on the version of python, so build only CPython 3.6
-            "CIBW_BUILD": "cp36-*",
+            # this shouldn't depend on the version of python, so build only CPython 3.10
+            "CIBW_BUILD": "cp310-*",
        },
    )

    # check that the expected wheels are produced
-    expected_wheels = [w for w in utils.expected_wheels("spam", "0.1.0") if "cp36" in w]
+    expected_wheels = [w for w in utils.expected_wheels("spam", "0.1.0") if "cp310" in w]
    assert set(actual_wheels) == set(expected_wheels)

    captured = capfd.readouterr()
@@ -142,6 +142,11 @@ def test_failing_test(tmp_path):
                # problems with this, so let's check that.
                "CIBW_MANYLINUX_I686_IMAGE": "manylinux1",
                "CIBW_MANYLINUX_X86_64_IMAGE": "manylinux1",
+                # CPython 3.8 when running on macOS arm64 is unusual. The build
+                # always runs in x86_64, so the arm64 tests are not run. See
+                # #1169 for reasons why. That means the build succeeds, which
+                # we don't want. So we skip that build.
+                "CIBW_SKIP": "cp38-macosx_arm64",
            },
        )

@@ -23,7 +23,8 @@ elif sys.platform.startswith("darwin"):
 elif sys.platform in ["win32", "cygwin"]:
    platform = "windows"
 else:
-    raise Exception("Unsupported platform")
+    msg = f"Unsupported platform {sys.platform!r}"
+    raise Exception(msg)


 def cibuildwheel_get_build_identifiers(project_path, env=None, *, prerelease_pythons=False):
@@ -210,7 +211,8 @@ def expected_wheels(
                )

        else:
-            raise Exception("unsupported platform")
+            msg = f"Unsupported platform {platform!r}"
+            raise Exception(msg)

        for platform_tag in platform_tags:
            wheels.append(f"{package_name}-{package_version}-{python_abi_tag}-{platform_tag}.whl")
@@ -0,0 +1,82 @@
+from __future__ import annotations
+
+import platform as platform_module
+import sys
+
+import pytest
+
+from cibuildwheel.architecture import Architecture
+
+
+@pytest.fixture(
+    params=[
+        pytest.param(("linux", "linux", "x86_64", "64"), id="linux-64"),
+        pytest.param(("linux", "linux", "i686", "32"), id="linux-32"),
+        pytest.param(("linux", "linux", "aarch64", "arm"), id="linux-arm"),
+        pytest.param(("macos", "darwin", "x86_64", "64"), id="macos-64"),
+        pytest.param(("macos", "darwin", "arm64", "arm"), id="macos-arm"),
+        pytest.param(("windows", "win32", "x86", "32"), id="windows-32"),
+        pytest.param(("windows", "win32", "AMD64", "64"), id="windows-64"),
+        pytest.param(("windows", "win32", "ARM64", "arm"), id="windows-arm"),
+    ]
+)
+def platform_machine(request, monkeypatch):
+    platform_name, platform_value, machine_value, machine_name = request.param
+    monkeypatch.setattr(sys, "platform", platform_value)
+    monkeypatch.setattr(platform_module, "machine", lambda: machine_value)
+    return platform_name, machine_name
+
+
+def test_arch_auto(platform_machine):
+    platform_name, machine_name = platform_machine
+
+    arch_set = Architecture.auto_archs("linux")
+    expected = {
+        "32": {Architecture.i686},
+        "64": {Architecture.x86_64, Architecture.i686},
+        "arm": {Architecture.aarch64},
+    }
+    assert arch_set == expected[machine_name]
+
+    arch_set = Architecture.auto_archs("macos")
+    expected = {"32": set(), "64": {Architecture.x86_64}, "arm": {Architecture.arm64}}
+    assert arch_set == expected[machine_name]
+
+    arch_set = Architecture.auto_archs("windows")
+    expected = {
+        "32": {Architecture.x86},
+        "64": {Architecture.AMD64, Architecture.x86},
+        "arm": {Architecture.ARM64},
+    }
+    assert arch_set == expected[machine_name]
+
+
+def test_arch_auto64(platform_machine):
+    platform_name, machine_name = platform_machine
+
+    arch_set = Architecture.parse_config("auto64", "linux")
+    expected = {"32": set(), "64": {Architecture.x86_64}, "arm": {Architecture.aarch64}}
+    assert arch_set == expected[machine_name]
+
+    arch_set = Architecture.parse_config("auto64", "macos")
+    expected = {"32": set(), "64": {Architecture.x86_64}, "arm": {Architecture.arm64}}
+    assert arch_set == expected[machine_name]
+
+    arch_set = Architecture.parse_config("auto64", "windows")
+    expected = {"32": set(), "64": {Architecture.AMD64}, "arm": {Architecture.ARM64}}
+    assert arch_set == expected[machine_name]
+
+
+def test_arch_auto32(platform_machine):
+    platform_name, machine_name = platform_machine
+
+    arch_set = Architecture.parse_config("auto32", "linux")
+    expected = {"32": {Architecture.i686}, "64": {Architecture.i686}, "arm": set()}
+    assert arch_set == expected[machine_name]
+
+    arch_set = Architecture.parse_config("auto32", "macos")
+    assert arch_set == set()
+
+    arch_set = Architecture.parse_config("auto32", "windows")
+    expected = {"32": {Architecture.x86}, "64": {Architecture.x86}, "arm": set()}
+    assert arch_set == expected[machine_name]
@@ -12,7 +12,13 @@ from cibuildwheel import linux, macos, util, windows


 class ArgsInterceptor:
+    def __init__(self):
+        self.call_count = 0
+        self.args = None
+        self.kwargs = None
+
    def __call__(self, *args, **kwargs):
+        self.call_count += 1
        self.args = args
        self.kwargs = kwargs

@@ -25,7 +31,8 @@ def mock_protection(monkeypatch):
    """

    def fail_on_call(*args, **kwargs):
-        raise RuntimeError("This should never be called")
+        msg = "This should never be called"
+        raise RuntimeError(msg)

    def ignore_call(*args, **kwargs):
        pass
@@ -75,16 +82,14 @@ def platform(request, monkeypatch):


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

-    if platform == "linux":
-        monkeypatch.setattr(linux, "build", intercepted)
-    elif platform == "macos":
-        monkeypatch.setattr(macos, "build", intercepted)
-    elif platform == "windows":
-        monkeypatch.setattr(windows, "build", intercepted)
-    else:
-        raise ValueError(f"unknown platform value: {platform}")
+    monkeypatch.setattr(linux, "build", intercepted)
+    monkeypatch.setattr(macos, "build", intercepted)
+    monkeypatch.setattr(windows, "build", intercepted)

-    return intercepted
+    yield intercepted
+
+    # check that intercepted_build_args only ever had one set of args
+    assert intercepted.call_count <= 1
@@ -14,7 +14,7 @@ else:
 from cibuildwheel.__main__ import main
 from cibuildwheel.environment import ParsedEnvironment
 from cibuildwheel.options import BuildOptions, _get_pinned_container_images
-from cibuildwheel.util import BuildSelector, resources_dir
+from cibuildwheel.util import BuildSelector, resources_dir, split_config_settings

 # CIBW_PLATFORM is tested in main_platform_test.py

@@ -126,7 +126,8 @@ def get_default_repair_command(platform):
    elif platform == "windows":
        return ""
    else:
-        raise ValueError("Unknown platform", platform)
+        msg = f"Unknown platform: {platform!r}"
+        raise ValueError(msg)


@pytest.mark.parametrize("repair_command", [None, "repair", "repair -w {dest_dir} {wheel}"])
@@ -263,6 +264,27 @@ def test_build_verbosity(
    assert build_options.build_verbosity == expected_verbosity


+@pytest.mark.parametrize("platform_specific", [False, True])
+def test_config_settings(platform_specific, platform, intercepted_build_args, monkeypatch):
+    config_settings = 'setting=value setting=value2 other="something else"'
+    if platform_specific:
+        monkeypatch.setenv("CIBW_CONFIG_SETTINGS_" + platform.upper(), config_settings)
+        monkeypatch.setenv("CIBW_CONFIG_SETTIGNS", "a=b")
+    else:
+        monkeypatch.setenv("CIBW_CONFIG_SETTINGS", config_settings)
+
+    main()
+    build_options = intercepted_build_args.args[0].build_options(identifier=None)
+
+    assert build_options.config_settings == config_settings
+
+    assert split_config_settings(config_settings) == [
+        "--config-setting=setting=value",
+        "--config-setting=setting=value2",
+        "--config-setting=other=something else",
+    ]
+
+
@pytest.mark.parametrize(
    "selector",
    [
@@ -19,6 +19,7 @@ def test_unknown_platform_non_ci(monkeypatch, capsys):
    monkeypatch.delenv("GITHUB_ACTIONS", raising=False)
    monkeypatch.delenv("GITLAB_CI", raising=False)
    monkeypatch.delenv("CIRCLECI", raising=False)
+    monkeypatch.delenv("CIRRUS_CI", raising=False)
    monkeypatch.delenv("CIBW_PLATFORM", raising=False)

    with pytest.raises(SystemExit) as exit:
@@ -191,3 +192,74 @@ def test_archs_platform_all(platform, intercepted_build_args, monkeypatch):
            Architecture.arm64,
            Architecture.universal2,
        }
+
+
+@pytest.mark.parametrize(
+    "only,plat",
+    (
+        ("cp311-manylinux_x86_64", "linux"),
+        ("cp310-win_amd64", "windows"),
+        ("cp310-win32", "windows"),
+        ("cp311-macosx_x86_64", "macos"),
+    ),
+)
+def test_only_argument(intercepted_build_args, monkeypatch, only, plat):
+    monkeypatch.setenv("CIBW_BUILD", "unused")
+    monkeypatch.setenv("CIBW_SKIP", "unused")
+    monkeypatch.setattr(sys, "argv", sys.argv + ["--only", only])
+
+    main()
+
+    options = intercepted_build_args.args[0]
+    assert options.globals.build_selector.build_config == only
+    assert options.globals.build_selector.skip_config == ""
+    assert options.platform == plat
+    assert options.globals.architectures == Architecture.all_archs(plat)
+
+
+@pytest.mark.parametrize("only", ("cp311-manylxinux_x86_64", "some_linux_thing"))
+def test_only_failed(monkeypatch, only):
+    monkeypatch.setattr(sys, "argv", sys.argv + ["--only", only])
+
+    with pytest.raises(SystemExit):
+        main()
+
+
+def test_only_no_platform(monkeypatch):
+    monkeypatch.setattr(
+        sys, "argv", sys.argv + ["--only", "cp311-manylinux_x86_64", "--platform", "macos"]
+    )
+
+    with pytest.raises(SystemExit):
+        main()
+
+
+def test_only_no_archs(monkeypatch):
+    monkeypatch.setattr(
+        sys, "argv", sys.argv + ["--only", "cp311-manylinux_x86_64", "--archs", "x86_64"]
+    )
+
+    with pytest.raises(SystemExit):
+        main()
+
+
+@pytest.mark.parametrize(
+    "envvar_name,envvar_value",
+    (
+        ("CIBW_BUILD", "cp310-*"),
+        ("CIBW_SKIP", "cp311-*"),
+        ("CIBW_ARCHS", "auto32"),
+        ("CIBW_PLATFORM", "macos"),
+    ),
+)
+def test_only_overrides_env_vars(monkeypatch, intercepted_build_args, envvar_name, envvar_value):
+    monkeypatch.setattr(sys, "argv", sys.argv + ["--only", "cp311-manylinux_x86_64"])
+    monkeypatch.setenv(envvar_name, envvar_value)
+
+    main()
+
+    options = intercepted_build_args.args[0]
+    assert options.globals.build_selector.build_config == "cp311-manylinux_x86_64"
+    assert options.globals.build_selector.skip_config == ""
+    assert options.platform == "linux"
+    assert options.globals.architectures == Architecture.all_archs("linux")
@@ -19,7 +19,8 @@ ALL_IDS = {"cp36", "cp37", "cp38", "cp39", "cp310", "cp311", "pp37", "pp38", "pp
@pytest.fixture
 def mock_build_container(monkeypatch):
    def fail_on_call(*args, **kwargs):
-        raise RuntimeError("This should never be called")
+        msg = "This should never be called"
+        raise RuntimeError(msg)

    def ignore_call(*args, **kwargs):
        pass
@@ -1,10 +1,14 @@
 from __future__ import annotations

+import os
 import platform as platform_module
+import textwrap
+from pathlib import Path

 import pytest

 from cibuildwheel.__main__ import get_build_identifiers
+from cibuildwheel.bashlex_eval import local_environment_executor
 from cibuildwheel.environment import parse_environment
 from cibuildwheel.options import Options, _get_pinned_container_images

@@ -116,3 +120,77 @@ def test_passthrough_evil(tmp_path, monkeypatch, env_var_value):
    monkeypatch.setenv("ENV_VAR", env_var_value)
    parsed_environment = options.build_options(identifier=None).environment
    assert parsed_environment.as_dictionary(prev_environment={}) == {"ENV_VAR": env_var_value}
+
+
+xfail_env_parse = pytest.mark.xfail(
+    raises=SystemExit, reason="until we can figure out the right way to quote these values"
+)
+
+
+@pytest.mark.parametrize(
+    "env_var_value",
+    [
+        "normal value",
+        pytest.param('"value wrapped in quotes"', marks=[xfail_env_parse]),
+        pytest.param('an unclosed double-quote: "', marks=[xfail_env_parse]),
+        "string\nwith\ncarriage\nreturns\n",
+        pytest.param("a trailing backslash \\", marks=[xfail_env_parse]),
+    ],
+)
+def test_toml_environment_evil(tmp_path, monkeypatch, env_var_value):
+    args = get_default_command_line_arguments()
+    args.package_dir = tmp_path
+
+    tmp_path.joinpath("pyproject.toml").write_text(
+        textwrap.dedent(
+            f"""\
+            [tool.cibuildwheel.environment]
+            EXAMPLE='''{env_var_value}'''
+            """
+        )
+    )
+
+    options = Options(platform="linux", command_line_arguments=args)
+    parsed_environment = options.build_options(identifier=None).environment
+    assert parsed_environment.as_dictionary(prev_environment={}) == {"EXAMPLE": env_var_value}
+
+
+@pytest.mark.parametrize(
+    "toml_assignment,result_value",
+    [
+        ('TEST_VAR="simple_value"', "simple_value"),
+        # spaces
+        ('TEST_VAR="simple value"', "simple value"),
+        # env var
+        ('TEST_VAR="$PARAM"', "spam"),
+        ('TEST_VAR="$PARAM $PARAM"', "spam spam"),
+        # env var extension
+        ('TEST_VAR="before:$PARAM:after"', "before:spam:after"),
+        # env var extension with spaces
+        ('TEST_VAR="before $PARAM after"', "before spam after"),
+        # literal $ - this test is just for reference, I'm not sure if this
+        # syntax will work if we change the TOML quoting behaviour
+        (r'TEST_VAR="before\\$after"', "before$after"),
+    ],
+)
+def test_toml_environment_quoting(tmp_path: Path, toml_assignment, result_value):
+    args = get_default_command_line_arguments()
+    args.package_dir = tmp_path
+
+    tmp_path.joinpath("pyproject.toml").write_text(
+        textwrap.dedent(
+            f"""\
+            [tool.cibuildwheel.environment]
+            {toml_assignment}
+            """
+        )
+    )
+
+    options = Options(platform="linux", command_line_arguments=args)
+    parsed_environment = options.build_options(identifier=None).environment
+    environment_values = parsed_environment.as_dictionary(
+        prev_environment={**os.environ, "PARAM": "spam"},
+        executor=local_environment_executor,
+    )
+
+    assert environment_values["TEST_VAR"] == result_value
@@ -331,3 +331,38 @@ test-command = "pyproject-override"

    with pytest.raises(ConfigOptionError):
        OptionsReader(config_file_path=pyproject_toml, platform=platform)
+
+
+def test_config_settings(tmp_path):
+    pyproject_toml: Path = tmp_path / "pyproject.toml"
+    pyproject_toml.write_text(
+        """\
+[tool.cibuildwheel.config-settings]
+example = "one"
+other = ["two", "three"]
+"""
+    )
+
+    options_reader = OptionsReader(config_file_path=pyproject_toml, platform="linux")
+    assert (
+        options_reader.get("config-settings", table={"item": '{k}="{v}"', "sep": " "})
+        == 'example="one" other="two" other="three"'
+    )
+
+
+def test_pip_config_settings(tmp_path):
+    pyproject_toml: Path = tmp_path / "pyproject.toml"
+    pyproject_toml.write_text(
+        """\
+[tool.cibuildwheel.config-settings]
+--build-option="--use-mypyc"
+"""
+    )
+
+    options_reader = OptionsReader(config_file_path=pyproject_toml, platform="linux")
+    assert (
+        options_reader.get(
+            "config-settings", table={"item": "--config-settings='{k}=\"{v}\"'", "sep": " "}
+        )
+        == "--config-settings='--build-option=\"--use-mypyc\"'"
+    )
@@ -10,6 +10,7 @@ def get_default_command_line_arguments() -> CommandLineArguments:
        platform="auto",
        allow_empty=False,
        archs=None,
+        only=None,
        config_file="",
        output_dir=Path("wheelhouse"),
        package_dir=Path("."),
Author	SHA1	Message	Date
Joe Rickerby	7c45799919	Bump version: v2.10.2	2022-09-25 09:48:12 +01:00
Joe Rickerby	f7669045f5	Merge pull request #1258 from henryiii/henryiii/chore/dev chore: nicer tracebacks and dev improvements	2022-09-25 09:34:05 +01:00
Joe Rickerby	73a435b9f6	Merge pull request #1266 from henryiii/henryiii/fix/crossplatform fix: better cross-platform auto archs	2022-09-25 09:31:25 +01:00
Joe Rickerby	8b0aa9b9e5	Merge pull request #1282 from pypa/fix-1281	2022-09-25 08:33:28 +01:00
Joe Rickerby	6b0e1bc2c4	Merge pull request #1274 from pypa/diagram-fix	2022-09-25 08:32:16 +01:00
Joe Rickerby	5e5fdd1b9a	Fix win32 identifiers with --only	2022-09-24 23:12:32 +01:00
Joe Rickerby	1e3f3fdce7	Add failing test	2022-09-24 23:10:05 +01:00
Joe Rickerby	faa3ab4c2a	Refactor a little to minimise changes and clarify naming	2022-09-24 23:04:46 +01:00
cibuildwheel-bot[bot]andcibuildwheel-bot[bot] <83877280+cibuildwheel-bot[bot]@users.noreply.github.com>	7969f7c794	[Bot] Update dependencies (#1275 ) Update dependencies Co-authored-by: cibuildwheel-bot[bot] <83877280+cibuildwheel-bot[bot]@users.noreply.github.com>	2022-09-20 13:34:54 -04:00
Joe Rickerby	4447618234	Merge pull request #1276 from pypa/pre-commit-ci-update-config	2022-09-19 22:14:49 +01:00
pre-commit-ci[bot]	747b9d013b	[pre-commit.ci] pre-commit autoupdate updates: - [github.com/asottile/pyupgrade: v2.37.3 → v2.38.0](https://github.com/asottile/pyupgrade/compare/v2.37.3...v2.38.0)	2022-09-19 19:59:06 +00:00
Joe Rickerby	728e37103b	Add script to generate the image from HTML	2022-09-18 16:12:57 +01:00
Joe Rickerby	4503076c80	Fix diagram venv box location The repair step isn't done inside the test venv.	2022-09-18 13:46:49 +01:00
Joe Rickerby	225387a9d5	Bump version: v2.10.1	2022-09-18 12:57:10 +01:00
Joe Rickerby	ad172699f1	Merge pull request #1273 from pypa/toml-environment-quoting	2022-09-18 10:20:09 +03:00
Joe Rickerby	5dcb363679	Fix typing-extensions requirement	2022-09-17 11:29:39 +01:00
Joe Rickerby	13fc768552	Revert to the previous quoting behaviour for environment option	2022-09-17 11:15:00 +01:00
Joe Rickerby	7b43ed453f	Add failing test	2022-09-17 09:58:19 +01:00
Henry SchreinerandJoe Rickerby	c302a1d7f9	Apply suggestions from code review Co-authored-by: Joe Rickerby <joerick@mac.com>	2022-09-16 11:05:35 -04:00
Henry Schreiner	534cada6a5	chore: cleaner exception tracebacks Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>	2022-09-16 11:05:35 -04:00
Henry Schreiner	929ecac7f8	chore(bin): remove ghapi requirement Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>	2022-09-16 11:05:35 -04:00
Henry Schreiner	505207c39b	chore: drop [all] extra Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>	2022-09-16 11:05:35 -04:00
Henry Schreiner	00b2600cca	chore: cleanup types (#1263 ) chore: fix typing Final usage for PyLance Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com> Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>	2022-09-16 11:05:05 -04:00
Joe Rickerby	6181943e32	Increase Cirrus CI timeout (#1267 ) Gives us a little more flex for the Cirrus build. I've set these to the maximum because we already use pytest-timeout to catch stalled tests, so there's little need to be conservative. MacOS ARM and aarch64 linux are currently running at 5 and 20 minutes respectively, so no need to increase their limits. See https://github.com/pypa/cibuildwheel/runs/8321188914 for an example timeout on Linux x86	2022-09-13 22:58:09 +02:00
Joe Rickerby	67a7175578	Bump version: v2.10.0	2022-09-13 12:26:31 +03:00
cibuildwheel-bot[bot]andcibuildwheel-bot[bot] <83877280+cibuildwheel-bot[bot]@users.noreply.github.com>	53aa7f7a4f	[Bot] Update dependencies (#1265 ) Update dependencies Co-authored-by: cibuildwheel-bot[bot] <83877280+cibuildwheel-bot[bot]@users.noreply.github.com>	2022-09-13 01:45:10 -04:00
Henry Schreiner	6df5de7175	fix: better cross-platform auto archs This improves the default arch selection when targetting a different platform. Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>	2022-09-12 23:44:33 -04:00
Henry Schreiner	01504b889c	docs: only macOS platforms support macOS ARM (#1264 ) Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com> Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>	2022-09-09 12:02:22 -04:00
Henry SchreinerandJoe Rickerby	eb39da0b10	feat: add --only (#1098 ) * fix(style): use sub recommended replacement method See https://docs.python.org/3/library/re.html#re.escape Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com> * feat: add --build * refactor: switch to using --only Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com> * docs: cover --only Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com> * docs: undo change to --plat for auditwheel Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com> * (unrelated) speed up running the unit tests based on a profile run, this speeds up the unit tests by 3x * Remove `intercepted_build_args` reliance on `platform` fixture * Add test that checks if 'only' overrides env var options * Ensure that the --only command line option overrides env vars * Fix UnboundLocalError * Test cleanups * style: typing.cast instead of plain cast * feat: add only: to the GHA Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com> Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com> Co-authored-by: Joe Rickerby <joerick@mac.com>	2022-09-09 08:34:47 -04:00
cibuildwheel-bot[bot]andcibuildwheel-bot[bot] <83877280+cibuildwheel-bot[bot]@users.noreply.github.com>	3a46bde3fb	[Bot] Update dependencies (#1256 ) Update dependencies Co-authored-by: cibuildwheel-bot[bot] <83877280+cibuildwheel-bot[bot]@users.noreply.github.com>	2022-09-06 20:52:55 -04:00
Henry Schreiner	3597095948	feat: support config-settings (#1244 ) * feat: support config-settings Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com> feat: support config-settings Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com> * refactor: use shlex.quote Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com> Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>	2022-09-06 00:56:20 -04:00
pre-commit-ci[bot]andpre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>	6a9b39af49	[pre-commit.ci] pre-commit autoupdate (#1257 ) updates: - [github.com/psf/black: 22.6.0 → 22.8.0](https://github.com/psf/black/compare/22.6.0...22.8.0) Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>	2022-09-06 00:29:44 +02:00
Matthieu Darbois	3ebce17339	feat: manylinux_2_28_s390x support (#1255 ) A `manylinux_2_28` image now exists for the `s390x` architecture.	2022-09-05 09:00:55 +02:00
Joe Rickerby	6f17a09d06	Merge pull request #1249 from pypa/update-dependencies-pr [Bot] Update dependencies	2022-09-04 18:05:26 +01:00
Joe Rickerby	2dfeb94026	Merge pull request #1253 from maxbachmann/main avoid RecursionError on Windows	2022-09-04 15:00:08 +01:00
Max Bachmann	ed73b75efe	avoid RecursionError on Windows	2022-09-04 10:27:05 +02:00
Joe Rickerby	0117165b02	Merge pull request #1191 from jack1142/add_cirrus_ci_support Add support for Cirrus CI	2022-08-30 22:08:46 +01:00
Joe Rickerby	35ffadc277	Merge pull request #1235 from pypa/docs-update Update docs toolchain	2022-08-30 21:57:04 +01:00
cibuildwheel-bot[bot]	65f7c68354	Update dependencies	2022-08-29 07:26:28 +00:00
Jakub Kuczys	93986db68c	Merge branch 'main' into add_cirrus_ci_support	2022-08-23 21:26:03 +02:00
Jakub KuczysandJoe Rickerby	d22703a7ce	Apply suggestions from code review Co-authored-by: Joe Rickerby <joerick@mac.com>	2022-08-23 19:39:20 +02:00
Jakub Kuczys	f0e9518e79	Add Linux arm64 back	2022-08-23 17:55:14 +02:00
Joe Rickerby	8537b1670f	Merge pull request #1242 from pypa/pre-commit-ci-update-config	2022-08-23 08:27:23 +01:00
Joe Rickerby	eb463fd198	Merge pull request #1230 from pypa/update-dependencies-pr	2022-08-22 22:22:23 +01:00
pre-commit-ci[bot]	99dc2ed515	[pre-commit.ci] pre-commit autoupdate updates: - [github.com/codespell-project/codespell: v2.1.0 → v2.2.1](https://github.com/codespell-project/codespell/compare/v2.1.0...v2.2.1)	2022-08-22 19:19:55 +00:00
Henry Schreiner	0bc70cac93	fix(style): don't check generated file Signed-off-by: Henry Schreiner <henryschreineriii@gmail.com>	2022-08-22 14:26:13 -04:00
cibuildwheel-bot[bot]	3ea4526c63	Update dependencies	2022-08-22 06:18:46 +00:00
Jakub Kuczys	2723bbab17	Re-trigger Circle CI	2022-08-21 19:13:28 +02:00
Jakub Kuczys	bd512e9065	Remove Linux arm64 build	2022-08-17 15:56:58 +02:00
Jakub Kuczys	c50d72c03c	Show how to build for Intel macOS on Cirrus CI	2022-08-17 15:56:57 +02:00
Jakub Kuczys	ccd29d8402	Use CPython 3.10 instead of 3.8 that was used instead of 3.6	2022-08-17 15:48:03 +02:00
Jakub KuczysandJoe Rickerby	8d71ecace2	Elaborate on why arm64 platform is skipped for failing test test Co-authored-by: Joe Rickerby <joerick@mac.com>	2022-08-17 15:48:03 +02:00
Jakub KuczysandJoe Rickerby	dce8c221b7	Add more leeway to the 55 minutes task Co-authored-by: Joe Rickerby <joerick@mac.com>	2022-08-17 15:48:02 +02:00
jack1142	ffeccfe807	Update CI.md	2022-08-17 15:48:02 +02:00
Jakub Kuczys	ce8e3fe68d	List Cirrus CI in README and update relevant scripts	2022-08-17 15:48:02 +02:00
jack1142	2812f8b588	Add a minimal example	2022-08-17 15:48:01 +02:00
jack1142	67071395fa	Add Cirrus CI to CIProvider enum	2022-08-17 15:47:39 +02:00
jack1142	623b39eb5a	Add .cirrus.yml running tests	2022-08-17 15:47:38 +02:00
jack1142	2b35f3c658	Skip cp38-macosx_arm64 in the test testing failing tests	2022-08-17 15:12:58 +02:00
jack1142	b39dc5bb5e	Test doesn't depend on python version but macOS arm64 can't build 3.6	2022-08-17 15:12:58 +02:00
jack1142	2bf4c14249	Bump wheel version to fix deployment target for universal2 pypa/wheel - issue 387 and PR 390	2022-08-17 15:12:57 +02:00
jack1142	4bc6bd3c5f	Skip Python 3.6 test on macOS arm64	2022-08-17 15:12:44 +02:00
Joe Rickerby	225ff6347f	Minor styling improvements	2022-08-17 09:12:02 +01:00
Joe Rickerby	75c93112dc	Update mkdocs and fix resulting issues	2022-08-16 22:53:11 +01:00
Joe Rickerby	4cfe1a3fff	Merge pull request #1233 from Cryptex-github/main Add ril to projects.yml	2022-08-16 22:27:11 +01:00
pre-commit-ci[bot]	ed290fac3d	[pre-commit.ci] auto fixes from pre-commit.com hooks for more information, see https://pre-commit.ci	2022-08-16 19:50:10 +00:00
Cryptex	c9216ba01c	Add ril to projects.yml	2022-08-16 12:46:30 -07:00
Grzegorz Bokota	f708df11c7	Add @czaki to the maintainers	2022-08-12 15:35:49 +02:00
Joe Rickerby	888771972a	Add @czaki to the maintainers	2022-08-12 11:46:24 +01:00
				`@@ -0,0 +1 @@`
				<svg xmlns="http://www.w3.org/2000/svg" role="img" viewBox="0 0 24 24" width="16px" fill="#606060"><title>Cirrus CI icon</title><path d="M19.422.453a1.113 1.113 0 0 0-1.113 1.115 1.113 1.113 0 0 0 1.112 1.114c1.31 0 2.35 1.042 2.35 2.363 0 1.32-1.04 2.363-2.35 2.363H1.112A1.113 1.113 0 0 0 0 8.52a1.113 1.113 0 0 0 1.113 1.117h18.31c1.308 0 2.35 1.042 2.35 2.363 0 1.32-1.042 2.363-2.35 2.363H1.112A1.113 1.113 0 0 0 0 15.48a1.113 1.113 0 0 0 1.113 1.112h18.31c1.308 0 2.35 1.042 2.35 2.363 0 1.32-1.042 2.363-2.35 2.363H1.112A1.113 1.113 0 0 0 0 22.432a1.113 1.113 0 0 0 1.113 1.115h18.31a1.113 1.113 0 0 0 .206-.022c2.42-.112 4.37-2.12 4.37-4.57 0-1.393-.642-2.634-1.63-3.478C23.356 14.632 24 13.393 24 12c0-1.393-.643-2.632-1.63-3.477C23.357 7.68 24 6.438 24 5.045c0-2.52-2.06-4.592-4.578-4.592z"/></svg>