Bump version: v4.0.0

feat: remove GraalPy 3.11 (gp311) support (#2895 )
Drops the GraalPy 3.11 / GraalPy 24.2 builds (gp311_242) as agreed in pypa/cibuildwheel#2741: a ~6-month overlap after the GraalPy 25 (gp312) release. GraalPy 3.12 (gp312_250) stays. This also removes the GraalPy 24-only workarounds that were explicitly marked "Remove when GraalPy 24.x is dropped": - the Visual Studio compiler-discovery (vswhere) and build-isolation (graalpython#491) workarounds in the Windows backend - the issue-491 Windows skip/filter hacks in test_pep518 and test_dependency_versions (added in the original GraalPy PR #1538 and unneeded since GraalPy 25 per #2597) The uv-doesn't-support-graalpy skip (#2754), the `graalpy` enable group, and the generated constraints pins apply to all GraalPy and are kept. Assisted-by: ClaudeCode:claude-opus-4.8
2026-06-07 14:53:57 -04:00 · 2026-06-07 14:24:31 -04:00 · 2026-06-06 23:10:32 -04:00 · 2026-06-06 21:35:17 -04:00 · 2026-06-06 10:32:03 -04:00 · 2026-06-06 08:19:14 -04:00
204 changed files with 9910 additions and 3873 deletions
@@ -0,0 +1,122 @@
+---
+name: changelog-entry
+description: Generate a new changelog entry for cibuildwheel based on all changes since the last tag. Use when updating the changelog or preparing a release.
+---
+
+# Generate Changelog Entry
+
+Produce a new version section at the top of `docs/changelog.md` summarizing all changes since the last git tag.
+
+## Steps
+
+1. **Find the last tag** — run `git tag --sort=-version:refname | head -1` to get the most recent version tag.
+2. **Gather changes** — run `git log <last-tag>..HEAD --oneline` and `git log <last-tag>..HEAD --format="%H %s"` to see all commits since that tag.
+3. **Read each merge/commit** — for substantive commits, read the full message and any linked PRs to understand the change. Use `git log <last-tag>..HEAD --format="---%n%B"` for full messages. If a commit message is ambiguous, use `gh pr view <number>` to get richer context from GitHub.
+4. **Classify and draft entries** — assign each change an emoji and write a one-line description following the style rules below. Combine related small PRs of the same type (bot dependency updates, dependabot CI action bumps, pre-commit autoupdates) into a single entry listing all PR numbers. Skip meta-changelog PRs (e.g., "Add missing CHANGELOG entries") — they don't describe user-facing changes. If a bot/dependency PR contains a substantive fix mixed in (e.g., a pip revert inside a dependency update), split it: mention the fix separately under its own category.
+5. **Determine the new version number** — inspect commits for breaking changes or new features to decide patch/minor/major bump. Ask the user if unclear.
+6. **Determine the date** — use today's date.
+7. **Insert the new section** — add it at the top of `docs/changelog.md`, right after the `# Changelog` heading and a blank line, before any existing version sections.
+
+## Style Rules
+
+These are non-negotiable formatting conventions derived from the existing changelog.
+
+### Version heading
+
+```markdown
+### v3.4.2
+```
+
+`###` heading, `v` prefix, full semver.
+
+### Date line
+
+```markdown
+_14 May 2026_
+```
+
+Italic (underscore-wrapped), day without leading zero, full month name, 4-digit year. One blank line after the date.
+
+### Entry format
+
+```markdown
+- <emoji> <Description> (#<PR number>)
+```
+
+- Each entry is a single bullet starting with `- `.
+- Emoji immediately after the dash-space.
+- Space between emoji and description text.
+- PR number(s) in parens at end: `(#1234)` or `(#1234, #5678)`.
+- No trailing period for single-sentence entries.
+- Period at end of multi-sentence entries only.
+
+### Emoji categories
+
+Use exactly one emoji per entry, chosen by category:
+
+| Emoji | Category | Used for |
+|-------|----------|----------|
+| 🌟 | Major feature | New platforms, significant new capabilities |
+| ✨ | Feature | New features, additions, user-visible enhancements |
+| 🐛 | Bug fix | Bug fixes |
+| 🛠 | Maintenance | Dep updates, internal improvements, behavior tweaks |
+| ⚠️ | Warning | Deprecations, breaking changes, dropped support |
+| 📚 | Docs | Documentation changes |
+| 💼 | Internal | Non-user-facing infra/tooling changes |
+| 🧪 | Tests | Test changes |
+| 🔐 | Security | Security-related changes (used in past changelogs) |
+
+### Category disambiguation
+
+When a change could fit multiple categories, use these tiebreakers:
+
+- **CI/workflow fixes** → 💼 (not 🧪) — they fix infra, not test logic.
+- **Test suite changes** → 🧪 — only for changes to the test code itself.
+- **Diagnostic output changes** (e.g., printing more info during builds) → 🛠 (not 🐛) — they're improvements, not bug fixes.
+- **A bug fix that also changes test code** → 🐛 — the user-facing fix takes priority; test changes are implicit.
+
+### Writing style
+
+- **Present tense**: "Adds", "Fixes", "Updates", not "Added", "Fixed".
+- **Sentence case**: capitalize only the first word after the emoji.
+- **Link option names to docs**: `[`option-name`](https://cibuildwheel.pypa.io/en/stable/options/#option-name)`. Option anchors match the option name — verify in `docs/options.md` by searching for `{: #option-name }`.
+- Be specific about what changed and why, not just that something changed.
+
+### Ordering
+
+Within a version section, order entries by importance:
+
+1. 🌟 entries first
+2. ⚠️ entries next
+3. ✨ entries
+4. 🐛 entries
+5. 🛠 entries
+6. 📚 entries
+7. 💼 entries
+8. 🧪 entries last
+
+### Multi-line entries
+
+For complex features needing explanation, use an indented italic paragraph:
+
+```markdown
+- ✨ Short summary here. (#1234)
+
+    _Longer explanation with details and caveats._ (#1234)
+```
+
+Adding a new Python beta version always has a specific longer explanation, check for a previous addition (like 3.14) for the note to use.
+
+### Blank lines
+
+- One blank line between version sections.
+- No blank lines between bullets within a version.
+
+## Validation
+
+After inserting the new section:
+
+1. Check that the new section follows all style rules above.
+2. Verify PR numbers match actual PRs in the commit log.
+3. Ensure no duplicate entries — multiple commits to the same PR should produce one entry.
+4. Run a final review of the file to confirm formatting is consistent with surrounding entries.
@@ -1,91 +0,0 @@
-only_if: changesInclude('.cirrus.yml') || ($CIRRUS_BRANCH == "main" && !changesIncludeOnly('.github/*', 'bin/*', 'docs/*', '.circleci/*', '.travis.yml', '.pre-commit-config.yaml', '.readthedocs.yml', 'azure-pipelines.yml', 'README.md', 'mkdocs.yml', 'noxfile.py')) || $CIRRUS_BRANCH =~ 'cirrus.*'
-
-run_tests: &RUN_TESTS
-  install_cibuildwheel_script:
-    - python -m pip install -U pip
-    - python -m pip install -e. --group test
-  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
-  env:
-    VENV_ROOT: ${HOME}/venv-cibuildwheel
-    PATH: ${VENV_ROOT}/bin:${PATH}
-  install_pre_requirements_script:
-    - docker run --rm --privileged docker.io/tonistiigi/binfmt:latest --install all
-    - add-apt-repository -y ppa:deadsnakes/ppa
-    - apt-get update
-    - apt-get install -y python3.12-venv
-    - python3.12 -m venv ${VENV_ROOT}
-  <<: *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
-  env:
-    VENV_ROOT: ${HOME}/venv-cibuildwheel
-    PATH: ${VENV_ROOT}/bin:${PATH}
-  install_pre_requirements_script:
-    - docker run --rm --privileged docker.io/tonistiigi/binfmt:latest --install all
-    - add-apt-repository -y ppa:deadsnakes/ppa
-    - apt-get update
-    - apt-get install -y python3.12-venv
-    - python3.12 -m venv ${VENV_ROOT}
-  <<: *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:
-    - certutil -generateSSTFromWU roots.sst
-    - certutil -addstore -f root roots.sst
-    - del roots.sst
-    - choco install -y --no-progress python3 --version 3.12.4
-    - refreshenv
-    - powershell -Command "$cleanPath = $env:PATH -replace ';+$', ''; Add-Content -Path $env:CIRRUS_ENV -Value ('PATH=' + $cleanPath)"
-  <<: *RUN_TESTS
-
-macos_arm64_task:
-  macos_instance:
-    image: ghcr.io/cirruslabs/macos-runner:sequoia
-  env:
-    VENV_ROOT: ${HOME}/venv-cibuildwheel
-    PATH: ${VENV_ROOT}/bin:${PATH}
-  install_pre_requirements_script:
-    - brew install python@3.12
-    - python3.12 -m venv ${VENV_ROOT}
-  <<: *RUN_TESTS
-
-macos_arm64_cp38_task:
-  macos_instance:
-    image: ghcr.io/cirruslabs/macos-runner:sequoia
-  env:
-    VENV_ROOT: ${HOME}/venv-cibuildwheel
-    PATH: ${VENV_ROOT}/bin:${PATH}
-    PYTEST_ADDOPTS: --run-cp38-universal2 -k 'test_cp38_arm64_testing_universal2_installer or test_arch_auto or test_dummy_serial'
-  install_pre_requirements_script:
-    - brew install python@3.12
-    - python3.12 -m venv ${VENV_ROOT}
-    - curl -fsSLO https://www.python.org/ftp/python/3.8.10/python-3.8.10-macos11.pkg
-    - sudo installer -pkg python-3.8.10-macos11.pkg -target /
-    - rm python-3.8.10-macos11.pkg
-    - sh "/Applications/Python 3.8/Install Certificates.command"
-  <<: *RUN_TESTS
@@ -9,3 +9,5 @@ updates:
      actions:
        patterns:
          - "*"
+    cooldown:
+      default-days: 7
@@ -0,0 +1,40 @@
+name: "Copilot Setup Steps"
+
+permissions: {}
+
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+  pull_request:
+    paths:
+      - .github/workflows/copilot-setup-steps.yml
+
+jobs:
+  copilot-setup-steps:
+    name: Copilot Setup Steps
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: "3.x"
+          allow-prereleases: true
+
+      - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+
+      - name: Install tooling
+        run: |
+          uv tool install nox
+          uv tool install prek
+
+      - name: Pre-install checks
+        run: |
+          prek prepare-hooks
@@ -7,13 +7,17 @@ on:
    types:
    - published

+permissions: {}
+
 jobs:
  dist:
    runs-on: ubuntu-latest
    steps:
-    - uses: actions/checkout@v5
+    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      with:
+        persist-credentials: false

-    - uses: hynek/build-and-inspect-python-package@v2
+    - uses: hynek/build-and-inspect-python-package@d44ca7d91762de7a7d5436ddae667c6da6d1c3df # v2.18.0

  publish:
    needs: [dist]
@@ -27,16 +31,16 @@ jobs:
      attestations: write

    steps:
-    - uses: actions/download-artifact@v5
+    - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
      with:
        name: Packages
        path: dist

    - name: Generate artifact attestation for sdist and wheel
-      uses: actions/attest-build-provenance@e8998f949152b193b063cb0ec769d69d929409be # v2.4.0
+      uses: actions/attest-build-provenance@a2bbfa25375fe432b6a289bc6b6cd05ecd0c4c32 # v4.1.0
      with:
        subject-path: "dist/cibuildwheel-*"

-    - uses: pypa/gh-action-pypi-publish@release/v1
+    - uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0
      with:
        attestations: true
@@ -28,6 +28,8 @@ on:
  workflow_dispatch:
    # allow manual runs on branches without a PR

+permissions: {}
+
 concurrency:
  group: test-${{ github.ref }}
  cancel-in-progress: true
@@ -37,18 +39,42 @@ jobs:
    name: Linters (mypy, ruff, etc.)
    runs-on: ubuntu-latest
    steps:
-    - uses: actions/checkout@v5
-    - uses: actions/setup-python@v5
-      id: python
+    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      with:
+        persist-credentials: false
+    - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
      with:
        python-version: "3.x"
-    - uses: pre-commit/action@v3.0.1
+    - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+    - uses: j178/prek-action@bdca6f102f98e2b4c7029491a53dfd366469e33d # v2.0.4
    - name: PyLint checks
-      run: pipx run --python "${{ steps.python.outputs.python-path }}" nox -s pylint -- --output-format=github
+      run: uvx nox -s pylint -- --output-format=github
+
+  sample:
+    name: Generate a sample project
+    needs: lint
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      with:
+        persist-credentials: false
+    - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+      name: Install Python
+      with:
+        python-version: "3.x"
+    - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+    - name: Install dependencies
+      run: uv sync --no-dev --group test
+    - name: Generate a sample project
+      run: uv run --no-sync -m test.test_projects test.test_0_basic.basic_project sample_proj
+    - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+      with:
+        name: sample_proj
+        path: sample_proj

  test:
    name: Test on ${{ matrix.os }} (${{ matrix.python_version }}) ${{ matrix.test_select }}
-    needs: lint
+    needs: sample
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
@@ -59,9 +85,9 @@ jobs:
          python_version: '3.11'
        # Max Python
        - os: ubuntu-latest
-          python_version: '3.14'
+          python_version: '3.15'
        - os: ubuntu-latest
-          python_version: '3.13'
+          python_version: '3.14'
          test_select: android
        - os: ubuntu-24.04-arm
          python_version: '3.13'
@@ -69,65 +95,67 @@ jobs:
          python_version: '3.13'
        - os: windows-11-arm
          python_version: '3.13'
-        - os: macos-13
+        - os: macos-15-intel
          python_version: '3.13'
        - os: macos-15
          python_version: '3.13'
-        - os: macos-13
+        - os: macos-15-intel
          python_version: '3.13'
          test_select: ios
-        - os: macos-14  # 20250811 macos-15 update caused havoc with iOS simulators
+        - os: macos-15
          python_version: '3.13'
          test_select: ios
-        - os: macos-13
+          # Exercise iOS on a non-default simulator.
+          test_runtime: 'args: --simulator "iPhone 16e,OS=18.5"'
+        - os: macos-15-intel
          python_version: '3.13'
          test_select: android
+          # Exercise Android on a non-default simulator
+          test_runtime: 'args: --managed minVersion'
        - os: macos-15
          python_version: '3.13'
          test_select: android
    timeout-minutes: 180
    steps:
-    - uses: actions/checkout@v5
-    - uses: actions/setup-python@v5
+    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      with:
+        persist-credentials: false
+    - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
      name: Install Python ${{ matrix.python_version }}
      with:
        python-version: ${{ matrix.python_version }}
        allow-prereleases: true

-    - uses: astral-sh/setup-uv@v6
+    - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0

    - name: Free up disk space
-      if: runner.os == 'Linux'
+      if: runner.os == 'Linux' && matrix.test_select != 'android'
      run: |
-        docker system prune -a -f
-        sudo rm -rf $ANDROID_HOME/ndk/{26,28}.* /opt/hostedtoolcache/CodeQL \
+        sudo rm -rf $ANDROID_HOME/ndk /opt/hostedtoolcache/CodeQL \
          /usr/local/lib/node_modules /usr/local/share/chromium \
          /usr/local/share/powershell
-        df -h
-
-    # https://github.blog/changelog/2024-04-02-github-actions-hardware-accelerated-android-virtualization-now-available/
-    - name: Enable KVM for Android emulator
-      if: runner.os == 'Linux' && runner.arch == 'X64'
-      run: |
-          echo 'KERNEL=="kvm", GROUP="kvm", MODE="0666", OPTIONS+="static_node=kvm"' | sudo tee /etc/udev/rules.d/99-kvm4all.rules
-          sudo udevadm control --reload-rules
-          sudo udevadm trigger --name-match=kvm
+        df -m

    # for oci_container unit tests
    - name: Set up QEMU
      if: runner.os == 'Linux'
-      uses: docker/setup-qemu-action@v3
+      uses: docker/setup-qemu-action@06116385d9baf250c9f4dcb4858b16962ea869c3 # v4.1.0
+
+    - name: Set up Xcode
+      if: ${{ startsWith(matrix.os, 'macos-15') }}
+      run: |
+        # GitHub recommends explicitly selecting the desired Xcode version
+        sudo xcode-select --switch /Applications/Xcode_16.4.app

    - name: Install dependencies
-      run: |
-        uv sync --no-dev --group test
+      run: uv sync --no-dev --group test

-    - uses: joerick/pr-labels-action@v1.0.9
+    - uses: joerick/pr-labels-action@0543b277721e852d821c6738d449f2f4dea03d5f # v1.0.9

    - name: Set CIBW_ENABLE
      shell: bash
      run: |
-        if [[ "${{ github.ref_name }}" == "main" ]]; then
+        if [[ "$GITHUB_REF_NAME" == "main" ]]; then
          CIBW_ENABLE=all
        else
          # get the default CIBW_ENABLE value from the test module
@@ -143,9 +171,11 @@ jobs:
        fi
        echo "CIBW_ENABLE=${CIBW_ENABLE}" >> $GITHUB_ENV

-    - name: Generate a sample project
-      run: |
-        uv run --no-sync -m test.test_projects test.test_0_basic.basic_project sample_proj
+    - name: Download a sample project
+      uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+      with:
+        name: sample_proj
+        path: sample_proj

    - name: Run a sample build (GitHub Action)
      uses: ./
@@ -156,6 +186,7 @@ jobs:
        CIBW_ARCHS_MACOS: x86_64 universal2 arm64
        CIBW_BUILD_FRONTEND: ${{ matrix.test_select && 'build' || 'build[uv]' }}
        CIBW_PLATFORM: ${{ matrix.test_select }}
+        CIBW_TEST_RUNTIME: ${{ matrix.test_runtime }}

    - name: Run a sample build (GitHub Action, only)
      uses: ./
@@ -181,6 +212,7 @@ jobs:
      uses: ./
      env:
        CIBW_PLATFORM: ${{ matrix.test_select }}
+        CIBW_TEST_RUNTIME: ${{ matrix.test_runtime }}
      with:
        package-dir: sample_proj
        output-dir: wheelhouse_config_file
@@ -198,14 +230,15 @@ jobs:
      run: |
        test $(find wheelhouse_only -name '*.whl' | wc -l) -eq 1

-    - uses: actions/upload-artifact@v4
+    - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
      with:
        name: cibw-wheels-${{ matrix.os }}-${{ strategy.job-index }}
        path: wheelhouse/*.whl

    - name: Test cibuildwheel
-      run: |
-        uv run --no-sync bin/run_tests.py --test-select=${{ matrix.test_select || 'native' }} ${{ (runner.os == 'Linux' && runner.arch == 'X64') && '--run-podman' || '' }}
+      env:
+        CIBW_TEST_RUNTIME: ${{ matrix.test_runtime }}
+      run: uv run --no-sync bin/run_tests.py --test-select=${{ matrix.test_select || 'native' }} ${{ (runner.os == 'Linux' && runner.arch == 'X64') && '--run-podman' || '' }}

  emulated-archs:
    name: Get qemu emulated architectures
@@ -214,11 +247,13 @@ jobs:
    outputs:
      archs: ${{ steps.archs.outputs.archs }}
    steps:
-    - uses: actions/checkout@v5
-    - uses: actions/setup-python@v5
+    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      with:
+        persist-credentials: false
+    - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
      with:
        python-version: "3.x"
-    - uses: astral-sh/setup-uv@v6
+    - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
    - name: Install dependencies
      run: uv sync --no-dev --group test
    - name: Get qemu emulated architectures
@@ -237,39 +272,47 @@ jobs:
      matrix:
        arch: ${{ fromJSON(needs.emulated-archs.outputs.archs) }}
    steps:
-    - uses: actions/checkout@v5
-    - uses: actions/setup-python@v5
+    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      with:
+        persist-credentials: false
+    - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
      with:
        python-version: "3.x"
-    - uses: astral-sh/setup-uv@v6
+    - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
    - name: Install dependencies
      run: uv sync --no-dev --group test

    - name: Set up QEMU
-      uses: docker/setup-qemu-action@v3
+      uses: docker/setup-qemu-action@06116385d9baf250c9f4dcb4858b16962ea869c3 # v4.1.0

    - name: Run the emulation tests
-      run: uv run --no-sync pytest --run-emulation ${{ matrix.arch }} test/test_emulation.py
+      env:
+        MATRIX_ARCH: ${{ matrix.arch }}
+      run: uv run --no-sync pytest --run-emulation "$MATRIX_ARCH" test/test_emulation.py

  test-pyodide:
    name: Test pyodide
-    needs: lint
+    needs: sample
    runs-on: ubuntu-24.04
    timeout-minutes: 180
    steps:
-    - uses: actions/checkout@v5
-    - uses: actions/setup-python@v5
+    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      with:
+        persist-credentials: false
+    - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
      name: Install Python 3.12
      with:
        python-version: '3.12'
-    - uses: astral-sh/setup-uv@v6
+    - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0

    - name: Install dependencies
      run: uv sync --no-dev --group test

-    - name: Generate a sample project
-      run: |
-        uv run --no-sync -m test.test_projects test.test_0_basic.basic_project sample_proj
+    - name: Download a sample project
+      uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+      with:
+        name: sample_proj
+        path: sample_proj

    - name: Run a sample build (GitHub Action)
      uses: ./
@@ -278,9 +321,49 @@ jobs:
        output-dir: wheelhouse
      env:
        CIBW_PLATFORM: pyodide
+        CIBW_ENABLE: pyodide-prerelease

    - name: Run tests with 'CIBW_PLATFORM' set to 'pyodide'
-      run: |
-        uv run --no-sync ./bin/run_tests.py
+      run: uv run --no-sync ./bin/run_tests.py
      env:
        CIBW_PLATFORM: pyodide
+        CIBW_ENABLE: pyodide-prerelease
+
+  test-uv-extras:
+    name: Test uv extra on ${{ matrix.os }} ${{ matrix.test_select }}
+    needs: sample
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+        - os: ubuntu-latest
+          test_select: android
+        - os: windows-latest
+        - os: windows-11-arm
+        - os: macos-15-intel
+        - os: macos-15
+        - os: macos-15-intel
+          test_select: android
+        - os: macos-15
+          test_select: android
+    steps:
+    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      with:
+        persist-credentials: false
+    - name: Download a sample project
+      uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+      with:
+        name: sample_proj
+        path: sample_proj
+    - name: Run a sample build (GitHub Action)
+      uses: ./
+      with:
+        extras: uv
+        package-dir: sample_proj
+        output-dir: wheelhouse
+      env:
+        CIBW_ARCHS_MACOS: x86_64 universal2 arm64
+        CIBW_BUILD: cp314-*
+        CIBW_BUILD_FRONTEND: 'build[uv]'
+        CIBW_PLATFORM: ${{ matrix.test_select }}
@@ -14,36 +14,47 @@ on:
  schedule:
    - cron: '0 6 * * 1'  # "At 06:00 on Monday."

+permissions: {}
+
 jobs:
  update-dependencies:
    name: Update dependencies
    if: github.repository_owner == 'pypa' || github.event_name != 'schedule'
    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    environment: ${{ github.ref == 'refs/heads/main' && github.repository == 'pypa/cibuildwheel' && 'update-dependencies-workflow' || '' }}
    steps:

    # we use this step to grab a Github App auth token, so that PRs generated by this workflow
    # run the GHA tests.
-    - uses: actions/create-github-app-token@v2
+    - uses: actions/create-github-app-token@bcd2ba49218906704ab6c1aa796996da409d3eb1 # v3.2.0
      id: generate-token
      if: github.ref == 'refs/heads/main' && github.repository == 'pypa/cibuildwheel'
      with:
-        app-id: ${{ secrets.CIBUILDWHEEL_BOT_APP_ID }}
+        client-id: ${{ secrets.CIBUILDWHEEL_BOT_APP_ID }}
        private-key: ${{ secrets.CIBUILDWHEEL_BOT_APP_PRIVATE_KEY }}
+        permission-contents: write
+        permission-pull-requests: write

-    - uses: actions/checkout@v5
+    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      with:
+        persist-credentials: false

-    - uses: wntrblm/nox@2025.05.01
+    - uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+      with:
+        python-version: "3.14"

    - name: "Run update: dependencies"
-      run: nox --force-color -s update_constraints
+      run: uvx nox --force-color -s update_constraints
    - name: "Run update: python configs"
-      run: nox --force-color -s update_pins
+      run: uvx nox --force-color -s update_pins
    - name: "Run update: docs user projects"
-      run: nox --force-color -s update_proj -- --auth=${{ secrets.GITHUB_TOKEN }}
+      run: uvx nox --force-color -s update_proj -- --auth=${{ secrets.GITHUB_TOKEN }}

    - name: Create Pull Request
      if: github.ref == 'refs/heads/main' && github.repository == 'pypa/cibuildwheel'
-      uses: peter-evans/create-pull-request@v7
+      uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1 # v8.1.1
      with:
        commit-message: Update dependencies
        title: '[Bot] Update dependencies'
@@ -21,10 +21,12 @@ jobs:
    permissions:
      contents: write
    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false

      - name: Update the ${{ env.TAG_NAME }} tag
        id: update-major-minor-tag
-        uses: joerick/update-vX.Y-tag-action@v1.0
+        uses: joerick/update-vX.Y-tag-action@c4cefb60c33b82e4aa73a469e4acf30ee48d5812 # v1.0.2
        with:
          source-tag: ${{ env.TAG_NAME }}
@@ -0,0 +1,24 @@
+name: zizmor - GitHub Actions Security Analysis
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["**"]
+
+permissions: {}
+
+jobs:
+  zizmor:
+    name: Run zizmor 🌈
+    runs-on: ubuntu-latest
+    permissions:
+      security-events: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+
+      - name: Run zizmor 🌈
+        uses: zizmorcore/zizmor-action@5f14fd08f7cf1cb1609c1e344975f152c7ee938d # v0.5.6
@@ -112,3 +112,13 @@ site/

 # PyCharm
 .idea/
+
+# Lockfiles
+*.lock
+*.pylock
+
+# OS files
+.DS_Store
+
+# This file should be a symlink or contain "See @AGENTS.md"
+CLAUDE.md
@@ -1,5 +1,5 @@
 linux:
-  image: python:3.12
+  image: python:3.13
  services:
    - name: docker:dind
      entrypoint: ["env", "-u", "DOCKER_HOST"]
@@ -14,7 +14,7 @@ linux:
    # (comment the below line in a PR to debug a Gitlab-specific issue)
    PYTEST_ADDOPTS: -k "unit_test or test_0_basic" --suppress-no-test-exit-code
  rules:
-    - if: '$CI_COMMIT_BRANCH == "main"'
+    - if: '$CI_COMMIT_BRANCH == "main" || $CI_COMMIT_BRANCH =~ /^gitlab/'
      variables:
        CIBW_ENABLE: "all"
  script:
@@ -25,28 +25,29 @@ linux:
    - python ./bin/run_tests.py

 windows:
-  image: mcr.microsoft.com/windows/servercore:1809
  variables:
    PYTEST_ADDOPTS: -k "unit_test or test_0_basic" --suppress-no-test-exit-code
-  before_script:
-    - choco install python -y --allow-downgrade --version 3.12.4
  rules:
-    - if: '$CI_COMMIT_BRANCH == "main"'
+    - if: '$CI_COMMIT_BRANCH == "main" || $CI_COMMIT_BRANCH =~ /^gitlab/'
      variables:
-        CIBW_ENABLE: "all"
+        # Everything except graalpy. GraalPy is JVM-based and very slow to
+        # start; on the small (2-core) GitLab SaaS Windows runners,
+        # virtualenv's interpreter query for graalpy.exe times out, failing
+        # the build. (Other platforms run the full "all" group.)
+        CIBW_ENABLE: "cpython-prerelease pypy pypy-eol pyodide-eol pyodide-prerelease"
  script:
-    - py -m pip install -U pip
-    - py -m pip install -e. pytest-custom-exit-code --group test
-    - py bin\run_tests.py
+    - python -m pip install -U pip
+    - python -m pip install -e. pytest-custom-exit-code --group test
+    - python bin\run_tests.py
  tags:
    - saas-windows-medium-amd64

 macos:
-  image: macos-14-xcode-15
+  image: macos-15-xcode-16
  variables:
    PYTEST_ADDOPTS: -k "unit_test or test_0_basic" --suppress-no-test-exit-code
  rules:
-    - if: '$CI_COMMIT_BRANCH == "main"'
+    - if: '$CI_COMMIT_BRANCH == "main" || $CI_COMMIT_BRANCH =~ /^gitlab/'
      variables:
        CIBW_ENABLE: "all"
  script:
@@ -1,7 +1,10 @@
-repos:
+ci:
+  autoupdate_schedule: monthly
+exclude: "^cibuildwheel/resources/ios-support/(?!make_cross_venv\\.py)"

+repos:
 - repo: https://github.com/pre-commit/pre-commit-hooks
-  rev: v6.0.0
+  rev: 3e8a8703264a2f4a69428a0aa4dcb512790b2c8c  # frozen: v6.0.0
  hooks:
  - id: check-case-conflict
  - id: check-merge-conflict
@@ -12,21 +15,22 @@ repos:
    exclude: (cibuildwheel/resources/pinned_docker_images.cfg)|(.svg$)
  - id: mixed-line-ending
  - id: trailing-whitespace
+    exclude: ^cibuildwheel/resources/android/android.patch$

 - repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.12.9
+  rev: 0671d8ab202c4ac093b78433ae5baf74f3fc7246  # frozen: v0.15.15
  hooks:
-  - id: ruff
-    args: ["--fix", "--show-fixes"]
+  - id: ruff-check
+    args: ["--fix"]
  - id: ruff-format

 - repo: https://github.com/pre-commit/mirrors-mypy
-  rev: v1.17.1
+  rev: d2823d321df3af8f878f7ee3414dc94d037145b9  # frozen: v2.1.0
  hooks:
  - id: mypy
    name: mypy 3.11 on cibuildwheel/
    args: ["--python-version=3.11"]
-    exclude: ^cibuildwheel/resources/_cross_venv.py$  # Requires Python 3.13 or later
+    exclude: ^cibuildwheel/resources/android/_cross_venv.py$  # Requires Python 3.13 or later
    additional_dependencies: &mypy-dependencies
      - bracex
      - build
@@ -35,7 +39,6 @@ repos:
      - nox>=2025.2.9
      - orjson
      - packaging
-      - pyelftools
      - pygithub
      - pytest
      - rich
@@ -49,12 +52,12 @@ repos:
      - uv
      - validate-pyproject
  - id: mypy
-    name: mypy 3.13
-    args: ["--python-version=3.13"]
+    name: mypy 3.14
+    args: ["--python-version=3.14"]
    additional_dependencies: *mypy-dependencies

 - repo: https://github.com/shellcheck-py/shellcheck-py
-  rev: v0.11.0.1
+  rev: 745eface02aef23e168a8afb6b5737818efbea95  # frozen: v0.11.0.1
  hooks:
  - id: shellcheck

@@ -75,7 +78,7 @@ repos:
    additional_dependencies: [cogapp>=3.5]

 - repo: https://github.com/codespell-project/codespell
-  rev: v2.4.1
+  rev: 2ccb47ff45ad361a21071a7eedda4c37e6ae8c5a  # frozen: v2.4.2
  hooks:
  - id: codespell
    args: ["-w"]
@@ -83,14 +86,13 @@ repos:


 - repo: https://github.com/python-jsonschema/check-jsonschema
-  rev: 0.33.3
+  rev: 943377262562a12b57292fc98fabd7dbf81451fe  # frozen: 0.37.2
  hooks:
    - id: check-dependabot
    - id: check-github-actions
    - id: check-github-workflows
    - id: check-gitlab-ci
-    # Disabled due to schema issue for now:
-    # - id: check-readthedocs
+    - id: check-readthedocs
    - id: check-travis
    - id: check-jsonschema
      name: Check projects
@@ -1,79 +0,0 @@
-os: linux
-dist: jammy
-language: python
-
-branches:
-  only:
-  - main
-
-# only build the main branch or PR that explicitely want to test with Travis CI
-if: (type = "push") OR (commit_message =~ /travis-ci/)
-
-jobs:
-  include:
-    - name: Linux | x86_64 + i686 | Python 3.12
-      python: 3.12
-      services: docker
-      env:
-        - PYTHON=python
-        # a build using CIBW_ENABLE=all does not fit into Travis' time limit,
-        # so only the defaults are tested
-
-    - name: Linux | arm64 | Python 3.12
-      python: 3.12
-      services: docker
-      arch: arm64
-      env:
-        - PYTHON=python
-        - CIBW_ENABLE=all
-
-    - name: Linux | ppc64le | Python 3.12
-      python: 3.12
-      services: docker
-      arch: ppc64le
-      allow_failure: True
-      env:
-        - PYTHON=python
-        # skip test_manylinuxXXXX_only, it uses too much disk space
-        # c.f. https://travis-ci.community/t/running-out-of-disk-space-quota-when-using-docker-on-ppc64le/11634
-        - PYTEST_ADDOPTS='-k "not test_manylinuxXXXX_only"'
-        - CIBW_ENABLE=all
-
-    - name: Windows | x86_64 | Python 3.12
-      os: windows
-      language: shell
-      before_install:
-        # http://woshub.com/updating-trusted-root-certificates-in-windows-10
-        - certutil -generateSSTFromWU roots.sst
-        - powershell -Command 'Get-ChildItem -Path roots.sst | Import-Certificate -CertStoreLocation Cert:\LocalMachine\Root'
-        - rm -f roots.sst
-        - choco upgrade python3 -y --version 3.12.8 --limit-output --params "/InstallDir:C:\\Python312"
-      env:
-        - PYTHON=C:\\Python312\\python
-        # a build using CIBW_ENABLE=all does not fit into Travis' time limit,
-        # so only the defaults are tested
-
-    - name: Linux | s390x | Python 3.12
-      python: 3.12
-      services: docker
-      arch: s390x
-      allow_failure: True
-      env:
-        - PYTHON=python
-        - CIBW_ENABLE=all
-
-install:
- if [ "${TRAVIS_OS_NAME}" == "linux" ]; then docker run --rm --privileged docker.io/tonistiigi/binfmt:latest --install all; fi
- $PYTHON -m pip install -U pip
- $PYTHON -m pip install -e. --group test
-
-script: |
-  # travis_wait disable the output while waiting
-  # use the same kind of tricks as in multibuild
-  (while true; do echo "travis_keep_alive"; sleep 300; done) &
-  SPINNER_PID=$!
-  disown
-  result=0
-  $PYTHON ./bin/run_tests.py --num-processes 2 || result=1
-  kill -9 ${SPINNER_PID}
-  test ${result} -eq 0
@@ -0,0 +1,57 @@
+# cibuildwheel — Agent Notes
+
+## Always run
+
+- `prek -a` should be run after changes to reformat, lint, and type check
+
+## Developer commands
+- `uv run pytest unit_test` — Quick run for unit tests
+- `nox -s tests` — run doctests + unit tests + integration tests (slow, >30 min, requires system Python installs on macOS).
+- `nox -s tests -- unit_test` — fast unit tests only.
+- `nox -s tests -- test -k before_build` — single integration test/file via pytest `-k`.
+- `nox -s lint` — run all linters (pre-commit/prek).
+- `nox -s pylint` — run pylint separately (not in pre-commit).
+- `nox -s docs` — mkdocs serve (interactive) or build (non-interactive).
+- Set up local dev env at `.venv`: `uv sync` (dependency groups used).
+
+## Project layout
+- `cibuildwheel/` — main package. Entry point: `cibuildwheel.__main__:main`.
+- `test/` — **integration tests** (expensive, run actual wheel builds).
+- `unit_test/` — **unit tests** (fast, no wheel builds).
+- `bin/` — maintainer scripts (update pins, generate README tables, schema, etc.).
+- `docs/` — mkdocs source.
+
+## Testing specifics
+- Three test suites exist, run in this order by `bin/run_tests.py`:
+  1. `pytest cibuildwheel` — doctests.
+  2. `pytest unit_test [...]` — unit tests.
+  3. `pytest test [...]` — integration tests (split into `serial` and `not serial` runs).
+- Serial integration tests **must not** run in parallel; non-serial use pytest-xdist by default.
+- Custom pytest options:
+  - `--run-docker` (unit_test + test): run OCI container tests. Linux only.
+  - `--run-podman`: run podman tests (Linux).
+  - `--run-emulation` (test): run QEMU emulation tests (e.g., `--run-emulation aarch64`).
+  - `--platform linux` (test): force integration tests to target Linux container builds even on macOS/Windows.
+  - `--enable` (test): sets `CIBW_ENABLE` env var (e.g., `pypy`, `graalpy`).
+- Integration tests auto-set a default `CIBW_ENABLE` if the env var is absent.
+- The `build_frontend_env` fixture parameterizes over `pip`, `build`, `build[uv]`, `uv` and skips unsupported combos per platform.
+- Some integration tests require system Python.org installs on macOS; missing them prints a download URL in the error.
+- iOS/Android/pyodide tests have dedicated pytest marks (`ios`, `android`, `pyodide`) and need platform-specific runners/simulators.
+
+## Lint / typecheck
+- Ruff (lint + format) and mypy run via pre-commit. Pylint runs separately via `nox -s pylint`.
+- Mypy is strict (`strict = true`) and targets Python 3.11 for the package, 3.14 for a second check in pre-commit.
+- Ruff config in `pyproject.toml` (`line-length = 100`).
+- Python 3.11 is the minimum supported version for the package itself.
+
+## Generated / maintained files
+- `README.md` contains two **cog-generated** tables (options table, changelog preview). Pre-commit runs `cog -c -P -r -I ./bin README.md`. Edit the source scripts (`bin/readme_*.py`) or the upstream files (`docs/options.md`, `docs/changelog.md`) — do not hand-edit the generated blocks. Note the identifier is _not_ cog generated, and can be edited.
+- `cibuildwheel/resources/cibuildwheel.schema.json` is generated by `bin/generate_schema.py` (run via `nox -s generate_schema`).
+- `cibuildwheel/resources/constraints-*.txt` are generated via `nox -s update_constraints`.
+- `cibuildwheel/resources/pinned_docker_images.cfg` and other resource files are updated via `nox -s update_pins`.
+
+## CI / release quirks
+- CI uses `uv sync --no-dev --group test` for test installs, then `uv run --no-sync` to execute.
+- The release workflow uses `hynek/build-and-inspect-python-package` for dist building.
+- `test.yml` skips unrelated paths to avoid burning CI time on docs-only changes.
+- A sample project artifact is built once and downloaded by downstream test jobs to avoid redundant work.
@@ -1,11 +1,9 @@
 This is a summary of the host Python versions and platforms covered by the different CI platforms:

-|         | 3.11                             | 3.12                                        | 3.13           |
-|---------|----------------------------------|---------------------------------------------|----------------|
-| Linux   | Azure Pipelines / GitHub Actions | CircleCI¹ / Cirrus CI / GitLab¹ / Travis CI | GitHub Actions |
-| macOS   | Azure Pipelines                  | CircleCI¹ / Cirrus CI / GitLab¹             | GitHub Actions |
-| Windows | Azure Pipelines                  | Cirrus CI / GitLab¹ / Travis CI             | GitHub Actions |
+|         | 3.11                             | 3.12                    | 3.13           | 3.14           |
+|---------|----------------------------------|-----------------------|----------------|----------------|
+| Linux   | Azure Pipelines / GitHub Actions | CircleCI¹ / GitLab¹   | GitHub Actions | GitHub Actions |
+| macOS   | Azure Pipelines                  | CircleCI¹ / GitLab¹   | GitHub Actions |                |
+| Windows | Azure Pipelines                  | GitLab¹               | GitHub Actions |                |

 > ¹ Runs a reduced set of tests to reduce CI load
-
-Non-x86 architectures are covered on Travis CI using Python 3.12.
@@ -1,24 +1,9 @@
-This project is licensed under the 'BSD 2-clause license'.
+Copyright 2017, Joe Rickerby and contributors. All rights reserved.

-Copyright (c) 2017-2025, Joe Rickerby and contributors. All rights reserved.
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

-1. Redistributions of source code must retain the above copyright notice, this
-list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

-2. Redistributions in binary form must reproduce the above copyright notice,
-this list of conditions and the following disclaimer in the documentation
-and/or other materials provided with the distribution.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
@@ -4,7 +4,6 @@ cibuildwheel
 [![PyPI](https://img.shields.io/pypi/v/cibuildwheel.svg)](https://pypi.python.org/pypi/cibuildwheel)
 [![Documentation Status](https://readthedocs.org/projects/cibuildwheel/badge/?version=stable)](https://cibuildwheel.pypa.io/en/stable/?badge=stable)
 [![Actions Status](https://github.com/pypa/cibuildwheel/workflows/Test/badge.svg)](https://github.com/pypa/cibuildwheel/actions)
-[![Travis Status](https://img.shields.io/travis/com/pypa/cibuildwheel/main?logo=travis)](https://travis-ci.com/github/pypa/cibuildwheel)
 [![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)

@@ -15,7 +14,7 @@ cibuildwheel

 Python wheels are great. Building them across **Mac, Linux, Windows**, on **multiple versions of Python**, is not.

-`cibuildwheel` is here to help. `cibuildwheel` runs on your CI server - currently it supports GitHub Actions, Azure Pipelines, Travis CI, CircleCI, and GitLab CI - and it builds and tests your wheels across all of your platforms.
+`cibuildwheel` is here to help. `cibuildwheel` runs on your CI server - currently it supports GitHub Actions, Azure Pipelines, CircleCI, and GitLab CI - and it builds and tests your wheels across all of your platforms.


 What does it do?
@@ -23,30 +22,31 @@ What does it do?

 While cibuildwheel itself requires a recent Python version to run (we support the last three releases), it can target the following versions to build wheels:

-|                    | macOS Intel | macOS Apple Silicon | Windows 64bit | Windows 32bit | Windows Arm64 | manylinux<br/>musllinux x86_64 | manylinux<br/>musllinux i686 | manylinux<br/>musllinux aarch64 | manylinux<br/>musllinux ppc64le | manylinux<br/>musllinux s390x | manylinux<br/>musllinux armv7l | Android | iOS | Pyodide |
-|--------------------|----|-----|----|-----|-----|----|-----|----|-----|-----|---|-----|-----|-----|
-| CPython 3.8        | ✅ | ✅  | ✅  | ✅  | N/A | ✅ | ✅  | ✅ | ✅  | ✅  | ✅⁵ | N/A | N/A | N/A |
-| CPython 3.9        | ✅ | ✅  | ✅  | ✅  | ✅² | ✅ | ✅ | ✅ | ✅  | ✅  | ✅⁵ | N/A | N/A | N/A |
-| CPython 3.10       | ✅ | ✅  | ✅  | ✅  | ✅² | ✅ | ✅  | ✅ | ✅  | ✅  | ✅⁵ | N/A | N/A | N/A |
-| CPython 3.11       | ✅ | ✅  | ✅  | ✅  | ✅² | ✅ | ✅  | ✅ | ✅  | ✅  | ✅⁵ | N/A | N/A | N/A |
-| CPython 3.12       | ✅ | ✅  | ✅  | ✅  | ✅² | ✅ | ✅  | ✅ | ✅  | ✅  | ✅⁵  | N/A | N/A | ✅⁴ |
-| CPython 3.13³      | ✅ | ✅  | ✅  | ✅  | ✅² | ✅ | ✅  | ✅ | ✅  | ✅  | ✅⁵  | ✅ | ✅ | N/A |
-| CPython 3.14       | ✅ | ✅  | ✅  | ✅  | ✅² | ✅ | ✅  | ✅ | ✅  | ✅  | ✅⁵  | N/A | N/A | N/A |
-| PyPy 3.8 v7.3      | ✅ | ✅  | ✅  | N/A | N/A | ✅¹ | ✅¹  | ✅¹ | N/A | N/A | N/A | N/A | N/A | N/A |
-| PyPy 3.9 v7.3      | ✅ | ✅  | ✅  | N/A | N/A | ✅¹ | ✅¹  | ✅¹ | N/A | N/A | N/A | N/A | N/A | N/A |
-| PyPy 3.10 v7.3     | ✅ | ✅  | ✅  | N/A | N/A | ✅¹ | ✅¹  | ✅¹ | N/A | N/A | N/A | N/A | N/A | N/A |
-| PyPy 3.11 v7.3     | ✅ | ✅  | ✅  | N/A | N/A | ✅¹ | ✅¹  | ✅¹ | N/A | N/A | N/A | N/A | N/A | N/A |
-| GraalPy 3.11 v24.2 | ✅ | ✅  | ✅  | N/A | N/A | ✅¹ | N/A  | ✅¹ | N/A | N/A | N/A | N/A | N/A | N/A |
+|                          | macOS Intel | macOS Apple Silicon | Windows 64bit | Windows 32bit | Windows Arm64  | manylinux<br/>musllinux x86_64 | manylinux<br/>musllinux i686 | manylinux<br/>musllinux aarch64 | manylinux<br/>musllinux ppc64le | manylinux<br/>musllinux s390x | manylinux<br/>musllinux armv7l | Android | iOS | Pyodide        |
+| ------------------------ | ----------- | ------------------- | ------------- | ------------- | -------------- | ------------------------------ | ---------------------------- | ------------------------------- | ------------------------------- | ----------------------------- | ------------------------------ | ------- | --- | -------------- |
+| CPython 3.9              | ✅          | ✅                  | ✅            | ✅            | ✅<sup>2</sup> | ✅                             | ✅                           | ✅                              | ✅                              | ✅                            | ✅<sup>5</sup>                 | N/A     | N/A | N/A            |
+| CPython 3.10             | ✅          | ✅                  | ✅            | ✅            | ✅<sup>2</sup> | ✅                             | ✅                           | ✅                              | ✅                              | ✅                            | ✅<sup>5</sup>                 | N/A     | N/A | N/A            |
+| CPython 3.11             | ✅          | ✅                  | ✅            | ✅            | ✅<sup>2</sup> | ✅                             | ✅                           | ✅                              | ✅                              | ✅                            | ✅<sup>5</sup>                 | N/A     | N/A | N/A            |
+| CPython 3.12             | ✅          | ✅                  | ✅            | ✅            | ✅<sup>2</sup> | ✅                             | ✅                           | ✅                              | ✅                              | ✅                            | ✅<sup>5</sup>                 | N/A     | N/A | ✅<sup>3</sup> |
+| CPython 3.13             | ✅          | ✅                  | ✅            | ✅            | ✅<sup>2</sup> | ✅                             | ✅                           | ✅                              | ✅                              | ✅                            | ✅<sup>5</sup>                 | ✅      | ✅  | ✅             |
+| CPython 3.14             | ✅          | ✅                  | ✅            | ✅            | ✅<sup>2</sup> | ✅                             | ✅                           | ✅                              | ✅                              | ✅                            | ✅<sup>5</sup>                 | ✅      | ✅  | ✅<sup>4</sup> |
+| CPython 3.15<sup>6</sup> | ✅          | ✅                  | ✅            | ✅            | ✅<sup>2</sup> | ✅                             | ✅                           | ✅                              | ✅                              | ✅                            | ✅<sup>5</sup>                 | ✅      | ✅  | N/A            |
+| PyPy 3.9 v7.3            | ✅          | ✅                  | ✅            | N/A           | N/A            | ✅<sup>1</sup>                 | ✅<sup>1</sup>               | ✅<sup>1</sup>                  | N/A                             | N/A                           | N/A                            | N/A     | N/A | N/A            |
+| PyPy 3.10 v7.3           | ✅          | ✅                  | ✅            | N/A           | N/A            | ✅<sup>1</sup>                 | ✅<sup>1</sup>               | ✅<sup>1</sup>                  | N/A                             | N/A                           | N/A                            | N/A     | N/A | N/A            |
+| PyPy 3.11 v7.3           | ✅          | ✅                  | ✅            | N/A           | N/A            | ✅<sup>1</sup>                 | ✅<sup>1</sup>               | ✅<sup>1</sup>                  | N/A                             | N/A                           | N/A                            | N/A     | N/A | N/A            |
+| GraalPy 3.12 v25.0       | ✅          | ✅                  | ✅            | N/A           | N/A            | ✅<sup>1</sup>                 | N/A                          | ✅<sup>1</sup>                  | N/A                             | N/A                           | N/A                            | N/A     | N/A | N/A            |

-<sup>¹ PyPy & GraalPy are only supported for manylinux wheels.</sup><br>
-<sup>² Windows arm64 support is experimental.</sup><br>
-<sup>³ Free-threaded mode requires opt-in on 3.13 using [`enable`](https://cibuildwheel.pypa.io/en/stable/options/#enable).</sup><br>
-<sup>⁴ Experimental, not yet supported on PyPI, but can be used directly in web deployment. Use `--platform pyodide` to build.</sup><br>
-<sup>⁵ manylinux armv7l support is experimental. As there are no RHEL based image for this architecture, it's using an Ubuntu based image instead.</sup><br>
+<sup>**1** PyPy & GraalPy are only supported for manylinux wheels.</sup><br>
+<sup>**2** Windows arm64 support is experimental.</sup><br>
+<sup>**3** Not supported on PyPI, uses old `pyodide` tag instead of `pyemscripten`. Requires `pyodide-eol` [`enable`](https://cibuildwheel.pypa.io/en/stable/options/#enable).</sup><br>
+<sup>**4** Experimental alpha ABI, do not upload to PyPI yet.</sup><br>
+<sup>**5** manylinux armv7l support is experimental. As there are no RHEL based image for this architecture, it's using an Ubuntu based image instead.</sup><br>
+<sup>**6** Python 3.15 requires opt-in using [`enable`](https://cibuildwheel.pypa.io/en/stable/options/#enable).</sup><br>

- Builds manylinux, musllinux, macOS 10.9+ (10.13+ for Python 3.12+), and Windows wheels for CPython, PyPy, and GraalPy
- Works on GitHub Actions, Azure Pipelines, Travis CI, 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)
+- Builds manylinux, musllinux, macOS, Windows, pyemscripten, iOS, and Android wheels
+- Supports CPython, PyPy, and GraalPy
+- Works on GitHub Actions, Azure Pipelines, CircleCI, and GitLab CI
+- Bundles shared library dependencies on Linux through [auditwheel](https://github.com/pypa/auditwheel), macOS through [delocate](https://github.com/matthew-brett/delocate), and Windows through [delvewheel](https://github.com/adang1345/delvewheel)
 - Runs your library's tests against the wheel-installed version of your library

 See the [cibuildwheel 1 documentation](https://cibuildwheel.pypa.io/en/1.x/) if you need to build unsupported versions of Python, such as Python 2.
@@ -56,19 +56,19 @@ Usage

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

-|                 | Linux | macOS | Windows | Linux ARM | macOS ARM | Windows ARM | Android | iOS |
-|-----------------|-------|-------|---------|-----------|-----------|-------------|---------|-----|
-| GitHub Actions  | ✅    | ✅    | ✅       | ✅        | ✅        | ✅²         | ✅⁴      | ✅³  |
-| Azure Pipelines | ✅    | ✅    | ✅       |           | ✅        | ✅²         | ✅⁴      | ✅³  |
-| Travis CI       | ✅    |       | ✅      | ✅        |           |             | ✅⁴      |     |
-| CircleCI        | ✅    | ✅    |         | ✅        | ✅        |             | ✅⁴      | ✅³  |
-| Gitlab CI       | ✅    | ✅    | ✅      | ✅¹       | ✅        |             | ✅⁴      | ✅³  |
-| Cirrus CI       | ✅    | ✅    | ✅      | ✅        | ✅        |             | ✅⁴      |      |
+|                 | Linux | macOS | Windows | Linux ARM      | macOS ARM | Windows ARM    | Android                    | iOS                        | Pyodide        |
+| --------------- | ----- | ----- | ------- | -------------- | --------- | -------------- | -------------------------- | -------------------------- | -------------- |
+| GitHub Actions  | ✅    | ✅    | ✅      | ✅             | ✅        | ✅<sup>2</sup> | ✅<sup>4</sup>             | ✅<sup>3</sup>             | ✅             |
+| Azure Pipelines | ✅    | ✅    | ✅      |                | ✅        | ✅<sup>2</sup> | ✅<sup>4</sup>             | ✅<sup>3</sup>             | ✅<sup>5</sup> |
+| CircleCI        | ✅    | ✅    |         | ✅             | ✅        |                | ✅<sup>4</sup><sup>5</sup> | ✅<sup>3</sup><sup>5</sup> | ✅<sup>5</sup> |
+| GitLab CI       | ✅    | ✅    | ✅      | ✅<sup>1</sup> | ✅        |                | ✅<sup>4</sup><sup>5</sup> | ✅<sup>3</sup><sup>5</sup> | ✅<sup>5</sup> |
+
+<sup>**1** [Requires emulation](https://cibuildwheel.pypa.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>**2** [Uses cross-compilation](https://cibuildwheel.pypa.io/en/stable/faq/#windows-arm64). It is not possible to test `arm64` on this CI platform.</sup><br>
+<sup>**3** Requires a macOS runner; runs tests on the simulator for the runner's architecture. </sup><br>
+<sup>**4** Building for Android requires the runner to be Linux x86_64, macOS ARM64 or macOS x86_64. Testing has [additional requirements](https://cibuildwheel.pypa.io/en/stable/platforms/#android).</sup><br>
+<sup>**5** Builds may work, but are untested in cibuildwheel's CI.</sup><br>

-<sup>¹ [Requires emulation](https://cibuildwheel.pypa.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.pypa.io/en/stable/faq/#windows-arm64). It is not possible to test `arm64` on this CI platform.</sup><br>
-<sup>³ Requires a macOS runner; runs tests on the simulator for the runner's architecture.</sup><br>
-<sup>⁴ Building for Android requires the runner to be Linux x86_64, macOS ARM64 or macOS x86_64. Testing has [additional requirements](https://cibuildwheel.pypa.io/en/stable/platforms/#android).</sup><br>
 <!--intro-end-->

 Example setup
@@ -88,16 +88,18 @@ jobs:
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
-        os: [ubuntu-latest, ubuntu-24.04-arm, windows-latest, windows-11-arm, macos-13, macos-latest]
+        os: [ubuntu-latest, ubuntu-24.04-arm, windows-latest, windows-11-arm, macos-15-intel, macos-latest]

    steps:
-      - uses: actions/checkout@v5
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false

      # Used to host cibuildwheel
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6

      - name: Install cibuildwheel
-        run: python -m pip install cibuildwheel==3.1.4
+        run: python -m pip install cibuildwheel==4.0.0

      - name: Build wheels
        run: python -m cibuildwheel --output-dir wheelhouse
@@ -106,7 +108,7 @@ jobs:
        #   CIBW_SOME_OPTION: value
        #   ...

-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v6
        with:
          name: cibw-wheels-${{ matrix.os }}-${{ strategy.job-index }}
          path: ./wheelhouse/*.whl
@@ -124,6 +126,11 @@ The following diagram summarises the steps that cibuildwheel takes on each platf

 <sup>Explore an interactive version of this diagram [in the docs](https://cibuildwheel.pypa.io/en/stable/#how-it-works).</sup>

+> [!WARNING]
+> Building and testing wheels executes arbitrary code from your project and its dependencies. Although cibuildwheel uses OCI containers and Pyodide for some builds, these provide no security guarantees - the code you're building and testing has full access to the environment that's invoking cibuildwheel.
+>
+> If you cannot trust all the code that's pulled in, maintain good security hygiene: keep the job that builds distributions separate from the job that uploads them to PyPI, handle secrets and credentials with care and rotate them regularly, and follow the principle of least privilege when granting permissions. Do not store sensitive data on CI runners.
+

 <!--[[[cog from readme_options_table import get_table; print(get_table()) ]]]-->

@@ -144,11 +151,14 @@ The following diagram summarises the steps that cibuildwheel takes on each platf
 |  | [`before-all`](https://cibuildwheel.pypa.io/en/stable/options/#before-all) | Execute a shell command on the build system before any wheels are built. |
 |  | [`before-build`](https://cibuildwheel.pypa.io/en/stable/options/#before-build) | Execute a shell command preparing each wheel's build |
 |  | [`xbuild-tools`](https://cibuildwheel.pypa.io/en/stable/options/#xbuild-tools) | Binaries on the path that should be included in an isolated cross-build environment. |
+|  | [`xbuild-files`](https://cibuildwheel.pypa.io/en/stable/options/#xbuild-files) | Platform-specific files in the build environment |
 |  | [`repair-wheel-command`](https://cibuildwheel.pypa.io/en/stable/options/#repair-wheel-command) | Execute a shell command to repair each built wheel |
 |  | [`manylinux-*-image`<br>`musllinux-*-image`](https://cibuildwheel.pypa.io/en/stable/options/#linux-image) | Specify manylinux / musllinux container images |
 |  | [`container-engine`](https://cibuildwheel.pypa.io/en/stable/options/#container-engine) | Specify the container engine to use when building Linux wheels |
 |  | [`dependency-versions`](https://cibuildwheel.pypa.io/en/stable/options/#dependency-versions) | Control the versions of the tools cibuildwheel uses |
 |  | [`pyodide-version`](https://cibuildwheel.pypa.io/en/stable/options/#pyodide-version) | Specify the Pyodide version to use for `pyodide` platform builds |
+| **Auditing** | [`audit-requires`](https://cibuildwheel.pypa.io/en/stable/options/#audit-requires) | Install Python dependencies for the audit step |
+|  | [`audit-command`](https://cibuildwheel.pypa.io/en/stable/options/#audit-command) | Use a tool to check wheels before the end of the run |
 | **Testing** | [`test-command`](https://cibuildwheel.pypa.io/en/stable/options/#test-command) | The command to test each built wheel |
 |  | [`before-test`](https://cibuildwheel.pypa.io/en/stable/options/#before-test) | Execute a shell command before testing each wheel |
 |  | [`test-sources`](https://cibuildwheel.pypa.io/en/stable/options/#test-sources) | Paths that are copied into the working directory of the tests |
@@ -157,12 +167,13 @@ The following diagram summarises the steps that cibuildwheel takes on each platf
 |  | [`test-groups`](https://cibuildwheel.pypa.io/en/stable/options/#test-groups) | Specify test dependencies from your project's `dependency-groups` |
 |  | [`test-skip`](https://cibuildwheel.pypa.io/en/stable/options/#test-skip) | Skip running tests on some builds |
 |  | [`test-environment`](https://cibuildwheel.pypa.io/en/stable/options/#test-environment) | Set environment variables for the test environment |
+|  | [`test-runtime`](https://cibuildwheel.pypa.io/en/stable/options/#test-runtime) | Controls how the tests will be executed. |
 | **Debugging** | [`debug-keep-container`](https://cibuildwheel.pypa.io/en/stable/options/#debug-keep-container) | Keep the container after running for debugging. |
 |  | [`debug-traceback`](https://cibuildwheel.pypa.io/en/stable/options/#debug-traceback) | Print full traceback when errors occur. |
 |  | [`build-verbosity`](https://cibuildwheel.pypa.io/en/stable/options/#build-verbosity) | Increase/decrease the output of the build |


-<!--[[[end]]] (sum: FxE3nIgFiY) -->
+<!--[[[end]]] (sum: Of/28Z7Nut) -->

 These options can be specified in a pyproject.toml file, or as environment variables, see [configuration docs](https://cibuildwheel.pypa.io/en/latest/configuration/).

@@ -177,37 +188,39 @@ Here are some repos that use cibuildwheel.

 | Name                              | CI | OS | Notes |
 |-----------------------------------|----|----|:------|
-| [scikit-learn][]                  | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | The machine learning library. A complex but clean config using many of cibuildwheel's features to build a large project with Cython and C++ extensions.  |
+| [scikit-learn][]                  | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] ![pyodide icon][] | The machine learning library. A complex but clean config using many of cibuildwheel's features to build a large project with Cython and C++ extensions.  |
 | [duckdb][]                        | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | DuckDB is an analytical in-process SQL database management system |
 | [pytorch-fairseq][]               | ![github icon][] | ![apple icon][] ![linux icon][] | Facebook AI Research Sequence-to-Sequence Toolkit written in Python. |
-| [NumPy][]                         | ![github icon][] ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | The fundamental package for scientific computing with Python. |
-| [Tornado][]                       | ![github icon][] | ![linux icon][] ![apple icon][] ![windows icon][] | Tornado is a Python web framework and asynchronous networking library. Uses stable ABI for a small C extension. |
+| [NumPy][]                         | ![github icon][] ![travisci icon][] | ![windows icon][] ![apple icon][] ![linux icon][] ![pyodide icon][] | The fundamental package for scientific computing with Python. |
 | [NCNN][]                          | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | ncnn is a high-performance neural network inference framework optimized for the mobile platform |
-| [Matplotlib][]                    | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | The venerable Matplotlib, a Python library with C++ portions |
+| [Matplotlib][]                    | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] ![pyodide icon][] | The venerable Matplotlib, a Python library with C++ portions |
+| [Tornado][]                       | ![github icon][] | ![linux icon][] ![apple icon][] ![windows icon][] | Tornado is a Python web framework and asynchronous networking library. Uses stable ABI for a small C extension. |
 | [MyPy][]                          | ![github icon][] | ![apple icon][] ![linux icon][] ![windows icon][] | The compiled version of MyPy using MyPyC. |
 | [Prophet][]                       | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Tool for producing high quality forecasts for time series data that has multiple seasonality with linear or non-linear growth. |
-| [Kivy][]                          | ![github icon][] | ![windows icon][] ![apple icon][] ![linux icon][] | Open source UI framework written in Python, running on Windows, Linux, macOS, Android and iOS |
+| [Triton][]                        | ![github icon][] | ![linux icon][] | Self hosted runners |

 [scikit-learn]: https://github.com/scikit-learn/scikit-learn
 [duckdb]: https://github.com/duckdb/duckdb
 [pytorch-fairseq]: https://github.com/facebookresearch/fairseq
 [NumPy]: https://github.com/numpy/numpy
-[Tornado]: https://github.com/tornadoweb/tornado
 [NCNN]: https://github.com/Tencent/ncnn
 [Matplotlib]: https://github.com/matplotlib/matplotlib
+[Tornado]: https://github.com/tornadoweb/tornado
 [MyPy]: https://github.com/mypyc/mypy_mypyc-wheels
 [Prophet]: https://github.com/facebook/prophet
-[Kivy]: https://github.com/kivy/kivy
+[Triton]: https://github.com/openai/triton

 [github icon]: docs/data/readme_icons/github.svg
 [azurepipelines icon]: docs/data/readme_icons/azurepipelines.svg
 [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
+[android icon]: docs/data/readme_icons/android.svg
+[ios icon]: docs/data/readme_icons/ios.svg
+[pyodide icon]: docs/data/readme_icons/pyodide.svg

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

@@ -216,7 +229,7 @@ Here are some repos that use cibuildwheel.
 Legal note
 ----------

-Since `cibuildwheel` repairs the wheel with `delocate` or `auditwheel`, it might automatically bundle dynamically linked libraries from the build machine.
+Since `cibuildwheel` repairs the wheel with `delocate`, `auditwheel`, or `delvewheel`, it might automatically bundle dynamically linked libraries from the build machine.

 It helps ensure that the library can run without any dependencies outside of the pip toolchain.

@@ -227,73 +240,105 @@ Changelog

 <!-- [[[cog from readme_changelog import mini_changelog; print(mini_changelog()) ]]] -->

-### v3.1.4
+### v4.0.0

-_19 August 2025_
+_7 June 2026_

- ✨ Add a `--clean-cache` command to clean up our cache (#2489)
- 🛠 Update Python to 3.14rc2 and other patch version bumps (#2542, #2556)
- 🛠 Update Pyodide to 0.28.2 (#2562, #2558)
- 🐛 Fix resolution with `pyodide-build` when `dependency-versions` is set (#2548)
- 🐛 Set `CMAKE_FIND_ROOT_PATH_MODE_PACKAGE` to `BOTH` on Android (#2547)
- 🐛 Add `patchelf` dependency for platforms that can build Android wheels (#2552)
- 🐛 Ignore empty values for `CIBW_ARCHS` like most other environment variables (#2541)
- 💼 The `color` and `suggest_on_error` argparse options are now default in 3.14rc1+ (#2554)
- 💼 Use the virtualenv release URL instead of blob URL (should be more robust) (#2555)
- 🧪 For iOS, lowering to macos-14 is needed for now due to issues with GitHub's runner images (#2557)
- 🧪 Split out platforms iOS and Android in our tests (#2519)
- 🧪 Fix and enable doctests (#2546)
- 📚 Improve our docs on free-threading (#2549)
+See @henryiii's [release post](https://iscinumpy.dev/post/cibuildwheel-4-0-0/) for more info on new features!
+
+- 🌟 Adds wheel auditing with `abi3audit` as a default after the repair step, with new [`audit-requires`](https://cibuildwheel.pypa.io/en/stable/options/#audit-requires) and [`audit-command`](https://cibuildwheel.pypa.io/en/stable/options/#audit-command) options (#2805)
+- 🌟 Adds `pyemscripten` platform tag support (PEP 783), updates Pyodide to 314.0.0a2, and adds a `pyodide-eol` [`enable`](https://cibuildwheel.pypa.io/en/stable/options/#enable) flag for building end-of-life Pyodide versions (#2812, #2848)
+- 🌟 Sets up `delvewheel` as the default [`repair-wheel-command`](https://cibuildwheel.pypa.io/en/stable/options/#repair-wheel-command) for Windows, so extension module DLLs are now bundled automatically. Skip by setting it to empty if not needed. (#2831)
+- ✨ Adds CPython 3.15 support, under the [`enable` option](https://cibuildwheel.pypa.io/en/stable/options/#enable) `cpython-prerelease`. This version of cibuildwheel uses 3.15.0b1. (#2833, #2850)
+
+    _While CPython is in beta, the ABI can change, so your wheels might not be compatible with the final release. For this reason, we don't recommend distributing wheels until RC1, at which point 3.15 will be available in cibuildwheel without the flag._
+- ✨ Adds CPython 3.15 support for iOS and Android (#2857, #2858)
+- ✨ Adds Android improvements for building NumPy and related packages, including auditwheel support, pkg-config and Fortran configuration, and the [`xbuild-files`](https://cibuildwheel.pypa.io/en/stable/options/#xbuild-files) option (#2695)
+- ✨ Adds `CIBUILDWHEEL_BUILD_IDENTIFIER` environment variable set to the current build identifier (e.g. `cp311-manylinux_x86_64`) during per-build steps (#2872)
+- ✨ Adds `{project}` and `{package}` placeholders to [`config-settings`](https://cibuildwheel.pypa.io/en/stable/options/#config-settings) (#2827)
+- ⚠️ Drops support for Python 3.8 (#2686)
+- ⚠️ Removes the experimental CPython 3.13 free-threading builds and the `cpython-freethreading` [`enable`](https://cibuildwheel.pypa.io/en/stable/options/#enable) option. CPython 3.14+ free-threading support remains available without the enable flag. (#2684)
+- ⚠️ Drops support for Cirrus CI, which is shutting down June 1, 2026 (#2817)
+- ⚠️ Drops GraalPy 3.11 (gp311) support, as agreed in #2741, and removes GraalPy 24-only workarounds (#2895)
+- 🔐 Adds SHA256 verification for direct downloads of Python interpreters, virtualenv, and python-build-standalone assets (#2873)
+- 🔐 Adds tarfile extraction filter for safe archive extraction (#2856)
+- 🐛 Fixes `UV_PYTHON` not being set for [`before-build`](https://cibuildwheel.pypa.io/en/stable/options/#before-build) on Linux when using `uv` as the [`build-frontend`](https://cibuildwheel.pypa.io/en/stable/options/#build-frontend) (#2830)
+- 🐛 Fixes detection of musl libc when downloading python-build-standalone, which previously always selected the gnu asset on musl hosts like Alpine (#2889)
+- 🐛 Fixes [`config-settings`](https://cibuildwheel.pypa.io/en/stable/options/#config-settings) expansion when `{project}` or `{package}` contains spaces or backslashes (#2886)
+- 🐛 Prevents deadlock when `linux32` fails and forwards platform args to the sanity check (#2880, #2888)
+- 🐛 Fixes container resource leaks on start failure and during teardown (#2879, #2887)
+- 🐛 Removes potential partial cache-population in case of error (#2892)
+- 🐛 Raises a clear error when `ANDROID_API_LEVEL` is not an integer (#2891)
+- 🐛 Replaces assert with proper exception in python-build-standalone (#2859)
+- 🐛 Uses ConfigurationError when `package_dir` is outside cwd instead of a generic Exception (#2898)
+- 🛠 Updates dependencies and container pins (#2893, #2882, #2874, #2868, #2862, #2884, #2845, #2837, #2818, #2810, #2838, #2813)
+- 🛠 Updates Android to Python 3.13.13 and 3.14.4 (#2821)
+- 🛠 Applies Pyodide-specific patches to the Emscripten toolchain installation (#2800)
+- 🛠 Uses `python -V -V` for Windows build diagnostics (#2832)
+- 🛠 Simplifies pinned container image lookup (#2897)
+- 🛠 Minor fixups across error messages, OCI container, and options (#2860)
+- 💼 Adds PEP 723 metadata for `bin/` scripts and drops the `bin` dependency group (#2819)
+- 💼 Improves Azure test reliability with retries and caching (#2890)
+- 💼 Fixes Windows GitLab CI test running (#2870)
+- 💼 Updates CI action pins and dev dependencies (#2902, #2867, #2851, #2843, #2826, #2823, #2820, #2807)
+- 💼 Adds agent and copilot setup files (#2861)
+- 💼 Uses `if TYPE_CHECKING:` blocks (#2866, #2864)
+- 🧪 Fixes Android tests using the `uv` frontend (#2809)
+- 🧪 Fixes the update-dependencies workflow to use `uv` to run `nox` (#2808)
+- 🧪 Adds unit tests for `OCIContainer._get_platform_args` (#2878)
+- 📚 Updates documentation for delvewheel as the default Windows [`repair-wheel-command`](https://cibuildwheel.pypa.io/en/stable/options/#repair-wheel-command), including the build diagram, schema defaults, and legal note (#2877, #2853, #2891)
+- 📚 Documents platform-specific [`before-build`](https://cibuildwheel.pypa.io/en/stable/options/#before-build) configuration (#2834)
+- 📚 Updates the "How it works" diagram with details of Android, iOS, and Pyodide builds (#2816)
+- 📚 Adds Pyodide icon and regenerates working examples data for Android, iOS, and Pyodide (#2815, #2811)
+- 📚 Adds intersphinx support for external documentation linking (#2871)
+- 📚 Adds instructions for building CUDA wheels and fixes manylinux container references in FAQ (#2896, #2900)
+- 📚 Links back to source in docs (#2806)
+- 📚 Removes outdated numpy info (#2855)


-### v3.1.3
+### v3.4.1

-_1 August 2025_
+_2 April 2026_

- 🐛 Fix bug where "latest" dependencies couldn't update to pip 25.2 on Windows (#2537)
- 🧪 Use pytest-rerunfailures to improve some of our iOS/Android tests (#2527, #2539)
- 🧪 Remove some GraalPy Windows workarounds in our tests (#2501)
+- ⚠️ Building for the experimental CPython 3.13 free-threading variant is now deprecated. That functionality will be removed in the next minor release. The [`enable`](https://cibuildwheel.pypa.io/en/stable/options/#enable) option `cpython-freethreading` is therefore also deprecated. Builds specifying `enable = "all"` no longer select `cpython-freethreading`. CPython 3.14 free-threading support remains available without the `enable` flag. (#2787)
+- 🐛 iOS builds will no longer skip `repair-wheel-command` if it's defined in config (#2761)
+- 🐛 Fix bug causing `uv` to fail when environments define PYTHON_VERSION or UV_PYTHON, conflicting with our venvs (#2795)
+- ✨ cibuildwheel prints the selected build identifiers at the start of the build. (#2785)
+- 🔐 The GitHub Action now references other actions with a full SHA (#2744)

+### v3.4.0

-### v3.1.2
+_5 March 2026_

-_29 July 2025_
+- 🌟 You can now build wheels using `uv` as a build frontend. This should improve performance, especially if your project has lots of build dependencies. To use, set [`build-frontend`](https://cibuildwheel.pypa.io/en/stable/options/#build-frontend) to `uv`. (#2322)
+- ⚠️ We no longer support running on Travis CI. It may continue working but we don't run tests there anymore so we can't be sure. (#2682)
+- ✨ Improvements to building rust wheels on Android (#2650)
+- 🛠 Update Pyodide to 0.29.3 (#2719, #2733)
+- 🐛 Fix bug with the GitHub Action on Windows, where PATH was getting unnecessarily changed, causing issues with meson builds. (#2723)
+- ✨ Add support for quiet setting on `build` and `uv` from the cibuildwheel `build-verbosity` setting. (#2737)
+- 📚 Docs updates, including guidance on using Meson on Windows (#2718)

- ⚠️  Add an error if `CIBW_FREE_THREADING_SUPPORT` is set; you are likely missing 3.13t wheels, please use the `enable`/`CIBW_ENABLE` (#2520)
- 🛠 `riscv64` now enabled if you target that architecture, it's now supported on PyPI (#2509)
- 🛠 Add warning when using `cpython-experimental-riscv64` (no longer needed) (#2526, #2528)
- 🛠 iOS versions bumped, fixing issues with 3.14 (now RC 1) (#2530)
- 🐛 Fix bug in Android running wheel from our GitHub Action (#2517)
- 🐛 Fix warning when using `test-skip` of `"*-macosx_universal2:arm64"` (#2522)
- 🐛 Fix incorrect number of wheels reported in logs, again (#2517)
- 📚 We welcome our Android platform maintainer (#2516)
+### v3.3.1

+_5 January 2026_

-### v3.1.1
+- 🛠 Update dependencies and container pins, including updating to CPython 3.14.2. (#2708)

-_24 July 2025_
+### v3.3.0

- 🐛 Fix a bug showing an incorrect wheel count at the end of execution, and misrepresenting test-only runs in the GitHub Action summary (#2512)
- 📚 Docs fix (#2510)
+_12 November 2025_

-### v3.1.0
+- 🐛 Fix an incompatibility with Docker v29 (#2660)
+- ✨ Adds `test-runtime` option, to customise how tests on simulated/emulated environments are run (#2636)
+- ✨ Adds support for new `manylinux_2_35` images on 32-bit ARM `armv7l`, offering better C++20 compatibility (#2656)
+- ✨ `build[uv]` is now supported on Android (#2587)
+- ✨ You can now install extras (such as `uv`) with a simple option on the GitHub Action (#2630)
+- ✨ `{project}` and `{package}` placeholders are now supported in `repair-wheel-command` (#2589)
+- 🛠 The versions set with `dependency-versions` no longer constrain packages specified by your `build-system.requires`. Previously, on platforms other than Linux, the constraints in this option would remain in the environment during the build. This has been tidied up make behaviour more consistent between platforms, and to prevent version conflicts. (#2583)
+- 🛠 Improve the handling of `test-command` on Android, enabling more options to be passed (#2590)
+- 📚 Docs improvements (#2618)

-_23 July 2025_
-
-
- 🌟 CPython 3.14 wheels are now built by default - without the `"cpython-prerelease"` `enable` set. It's time to build and upload these wheels to PyPI! This release includes CPython 3.14.0rc1, which is guaranteed to be ABI compatible with the final release. (#2507) Free-threading is no longer experimental in 3.14, so you have to skip it explicitly with `'cp31?t-*'` if you don't support it yet. (#2503)
- 🌟 Adds the ability to [build wheels for Android](https://cibuildwheel.pypa.io/en/stable/platforms/#android)! Set the [`platform` option](https://cibuildwheel.pypa.io/en/stable/options/#platform) to `android` on Linux or macOS to try it out! (#2349)
- 🌟 Adds Pyodide 0.28, which builds 3.13 wheels (#2487)
- ✨ Support for 32-bit `manylinux_2_28` (now a consistent default) and `manylinux_2_34` added (#2500)
- 🛠 Improved summary, will also use markdown summary output on GHA (#2469)
- 🛠 The riscv64 images now have a working default (as they are now part of pypy/manylinux), but are still experimental (and behind an `enable`) since you can't push them to PyPI yet (#2506)
- 🛠 Fixed a typo in the 3.9 MUSL riscv64 identifier (`cp39-musllinux_ricv64` -> `cp39-musllinux_riscv64`) (#2490)
- 🛠 Mistyping `--only` now shows the correct possibilities, and even suggests near matches on Python 3.14+ (#2499)
- 🛠 Only support one output from the repair step on linux like other platforms; auditwheel fixed this over four years ago! (#2478)
- 💼 We now use pattern matching extensively (#2434)
- 📚 We now have platform maintainers for our special platforms and interpreters! (#2481)
-
-<!-- [[[end]]] (sum: loynkRqdzf) -->
+<!-- [[[end]]] (sum: B1EtXSS7u7) -->

 ---

@@ -320,11 +365,11 @@ Core:
 - Matthieu Darbois [@mayeut](https://github.com/mayeut)
 - Henry Schreiner [@henryiii](https://github.com/henryiii)
 - Grzegorz Bokota [@Czaki](https://github.com/Czaki)
+- Agriya Khetarpal [@agriyakhetarpal](https://github.com/agriyakhetarpal) (also Pyodide)

 Platform maintainers:

 - Russell Keith-Magee [@freakboy3742](https://github.com/freakboy3742) (iOS)
- Agriya Khetarpal [@agriyakhetarpal](https://github.com/agriyakhetarpal) (Pyodide)
 - Hood Chatham [@hoodmane](https://github.com/hoodmane) (Pyodide)
 - Gyeongjae Choi [@ryanking13](https://github.com/ryanking13) (Pyodide)
 - Tim Felgentreff [@timfel](https://github.com/timfel) (GraalPy)
@@ -17,6 +17,10 @@ inputs:
    description: 'Build a specific wheel only. No need for arch/platform if this is set'
    required: false
    default: ''
+  extras:
+    description: 'Comma-separated list of extras to install'
+    required: false
+    default: ''
 branding:
  icon: package
  color: yellow
@@ -24,17 +28,18 @@ branding:
 runs:
  using: composite
  steps:
-    - uses: actions/setup-python@v5
+    - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
      id: python
      with:
-        python-version: "3.11 - 3.13"
+        python-version: "3.11 - 3.14"
        update-environment: false

    - id: cibw
      run: |
-        # Install cibuildwheel
-        "${{ steps.python.outputs.python-path }}" -u << "EOF"
+        # Install cibuildwheel and build the command line
+        "$PYTHON" -u << "EOF"
        import os
+        import shlex
        import shutil
        import sys
        import venv
@@ -42,6 +47,8 @@ runs:
        from pathlib import Path
        from subprocess import run

+        EXTRAS = set(e.strip() for e in os.environ.get("INPUT_EXTRAS", "").split(",") if e.strip())
+

        class EnvBuilder(venv.EnvBuilder):
            def __init__(self):
@@ -53,39 +60,88 @@ runs:
            def post_setup(self, context):
                super().post_setup(context)
                self.bin_path = Path(context.env_exe).parent
-                run([sys.executable, "-m", "pip", "--python", context.env_exe, "install", r"${{ github.action_path }}"], check=True)
+                install_spec = os.environ["GITHUB_ACTION_PATH"]
+                if EXTRAS:
+                    install_spec += f"[{','.join(sorted(EXTRAS))}]"
+                run([sys.executable, "-m", "pip", "--python", context.env_exe, "install", install_spec], check=True)


        print("::group::Install cibuildwheel")
-        venv_path = Path(r"${{ runner.temp }}") / "cibw"
+        venv_path = Path(os.environ["RUNNER_TEMP"]) / "cibw"
        if venv_path.exists():
            shutil.rmtree(venv_path)
+
        builder = EnvBuilder()
        builder.create(venv_path)
-        cibw_path = [path for path in builder.bin_path.glob("cibuildwheel*") if path.stem == "cibuildwheel"][0]
+        exposed_binaries = {"cibuildwheel"}
+
+        if "uv" in EXTRAS:
+            exposed_binaries.add("uv")
+        clean_bin_path = builder.bin_path.parent / f"{builder.bin_path.name}.clean"
+        clean_bin_path.mkdir()
+
+        for path in list(builder.bin_path.iterdir()):
+            if path.stem in exposed_binaries:
+                try:
+                    os.symlink(path, clean_bin_path / path.name)
+                except OSError:
+                    shutil.copy2(path, clean_bin_path / path.name)
+
+        cibw_bin = [p for p in builder.bin_path.glob("cibuildwheel*") if p.stem == "cibuildwheel"][0]
+
+        # Build the command line
+        cmd_args = [str(cibw_bin), os.environ["INPUT_PACKAGE_DIR"]]
+
+        if output_dir := os.environ.get("INPUT_OUTPUT_DIR"):
+            cmd_args += ["--output-dir", output_dir]
+
+        if config_file := os.environ.get("INPUT_CONFIG_FILE"):
+            cmd_args += ["--config-file", config_file]
+
+        if only := os.environ.get("INPUT_ONLY"):
+            cmd_args += ["--only", only]
+
+        cmd_bash = shlex.join(cmd_args)
+
+        def pwsh_quote(text):
+            # Wrap in single quotes and double-up any existing single quotes
+            return "'" + str(text).replace("'", "''") + "'"
+
+        # Prepend '& ' so PowerShell executes the quoted binary path
+        cmd_pwsh = "& " + " ".join(pwsh_quote(arg) for arg in cmd_args)
+
        with open(os.environ["GITHUB_OUTPUT"], "at") as f:
-            f.write(f"cibw-path={cibw_path}\n")
+            f.write(f"prepend-path={clean_bin_path}\n")
+            f.write(f"cmd-bash={cmd_bash}\n")
+            f.write(f"cmd-pwsh={cmd_pwsh}\n")
+
        print("::endgroup::")
        EOF
      shell: bash
+      env:
+        PYTHON: ${{ steps.python.outputs.python-path }}
+        INPUT_PACKAGE_DIR: ${{ inputs.package-dir }}
+        INPUT_OUTPUT_DIR: ${{ inputs.output-dir }}
+        INPUT_CONFIG_FILE: ${{ inputs.config-file }}
+        INPUT_ONLY: ${{ inputs.only }}
+        INPUT_EXTRAS: ${{ inputs.extras }}

    # Redirecting stderr to stdout to fix interleaving issue in Actions.
-    - run: >
-        "${{ steps.cibw.outputs.cibw-path }}"
-        "${{ inputs.package-dir }}"
-        ${{ inputs.output-dir != ''  && format('--output-dir "{0}"', inputs.output-dir) || ''}}
-        ${{ inputs.config-file != '' && format('--config-file "{0}"', inputs.config-file) || ''}}
-        ${{ inputs.only != ''        && format('--only "{0}"', inputs.only) || ''}}
-        2>&1
+    - run: |
+        export PATH="$CIBW_PREPEND_PATH:$PATH"
+        eval "$CIBW_CMD_BASH" 2>&1
      shell: bash
      if: runner.os != 'Windows'
+      env:
+        CIBW_PREPEND_PATH: ${{ steps.cibw.outputs.prepend-path }}
+        CIBW_CMD_BASH: ${{ steps.cibw.outputs.cmd-bash }}

    # Windows needs powershell to interact nicely with Meson
-    - run: >
-        & "${{ steps.cibw.outputs.cibw-path }}"
-        "${{ inputs.package-dir }}"
-        ${{ inputs.output-dir != ''  && format('--output-dir "{0}"', inputs.output-dir) || ''}}
-        ${{ inputs.config-file != '' && format('--config-file "{0}"', inputs.config-file) || ''}}
-        ${{ inputs.only != ''        && format('--only "{0}"', inputs.only) || ''}}
+    - run: |
+        $env:PATH = "$env:CIBW_PREPEND_PATH;$env:PATH"
+        Invoke-Expression $env:CIBW_CMD_PWSH
      shell: pwsh
      if: runner.os == 'Windows'
+      env:
+        CIBW_PREPEND_PATH: ${{ steps.cibw.outputs.prepend-path }}
+        CIBW_CMD_PWSH: ${{ steps.cibw.outputs.cmd-pwsh }}
@@ -19,39 +19,54 @@ jobs:
 - job: tests
  strategy:
    matrix:
-      linux_311:
+      linux_313:
        imageName: "ubuntu-latest"
-        pythonVersion: "3.11"
+        pythonVersion: "3.13"
        testSelect: "native"
-      android_311:
+      android_313:
        imageName: "ubuntu-latest"
-        pythonVersion: "3.11"
+        pythonVersion: "3.13"
        testSelect: "android"
-      macos_311:
+      macos_313:
        imageName: "macos-latest"
-        pythonVersion: "3.11"
+        pythonVersion: "3.13"
        testSelect: "native"
-      ios_311:
-        imageName: "macos-latest"
-        pythonVersion: "3.11"
+      ios_313:
+        imageName: "macos-14"  # See https://github.com/actions/runner-images/issues/12777
+        pythonVersion: "3.13"
        testSelect: "ios"
-      android_macos_311:
+      android_macos_313:
        imageName: "macos-latest"
-        pythonVersion: "3.11"
+        pythonVersion: "3.13"
        testSelect: "android"
-      windows_311:
+      windows_313:
        imageName: "windows-latest"
-        pythonVersion: "3.11"
+        pythonVersion: "3.13"
        testSelect: "native"
  timeoutInMinutes: 180
  pool:
    vmImage: $(imageName)
+  variables:
+    # Relocate cibuildwheel's download cache (interpreters) and the per-worker
+    # test pip caches (which live under it) to a stable, cacheable path.
+    CIBW_CACHE_PATH: $(Pipeline.Workspace)/.cibw-cache

  steps:
    - task: UsePythonVersion@0
      inputs:
        versionSpec: $(pythonVersion)

+    - task: Cache@2
+      displayName: 'Cache cibuildwheel downloads'
+      inputs:
+        # build-platforms.toml carries the interpreter pins; bump the version
+        # prefix to force a cold cache. restoreKeys lets a stale cache still seed
+        # a new run (cibuildwheel re-downloads only what's missing).
+        key: 'cibw-cache | v1 | "$(imageName)" | "$(testSelect)" | cibuildwheel/resources/build-platforms.toml'
+        restoreKeys: |
+          cibw-cache | v1 | "$(imageName)" | "$(testSelect)"
+        path: $(CIBW_CACHE_PATH)
+
    - task: JavaToolInstaller@0
      condition: and(eq(variables['testSelect'], 'android'), eq(variables['Agent.OS'], 'Linux'))
      inputs:
@@ -1,7 +1,7 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script

 # /// script
-# dependencies = ["click", "packaging"]
+# dependencies = ["click", "packaging", "prek"]
 # ///


@@ -68,8 +68,8 @@ def bump_version() -> None:
        sys.exit(1)

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

    try:
@@ -139,7 +139,7 @@ def bump_version() -> None:
    # run pre-commit to update the README changelog
    subprocess.run(
        [
-            "pre-commit",
+            "prek",
            "run",
            "--files=docs/changelog.md",
        ],
@@ -149,7 +149,7 @@ def bump_version() -> None:
    # run pre-commit to check that no errors occurred on the second run
    subprocess.run(
        [
-            "pre-commit",
+            "prek",
            "run",
            "--files=docs/changelog.md",
        ],
@@ -1,4 +1,14 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script
+
+# /// script
+# dependencies = [
+#   "click",
+#   "cibuildwheel",
+# ]
+#
+# [tool.uv.sources]
+# cibuildwheel = { path = ".." }
+# ///

 import sys
 import textwrap
@@ -1,4 +1,4 @@
-#!/usr/bin/env -S uv run -q
+#!/usr/bin/env -S uv run --script

 # /// script
 # dependencies = ["pyyaml"]
@@ -15,6 +15,8 @@ parser = argparse.ArgumentParser(allow_abbrev=False)
 parser.add_argument("--schemastore", action="store_true", help="Generate schema_store version")
 args = parser.parse_args()

+# The defaults in the schema are used by external tools for validation and IDE support. They
+# should match the values in defaults.toml, which are used by cibuildwheel itself.
 starter = """
 $schema: http://json-schema.org/draft-07/schema#
 $id: https://github.com/pypa/cibuildwheel/blob/main/cibuildwheel/resources/cibuildwheel.schema.json
@@ -28,8 +30,6 @@ $defs:
    description: How to inherit the parent's value.
  enable:
    enum:
-      - cpython-experimental-riscv64
-      - cpython-freethreading
      - cpython-prerelease
      - graalpy
      - pyodide-prerelease
@@ -40,6 +40,12 @@ additionalProperties: false
 description: cibuildwheel's settings.
 type: object
 properties:
+  audit-command:
+    description: Execute a shell command to audit each wheel after it is repaired. Use {wheel} for each wheel path, or {abi3_wheel} to only audit abi3 wheels.
+    type: string_array
+  audit-requires:
+    description: Install Python dependencies for the audit step.
+    type: string_array
  archs:
    description: Change the architectures built on your machine by default.
    type: string_array
@@ -58,21 +64,23 @@ properties:
    type: string_array
  build-frontend:
    default: default
-    description: Set the tool to use to build, either "build" (default), "build[uv]", or "pip"
+    description: Set the tool to use to build, either "build" (default), "build[uv]", "uv", or "pip"
    oneOf:
-      - enum: [pip, build, "build[uv]", default]
+      - enum: [pip, build, "build[uv]", uv, default]
      - type: string
        pattern: '^pip; ?args:'
      - type: string
        pattern: '^build; ?args:'
      - type: string
        pattern: '^build\\[uv\\]; ?args:'
+      - type: string
+        pattern: '^uv; ?args:'
      - type: object
        additionalProperties: false
        required: [name]
        properties:
          name:
-            enum: [pip, build, "build[uv]"]
+            enum: [pip, build, "build[uv]", uv]
          args:
            type: array
            items:
@@ -194,6 +202,9 @@ properties:
  xbuild-tools:
    description: Binaries on the path that should be included in an isolated cross-build environment
    type: string_array
+  xbuild-files:
+    description: Platform-specific files in the build environment
+    type: string_table_array
  pyodide-version:
    type: string
    description: Specify the version of Pyodide to use
@@ -224,6 +235,24 @@ properties:
  test-environment:
    description: Set environment variables for the test environment
    type: string_table
+  test-runtime:
+    description: Additional configuration for the test runner
+    oneOf:
+      - type: string
+        pattern: '^$'
+      - type: object
+        additionalProperties: false
+      - type: string
+        pattern: 'args:'
+      - type: object
+        additionalProperties: false
+        required: [args]
+        properties:
+          args:
+            type: array
+            items:
+              type: string
+
 """

 schema = yaml.safe_load(starter)
@@ -290,9 +319,12 @@ items:
      type: object
      additionalProperties: false
      properties:
+        audit-command: {"$ref": "#/$defs/inherit"}
+        audit-requires: {"$ref": "#/$defs/inherit"}
        before-all: {"$ref": "#/$defs/inherit"}
        before-build: {"$ref": "#/$defs/inherit"}
        xbuild-tools: {"$ref": "#/$defs/inherit"}
+        xbuild-files: {"$ref": "#/$defs/inherit"}
        before-test: {"$ref": "#/$defs/inherit"}
        config-settings: {"$ref": "#/$defs/inherit"}
        container-engine: {"$ref": "#/$defs/inherit"}
@@ -304,6 +336,7 @@ items:
        test-sources: {"$ref": "#/$defs/inherit"}
        test-requires: {"$ref": "#/$defs/inherit"}
        test-environment: {"$ref": "#/$defs/inherit"}
+        test-runtime: {"$ref": "#/$defs/inherit"}
 """
 )

@@ -347,14 +380,16 @@ oses = {
    "ios": as_object(not_linux),
 }

-oses["linux"]["properties"]["repair-wheel-command"] = {
-    **schema["properties"]["repair-wheel-command"],
-    "default": "auditwheel repair -w {dest_dir} {wheel}",
-}
-oses["macos"]["properties"]["repair-wheel-command"] = {
-    **schema["properties"]["repair-wheel-command"],
-    "default": "delocate-wheel --require-archs {delocate_archs} -w {dest_dir} -v {wheel}",
-}
+for os_name, command in [
+    ("linux", "auditwheel repair -w {dest_dir} {wheel}"),
+    ("windows", "delvewheel repair -w {dest_dir} -v {wheel}"),
+    ("macos", "delocate-wheel --require-archs {delocate_archs} -w {dest_dir} -v {wheel}"),
+    ("android", "auditwheel repair --ldpaths {ldpaths} -w {dest_dir} {wheel}"),
+]:
+    oses[os_name]["properties"]["repair-wheel-command"] = {
+        **schema["properties"]["repair-wheel-command"],
+        "default": command,
+    }

 del oses["linux"]["properties"]["dependency-versions"]

@@ -1,4 +1,17 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script
+
+# /// script
+# dependencies = [
+#   "click",
+#   "pygithub",
+#   "pyyaml",
+#   "rich",
+#   "cibuildwheel",
+# ]
+#
+# [tool.uv.sources]
+# cibuildwheel = { path = ".." }
+# ///

 """
 Check known projects for usage of requires-python.
@@ -11,8 +24,9 @@ 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
-from collections.abc import Iterable, Iterator
 from pathlib import Path

 import click
@@ -22,6 +36,10 @@ from rich import print

 from cibuildwheel.projectfiles import Analyzer

+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Iterable, Iterator
+
 DIR = Path(__file__).parent.resolve()


@@ -1,4 +1,10 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script
+
+# /// script
+# dependencies = [
+#   "click",
+# ]
+# ///


 import os
@@ -1,4 +1,4 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script

 # /// script
 # dependencies = [
@@ -17,20 +17,26 @@ Suggested usage:
    git diff
 """

+from __future__ import annotations
+
 import builtins
 import functools
 import textwrap
+import urllib.error
 import urllib.request
 import xml.dom.minidom
-from collections.abc import Iterable, Mapping, Sequence
-from datetime import datetime
+from datetime import UTC, datetime
 from io import StringIO
 from pathlib import Path
 from typing import Any, Self, TextIO

 import click
 import yaml
-from github import Github, GithubException
+from github import Auth, Github, GithubException
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Iterable, Mapping, Sequence

 ICONS = (
    "github",
@@ -38,10 +44,12 @@ ICONS = (
    "circleci",
    "gitlab",
    "travisci",
-    "cirrusci",
    "windows",
    "apple",
    "linux",
+    "android",
+    "ios",
+    "pyodide",
 )


@@ -77,7 +85,7 @@ class Project:
                    self.notes = notes
        else:
            self.num_stars = 0
-            self.pushed_at = datetime.utcnow()
+            self.pushed_at = datetime.now(UTC)

        name_len = len(self.name) + 4
        self.__class__.NAME = max(self.__class__.NAME, name_len)
@@ -124,14 +132,19 @@ class Project:
        return f"[{self.name}]: {self.url}"

    def info(self) -> str:
-        days = (datetime.utcnow() - self.pushed_at).days
+        days = (datetime.now(UTC) - self.pushed_at).days
        return f"<!-- {self.name}: {self.num_stars}, last pushed {days} days ago -->"


 def fetch_icon(icon_name: str) -> None:
    url = f"https://cdn.jsdelivr.net/npm/simple-icons@v4/icons/{icon_name}.svg"
-    with urllib.request.urlopen(url) as f:
-        original_svg_data = f.read()
+    try:
+        with urllib.request.urlopen(url) as f:
+            original_svg_data = f.read()
+    except urllib.error.HTTPError as e:
+        if e.code == 404 and path_for_icon(icon_name).exists():
+            return
+        raise

    document = xml.dom.minidom.parseString(original_svg_data)
    svgElement = document.documentElement
@@ -165,7 +178,7 @@ def get_projects(
        for icon in ICONS:
            fetch_icon(icon)

-    github = Github(auth) if online else None
+    github = Github(auth=Auth.Token(auth)) if (online and auth) else None

    return sorted((Project(item, github) for item in config), reverse=online)

@@ -1,4 +1,4 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script

 import re
 from pathlib import Path
@@ -1,4 +1,4 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script

 import dataclasses
 import re
@@ -1,7 +1,15 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script
+
+# /// script
+# dependencies = [
+#   "click",
+#   "jinja2",
+# ]
+# ///


 import os
+import re
 import shutil
 import subprocess
 import sys
@@ -13,7 +21,9 @@ from urllib.parse import quote

 import click

-DIR = Path(__file__).parent.resolve()
+DIR = Path(__file__).parent.parent.resolve()
+
+BuildBackend = typing.Literal["setuptools", "meson"]


 def shell(cmd: str, *, check: bool, **kwargs: object) -> subprocess.CompletedProcess[str]:
@@ -26,11 +36,20 @@ def git_repo_has_changes() -> bool:
    return unstaged_changes or staged_changes


-def generate_basic_project(path: Path) -> None:
+def generate_project(path: Path, build_backend: BuildBackend) -> None:
    sys.path.insert(0, "")
-    from test.test_projects.c import new_c_project  # noqa: PLC0415
+    match build_backend:
+        case "meson":
+            from test.test_projects.meson import new_meson_project  # noqa: PLC0415
+
+            project = new_meson_project()
+        case "setuptools":
+            from test.test_projects.setuptools import new_c_project  # noqa: PLC0415
+
+            project = new_c_project()
+        case _:
+            typing.assert_never(build_backend)

-    project = new_c_project()
    project.generate(path)


@@ -38,6 +57,45 @@ class CIService(typing.NamedTuple):
    name: str
    dst_config_path: str
    badge_md: str
+    config_file_transform: typing.Callable[[str, str], str] = lambda x, _: x  # identity by default
+
+
+def github_config_file_transform(content: str, git_ref: str) -> str:
+    # one of the the github configs only builds on main, so we need to remove that restriction
+    # so our example build will run on the test branch.
+    #
+    # replace:
+    # """
+    # push:
+    #   branches:
+    #     - main
+    # """
+    # with:
+    # """
+    # push:
+    # """"
+    content = re.sub(
+        r"push:\n\s+branches:\n\s+- main",
+        "push:",
+        content,
+    )
+
+    # use the version of cibuildwheel from the current commit, not the latest
+    # release
+    # replace:
+    # """
+    # uses: pypa/cibuildwheel@v3.3.1
+    # """
+    # with:
+    # """
+    # uses: pypa/cibuildwheel@<latest commit hash>
+    # """
+    content = re.sub(
+        r"uses: pypa/cibuildwheel@v.*",
+        f"uses: pypa/cibuildwheel@{git_ref}",
+        content,
+    )
+    return content


 services = [
@@ -54,7 +112,8 @@ services = [
    CIService(
        name="github",
        dst_config_path=".github/workflows/example.yml",
-        badge_md="[![Build](https://github.com/pypa/cibuildwheel/workflows/Build/badge.svg?branch={branch})](https://github.com/pypa/cibuildwheel/actions)",
+        badge_md="[![Build](https://github.com/pypa/cibuildwheel/actions/workflows/example.yml/badge.svg?branch={branch})](https://github.com/pypa/cibuildwheel/actions?query=branch%3A{branch})",
+        config_file_transform=github_config_file_transform,
    ),
    CIService(
        name="travis-ci",
@@ -66,11 +125,6 @@ services = [
        dst_config_path=".gitlab-ci.yml",
        badge_md="[![Gitlab](https://gitlab.com/joerick/cibuildwheel/badges/{branch}/pipeline.svg)](https://gitlab.com/joerick/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})",
-    ),
 ]


@@ -85,18 +139,23 @@ def ci_service_for_config_file(config_file: Path) -> CIService:

@click.command()
@click.argument("config_files", nargs=-1, type=click.Path())
-def run_example_ci_configs(config_files=None):
+@click.option("--build-backend", type=click.Choice(["setuptools", "meson"]), default="setuptools")
+def run_example_ci_configs(
+    config_files: list[str], build_backend: BuildBackend = "setuptools"
+) -> None:
    """
    Test the example configs. If no files are specified, will test
    examples/*-minimal.yml
    """

    if len(config_files) == 0:
-        config_files = Path("examples").glob("*-minimal.yml")
+        config_file_paths = list(Path("examples").glob("*-minimal.yml"))
+    else:
+        config_file_paths = [Path(f) for f in config_files]

    # check each CI service has at most 1 config file
    configs_by_service = set()
-    for config_file in config_files:
+    for config_file in config_file_paths:
        service = ci_service_for_config_file(config_file)
        if service.name in configs_by_service:
            msg = "You cannot specify more than one config per CI service"
@@ -110,6 +169,9 @@ def run_example_ci_configs(config_files=None):
    previous_branch = shell(
        "git rev-parse --abbrev-ref HEAD", check=True, capture_output=True, encoding="utf8"
    ).stdout.strip()
+    git_ref = shell(
+        "git rev-parse HEAD", check=True, capture_output=True, encoding="utf8"
+    ).stdout.strip()

    timestamp = time.strftime("%Y-%m-%dT%H-%M-%S", time.gmtime())
    branch_name = f"example-config-test---{previous_branch}-{timestamp}"
@@ -118,19 +180,22 @@ def run_example_ci_configs(config_files=None):
        shell(f"git checkout --orphan {branch_name}", check=True)

        example_project = Path("example_root")
-        generate_basic_project(example_project)
+        generate_project(example_project, build_backend=build_backend)

-        for config_file in config_files:
+        for config_file in config_file_paths:
            service = ci_service_for_config_file(config_file)
            dst_config_file = example_project / service.dst_config_path

            dst_config_file.parent.mkdir(parents=True, exist_ok=True)
-            shutil.copyfile(config_file, dst_config_file)
+
+            contents = config_file.read_text(encoding="utf8")
+            contents = service.config_file_transform(contents, git_ref)
+            dst_config_file.write_text(contents, encoding="utf8")

        subprocess.run(["git", "add", example_project], check=True)
        message = textwrap.dedent(
            f"""\
-            Test example minimal configs
+            Test example CI configs

            Testing files: {[str(f) for f in config_files]}
            Generated from branch: {previous_branch}
@@ -148,14 +213,14 @@ def run_example_ci_configs(config_files=None):
        print("> ")
        print("> | Service | Config | Status |")
        print("> |---|---|---|")
-        for config_file in config_files:
+        for config_file in config_file_paths:
            service = ci_service_for_config_file(config_file)
            badge = service.badge_md.format(
                branch=branch_name, branch_escaped=quote(branch_name, safe="")
            )
            print(f"> | {service.name} | `{config_file}` | {badge} |")
        print("> ")
-        print("> Generated by `bin/run_example_ci_config.py`")
+        print(f"> Generated by `{' '.join(sys.argv)}`")
        print()
        print("---")
    finally:
@@ -1,4 +1,4 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script


 import argparse
@@ -1,4 +1,4 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script


 import argparse
@@ -1,4 +1,11 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script
+
+# /// script
+# dependencies = [
+#   "packaging",
+#   "requests",
+# ]
+# ///

 import configparser
 import dataclasses
@@ -71,6 +78,8 @@ images = [
            "pypy_aarch64",
        ],
    ),
+    # manylinux_2_35 images
+    PyPAImage("manylinux_2_35", ["armv7l"]),
    # manylinux_2_39 images
    PyPAImage("manylinux_2_39", ["riscv64"]),
    # musllinux_1_2 images
@@ -1,49 +1,60 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script

+# /// script
+# dependencies = [
+#   "playwright",
+# ]
+# ///

 import subprocess
 import sys
+import tempfile
 from pathlib import Path

-try:
-    from html2image import Html2Image  # type: ignore[import-not-found]
-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
-        """
-    )
+from playwright.sync_api import sync_playwright  # type: ignore[import-not-found]
+
+CSS = """
+    <link href="https://fonts.googleapis.com/css2?family=Lato&display=swap" rel="stylesheet">
+    <style>
+        html, body {
+          font-family: Lato, "Helvetica Neue", Helvetica, Arial, sans-serif;
+          font-weight: 400;
+          font-size: 16px;
+          color: #404040;
+          background: white;
+          margin: 0;
+          padding: 0;
+        }
+        * {
+          box-sizing: border-box;
+        }
+    </style>
+"""


 def main() -> None:
-    subprocess.run(["mkdocs", "build"], check=True)
+    subprocess.run([sys.executable, "-m", "playwright", "install", "chromium"], check=True)

-    hti = Html2Image(custom_flags=["--force-device-scale-factor=2"])
+    html_str = Path("docs/diagram.html").read_text()
+    html_str = f"<html><head>{CSS}</head><body>{html_str}</body></html>"

-    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
+    with tempfile.TemporaryDirectory() as tmp_dir_str:
+        html_path = Path(tmp_dir_str) / "diagram_screenshot.html"
+        html_path.write_text(html_str)

-    [screenshot, *_] = hti.screenshot(
-        html_str=html_str,
-        size=(830, 405),
-    )
+        dest_path = Path("docs/data/how-it-works.png")

-    dest_path = Path("docs/data/how-it-works.png")
-    dest_path.unlink(missing_ok=True)
+        with sync_playwright() as p:
+            browser = p.chromium.launch()
+            page = browser.new_page(device_scale_factor=2, viewport={"width": 830, "height": 600})
+            page.goto(html_path.as_uri())
+            page.wait_for_load_state("networkidle")

-    Path(screenshot).rename(dest_path)
+            height = page.evaluate("document.body.scrollHeight")
+            page.set_viewport_size({"width": 830, "height": height})
+
+            page.screenshot(path=str(dest_path), full_page=True)
+            browser.close()


 if __name__ == "__main__":
@@ -1,4 +1,13 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script
+
+# /// script
+# dependencies = [
+#   "click",
+#   "packaging",
+#   "requests",
+#   "rich",
+# ]
+# ///


 import dataclasses
@@ -1,13 +1,33 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script
+
+# /// script
+# dependencies = [
+#   "cibuildwheel",
+#   "requests",
+# ]
+#
+# [tool.uv.sources]
+# cibuildwheel = { path = ".." }
+# ///

 import json
+from pathlib import Path
+from typing import Final
+
+import requests

 from cibuildwheel.extra import github_api_request
 from cibuildwheel.util.python_build_standalone import (
    PythonBuildStandaloneAsset,
    PythonBuildStandaloneReleaseData,
 )
-from cibuildwheel.util.resources import PYTHON_BUILD_STANDALONE_RELEASES
+
+# Resolve path relative to this script so writes go to the source checkout,
+# not the uv-installed copy of the package.
+DIR: Final[Path] = Path(__file__).parent.parent.resolve()
+PYTHON_BUILD_STANDALONE_RELEASES: Final[Path] = (
+    DIR / "cibuildwheel/resources/python-build-standalone-releases.json"
+)


 def main() -> None:
@@ -25,8 +45,27 @@ def main() -> None:
        f"repos/astral-sh/python-build-standalone/releases/tags/{latest_tag}"
    )["assets"]

+    # Build a sha256 map from the SHA256SUMS file in the release
+    sha256_sums_urls = [
+        ga["browser_download_url"] for ga in github_assets if ga["name"] == "SHA256SUMS"
+    ]
+    name_to_sha256: dict[str, str] = {}
+    if sha256_sums_urls:
+        response = requests.get(sha256_sums_urls[0])
+        response.raise_for_status()
+        for line in response.text.splitlines():
+            parts = line.split()
+            if len(parts) == 2:
+                sha256_hex, filename = parts
+                # The filename may have a leading "./" or spaces - strip it
+                name_to_sha256[filename.lstrip("./")] = sha256_hex
+
    assets = [
-        PythonBuildStandaloneAsset(name=ga["name"], url=ga["browser_download_url"])
+        PythonBuildStandaloneAsset(
+            name=ga["name"],
+            url=ga["browser_download_url"],
+            sha256=name_to_sha256.get(ga["name"], ""),
+        )
        for ga in github_assets
        if ga["name"].endswith("install_only.tar.gz")
    ]
@@ -1,15 +1,27 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script

+# /// script
+# dependencies = [
+#   "click",
+#   "packaging",
+#   "requests",
+#   "rich",
+#   "cibuildwheel",
+# ]
+#
+# [tool.uv.sources]
+# cibuildwheel = { path = ".." }
+# ///
+from __future__ import annotations

-import copy
 import difflib
+import hashlib
 import logging
 import operator
 import re
 import tomllib
-from collections.abc import Mapping, MutableMapping
 from pathlib import Path
-from typing import Any, Final, Literal, TypedDict
+from typing import Any, Final, Literal, NotRequired, TypedDict
 from xml.etree import ElementTree as ET

 import click
@@ -23,6 +35,10 @@ from rich.syntax import Syntax
 from cibuildwheel.extra import dump_python_configurations, get_pyodide_xbuildenv_info
 from cibuildwheel.platforms.android import android_triplet

+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Mapping, MutableMapping
+
 log = logging.getLogger("cibw")

 # Looking up the dir instead of using utils.resources_dir
@@ -34,45 +50,20 @@ RESOURCES_DIR: Final[Path] = DIR / "cibuildwheel/resources"
 ArchStr = Literal["32", "64", "ARM64"]


-class ConfigWinCP(TypedDict):
+class Config(TypedDict):
    identifier: str
    version: str
-    arch: str


-class ConfigWinPP(TypedDict):
-    identifier: str
-    version: str
-    arch: str
+class ConfigUrl(Config):
    url: str
+    sha256: NotRequired[str]


-class ConfigWinGP(TypedDict):
-    identifier: str
-    version: str
-    url: str
-
-
-class ConfigApple(TypedDict):
-    identifier: str
-    version: str
-    url: str
-
-
-class ConfigAndroid(TypedDict):
-    identifier: str
-    version: str
-    url: str
-
-
-class ConfigPyodide(TypedDict):
-    identifier: str
-    version: str
+class ConfigPyodide(Config):
    default_pyodide_version: str
    node_version: str
-
-
-AnyConfig = ConfigWinCP | ConfigWinPP | ConfigWinGP | ConfigApple | ConfigAndroid | ConfigPyodide
+    sha256: str


 # The following set of "Versions" classes allow the initial call to the APIs to
@@ -106,7 +97,7 @@ class WindowsVersions:

        self.version_dict = {Version(v): v for v in cp_info["versions"]}

-    def update_version_windows(self, spec: Specifier) -> ConfigWinCP | None:
+    def update_version_windows(self, spec: Specifier) -> Config | None:
        # Specifier.filter selects all non pre-releases that match the spec,
        # unless there are only pre-releases, then it selects pre-releases
        # instead (like pip)
@@ -121,10 +112,9 @@ class WindowsVersions:
        flags = "t" if self.free_threaded else ""
        version = versions[0]
        identifier = f"cp{version.major}{version.minor}{flags}-{self.arch}"
-        return ConfigWinCP(
+        return Config(
            identifier=identifier,
            version=self.version_dict[version],
-            arch=self.arch_str,
        )


@@ -146,7 +136,7 @@ class GraalPyVersions:

        self.releases = [r for r in releases if "graalpy_version" in r and "python_version" in r]

-    def update_version(self, identifier: str, spec: Specifier) -> AnyConfig:
+    def update_version(self, identifier: str, spec: Specifier) -> ConfigUrl | None:
        if "x86_64" in identifier or "amd64" in identifier:
            arch = "x86_64"
        elif "arm64" in identifier or "aarch64" in identifier:
@@ -155,28 +145,24 @@ class GraalPyVersions:
            msg = f"{identifier} not supported yet on GraalPy"
            raise RuntimeError(msg)

-        gpspec_str = identifier.split("-")[0].split("_")[1]
-        gpspec = Specifier("==24.2.*") if gpspec_str == "242" else Specifier(f"=={gpspec_str}.*")
+        gpspec_str = identifier.split("-", maxsplit=1)[0].split("_")[1]
+        if "." not in gpspec_str and len(gpspec_str) == 3:
+            gpspec_str = gpspec_str[:2] + "." + gpspec_str[-1]
+        gpspec = Specifier(f"=={gpspec_str}.*")

-        releases = [r for r in self.releases if spec.contains(r["python_version"])]
-        releases = [r for r in self.releases if gpspec.contains(r["graalpy_version"])]
-        releases = sorted(releases, key=lambda r: r["graalpy_version"])
+        releases_tmp = (r for r in self.releases if spec.contains(r["python_version"]))
+        releases_tmp = (r for r in releases_tmp if gpspec.contains(r["graalpy_version"]))
+        releases = sorted(releases_tmp, key=lambda r: r["graalpy_version"])

        if not releases:
            msg = f"GraalPy {arch} not found for {spec}!"
            raise RuntimeError(msg)

-        release = releases[-1]
-        version = release["python_version"]
-        gpversion = release["graalpy_version"]
-
        if "macosx" in identifier:
            arch = "x86_64" if "x86_64" in identifier else "arm64"
-            config = ConfigApple
            platform = "macos"
        elif "win" in identifier:
            arch = "aarch64" if "arm64" in identifier else "x86_64"
-            config = ConfigWinGP
            platform = "windows"
        else:
            msg = "GraalPy provides downloads for macOS and Windows and is included for manylinux"
@@ -184,18 +170,39 @@ class GraalPyVersions:

        arch = "amd64" if arch == "x86_64" else "aarch64"
        ext = "zip" if "win" in identifier else "tar.gz"
-        (url,) = (
-            rf["browser_download_url"]
-            for rf in release["assets"]
-            if rf["name"].endswith(f"{platform}-{arch}.{ext}")
-            and rf["name"].startswith(f"graalpy-{gpversion.major}")
-        )
+        for release in reversed(releases):
+            version = release["python_version"]
+            gpversion = release["graalpy_version"]
+            urls = [
+                rf["browser_download_url"]
+                for rf in release["assets"]
+                if rf["name"].endswith(f"{platform}-{arch}.{ext}")
+                and rf["name"].startswith(f"graalpy-{gpversion.major}")
+            ]
+            if not urls:
+                continue

-        return config(
-            identifier=identifier,
-            version=f"{version.major}.{version.minor}",
-            url=url,
-        )
+            (url,) = urls
+            # Fetch sha256 from the ".sha256" sidecar asset in the same release.
+            sha256 = ""
+            sha256_asset_name = url.rsplit("/", 1)[-1] + ".sha256"
+            sha256_urls = [
+                rf["browser_download_url"]
+                for rf in release["assets"]
+                if rf["name"] == sha256_asset_name
+            ]
+            if sha256_urls:
+                sha256_response = requests.get(sha256_urls[0])
+                sha256_response.raise_for_status()
+                sha256 = sha256_response.text.strip().split()[0]
+            return ConfigUrl(
+                identifier=identifier,
+                version=f"{version.major}.{version.minor}",
+                url=url,
+                sha256=sha256,
+            )
+
+        return None


 class PyPyVersions:
@@ -223,7 +230,7 @@ class PyPyVersions:
        ]
        return urls[0] if urls else ""

-    def update_version_windows(self, spec: Specifier) -> ConfigWinCP:
+    def update_version_windows(self, spec: Specifier) -> ConfigUrl:
        releases = [r for r in self.releases if spec.contains(r["python_version"])]
        releases = sorted(releases, key=operator.itemgetter("pypy_version"))
        releases = [r for r in releases if self.get_arch_file(r)]
@@ -239,14 +246,13 @@ class PyPyVersions:
        identifier = f"pp{version.major}{version.minor}-{version_arch}"
        url = self.get_arch_file(release)

-        return ConfigWinPP(
+        return ConfigUrl(
            identifier=identifier,
            version=f"{version.major}.{version.minor}",
-            arch=self.arch,
            url=url,
        )

-    def update_version_macos(self, spec: Specifier) -> ConfigApple:
+    def update_version_macos(self, spec: Specifier) -> ConfigUrl:
        if self.arch not in {"64", "ARM64"}:
            msg = f"'{self.arch}' arch not supported yet on macOS"
            raise RuntimeError(msg)
@@ -270,7 +276,7 @@ class PyPyVersions:
            if "" in rf["platform"] == "darwin" and rf["arch"] == arch
        )

-        return ConfigApple(
+        return ConfigUrl(
            identifier=identifier,
            version=f"{version.major}.{version.minor}",
            url=url,
@@ -294,42 +300,45 @@ class CPythonVersions:

            # Removing the prefix
            version = Version(release["name"].removeprefix("Python "))
+            self.versions_dict[version] = release["resource_uri"]

-            uri = int(release["resource_uri"].rstrip("/").split("/")[-1])
-            self.versions_dict[version] = uri
+        files_response = requests.get("https://www.python.org/api/v2/downloads/release_file/")
+        files_response.raise_for_status()
+        self.files_info = files_response.json()

-    def update_version_macos(
-        self, identifier: str, version: Version, spec: Specifier
-    ) -> ConfigApple | None:
+    def update_version(self, identifier: str, spec: Specifier, file_ident: str) -> ConfigUrl | None:
        # see note above on Specifier.filter
        unsorted_versions = spec.filter(self.versions_dict)
        sorted_versions = sorted(unsorted_versions, reverse=True)

-        macver = "x10.9" if version <= Version("3.8.9999") else "11"
-        file_ident = f"macos{macver}.pkg"
-
        for new_version in sorted_versions:
            # Find the first patch version that contains the requested file
            uri = self.versions_dict[new_version]
-            response = requests.get(
-                f"https://www.python.org/api/v2/downloads/release_file/?release={uri}"
-            )
-            response.raise_for_status()
-            file_info = response.json()
+            files = [rf for rf in self.files_info if rf["release"] == uri]

-            urls = [rf["url"] for rf in file_info if file_ident in rf["url"]]
-            if urls:
-                return ConfigApple(
+            matching = [rf for rf in files if file_ident in rf["url"]]
+            if matching:
+                rf = matching[0]
+                return ConfigUrl(
                    identifier=identifier,
                    version=f"{new_version.major}.{new_version.minor}",
-                    url=urls[0],
+                    url=rf["url"],
+                    sha256=rf.get("sha256_sum", ""),
                )

        return None

+    def update_version_macos(
+        self, identifier: str, version: Version, spec: Specifier
+    ) -> ConfigUrl | None:
+        macver = "x10.9" if version <= Version("3.8.9999") else "11"
+        return self.update_version(identifier, spec, f"macos{macver}.pkg")

-class AndroidVersions:
-    # This should be replaced with official python.org downloads once they're available.
+    def update_version_android(self, identifier: str, spec: Specifier) -> ConfigUrl | None:
+        return self.update_version(identifier, spec, android_triplet(identifier))
+
+
+class MavenVersions:
    MAVEN_URL = "https://repo.maven.apache.org/maven2/com/chaquo/python/python"

    def __init__(self) -> None:
@@ -343,18 +352,16 @@ class AndroidVersions:
            assert isinstance(version_str, str), version_str
            self.versions.append(Version(version_str))

-    def update_version_android(
-        self, identifier: str, version: Version, spec: Specifier
-    ) -> ConfigAndroid | None:
+    def update_version_android(self, identifier: str, spec: Specifier) -> ConfigUrl | None:
        sorted_versions = sorted(spec.filter(self.versions), reverse=True)

        # Return a config using the highest version for the given specifier.
        if sorted_versions:
            max_version = sorted_versions[0]
            triplet = android_triplet(identifier)
-            return ConfigAndroid(
+            return ConfigUrl(
                identifier=identifier,
-                version=str(version),
+                version=f"{max_version.major}.{max_version.minor}",
                url=f"{self.MAVEN_URL}/{max_version}/python-{max_version}-{triplet}.tar.gz",
            )
        else:
@@ -390,11 +397,11 @@ class CPythonIOSVersions:
                if filename.endswith("-iOS-support"):
                    self.versions_dict[version][int(build[1:])] = asset["browser_download_url"]

-    def update_version_ios(self, identifier: str, version: Version) -> ConfigApple | None:
+    def update_version_ios(self, identifier: str, version: Version) -> ConfigUrl | None:
        # Return a config using the highest build number for the given version.
        urls = [url for _, url in sorted(self.versions_dict.get(version, {}).items())]
        if urls:
-            return ConfigApple(
+            return ConfigUrl(
                identifier=identifier,
                version=str(version),
                url=urls[-1],
@@ -433,6 +440,7 @@ class PyodideVersions:
            version=str(version),
            default_pyodide_version=release["version"],
            node_version=node_version,
+            sha256=release["sha256"],
        )


@@ -450,29 +458,38 @@ class AllVersions:
        self.windows_t_arm64 = WindowsVersions("ARM64", True)
        self.windows_pypy_64 = PyPyVersions("64")

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

-        self.android = AndroidVersions()
+        self.maven = MavenVersions()
        self.ios_cpython = CPythonIOSVersions()

        self.graalpy = GraalPyVersions()

        self.pyodide = PyodideVersions()

+    def _stream_sha256(self, url: str) -> str:
+        """Download a file (streaming) and return its SHA256 hex digest."""
+        log.debug("Computing sha256 for %s by streaming download...", url)
+        response = requests.get(url, stream=True)
+        response.raise_for_status()
+        hasher = hashlib.sha256()
+        for chunk in response.iter_content(65536):
+            hasher.update(chunk)
+        return hasher.hexdigest()
+
    def update_config(self, config: MutableMapping[str, str]) -> None:
        identifier = config["identifier"]
        version = Version(config["version"])
        spec = Specifier(f"=={version.major}.{version.minor}.*")
        log.info("Reading in %r -> %s @ %s", str(identifier), spec, version)
-        orig_config = copy.copy(config)
-        config_update: AnyConfig | None = None
+        config_update: Config | None = None

        # We need to use ** in update due to MyPy (probably a bug)
        if "macosx" in identifier:
            if identifier.startswith("cp"):
-                config_update = self.macos_cpython.update_version_macos(identifier, version, spec)
+                config_update = self.cpython.update_version_macos(identifier, version, spec)
            elif identifier.startswith("pp"):
                if "macosx_x86_64" in identifier:
                    config_update = self.macos_pypy.update_version_macos(spec)
@@ -498,19 +515,45 @@ class AllVersions:
        elif "win_arm64" in identifier and identifier.startswith("cp"):
            config_update = self.windows_arm64.update_version_windows(spec)
        elif "android" in identifier:
-            config_update = self.android.update_version_android(identifier, version, spec)
+            # Python 3.13 is released by Chaquopy on Maven Central.
+            # Python 3.14 and newer have official releases on python.org.
+            versions = self.maven if identifier.startswith("cp313") else self.cpython
+            config_update = versions.update_version_android(identifier, spec)
        elif "ios" in identifier:
-            config_update = self.ios_cpython.update_version_ios(identifier, version)
+            # Python 3.13 and 3.14 are released by BeeWare on GitHub.
+            # Python 3.15 and newer have official releases on python.org.
+            if identifier.startswith(("cp313", "cp314")):
+                config_update = self.ios_cpython.update_version_ios(identifier, version)
+            else:
+                config_update = self.cpython.update_version(
+                    identifier, spec, "iOS-XCframework.tar.gz"
+                )
        elif "pyodide" in identifier:
            config_update = self.pyodide.update_version_pyodide(
                identifier, version, spec, config["node_version"]
            )

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

-        if config != orig_config:
-            log.info("  Updated %s to %s", orig_config, config)
+        # Fill in sha256 for URL-based configs if not already provided by the
+        # update_version_* method (e.g. PyPy, BeeWare iOS, Maven have no sidecar).
+        # Also fills in sha256 when the CPython API doesn't return a sha256_sum
+        # (e.g. for older releases).
+        # Widen the type to allow arbitrary key access on the underlying dict.
+        config_update_dict: dict[str, str] = config_update  # type: ignore[assignment]
+        if "url" in config_update_dict and not config_update_dict.get("sha256"):
+            url = config_update_dict["url"]
+            existing_sha256 = config.get("sha256", "")
+            if url == config.get("url") and existing_sha256:
+                # URL unchanged — preserve the existing sha256
+                config_update_dict["sha256"] = existing_sha256
+            else:
+                config_update_dict["sha256"] = self._stream_sha256(url)
+
+        if config_update != config:
+            log.info("  Updated %s to %s", config, config_update)
+            config.clear()
+            config.update(**config_update)


@click.command()
@@ -1,14 +1,29 @@
-#!/usr/bin/env python3
+#!/usr/bin/env -S uv run --script
+
+# /// script
+# dependencies = [
+#   "click",
+#   "packaging",
+#   "requests",
+#   "rich",
+#   "cibuildwheel",
+# ]
+#
+# [tool.uv.sources]
+# cibuildwheel = { path = ".." }
+# ///


 import dataclasses
 import difflib
+import hashlib
 import logging
 import tomllib
 from pathlib import Path
 from typing import Final

 import click
+import requests
 import rich
 from packaging.version import Version
 from rich.logging import RichHandler
@@ -80,16 +95,29 @@ def update_virtualenv(force: bool, level: str) -> None:
    if latest_release.version > Version(local_version):
        version = latest_release.name
        url = latest_release.download_url
+        sha256 = ""  # recomputed below
    else:
        version = local_version
        url = default["url"]
+        sha256 = default["sha256"]
+
+    # Compute sha256 if not already stored (new version or first-time population)
+    if not sha256:
+        log.info("Computing sha256 for %s...", url)
+        response = requests.get(url, stream=True)
+        response.raise_for_status()
+        hasher = hashlib.sha256()
+        for chunk in response.iter_content(65536):
+            hasher.update(chunk)
+        sha256 = hasher.hexdigest()

    configurations["default"] = {
        "version": version,
        "url": url,
+        "sha256": sha256,
    }
    result_toml = "".join(
-        f'{key} = {{ version = "{value["version"]}", url = "{value["url"]}" }}\n'
+        f'{key} = {{ version = "{value["version"]}", url = "{value["url"]}", sha256 = "{value["sha256"]}" }}\n'
        for key, value in configurations.items()
    )

@@ -1 +1 @@
-__version__ = "3.1.4"
+__version__ = "4.0.0"
@@ -1,21 +1,21 @@
+from __future__ import annotations
+
 import argparse
 import contextlib
 import dataclasses
+import functools
 import os
 import shutil
 import sys
-import tarfile
 import textwrap
 import traceback
 import typing
-from collections.abc import Generator, Iterable, Sequence
 from pathlib import Path
 from tempfile import mkdtemp
-from typing import Any, Literal, TextIO

 import cibuildwheel
-import cibuildwheel.util
 from cibuildwheel import errors
+from cibuildwheel._compat.tarfile import TarFile, safe_extractall
 from cibuildwheel.architecture import Architecture, allowed_architectures_check
 from cibuildwheel.ci import CIProvider, detect_ci_provider, fix_ansi_codes_for_github_actions
 from cibuildwheel.logger import log
@@ -27,6 +27,11 @@ from cibuildwheel.util.file import CIBW_CACHE_PATH, ensure_cache_sentinel
 from cibuildwheel.util.helpers import strtobool
 from cibuildwheel.util.resources import read_all_configs

+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Generator, Iterable, Sequence
+    from typing import Any, Literal, TextIO
+

@dataclasses.dataclass
 class GlobalOptions:
@@ -52,7 +57,7 @@ class Unbuffered:
        self.stream.writelines(data)
        self.stream.flush()

-    def __getattr__(self, attr: str) -> Any:
+    def __getattr__(self, attr: str) -> Any:  # noqa: ANN401
        return getattr(self.stream, attr)


@@ -78,8 +83,13 @@ def main_inner(global_options: GlobalOptions) -> None:
    `main_inner` is the same as `main`, but it raises FatalError exceptions
    rather than exiting directly.
    """
+    # Default in 3.15+, only needed on 3.14
+    if sys.version_info >= (3, 14):
+        arg_parser = functools.partial(argparse.ArgumentParser, suggest_on_error=True)
+    else:
+        arg_parser = argparse.ArgumentParser

-    parser = argparse.ArgumentParser(
+    parser = arg_parser(
        description="Build wheels for all the platforms.",
        epilog="""
            Most options are supplied via environment variables or in
@@ -257,8 +267,8 @@ def main_inner(global_options: GlobalOptions) -> None:
    # Tarfile builds require extraction and changing the directory
    temp_dir = Path(mkdtemp(prefix="cibw-sdist-")).resolve(strict=True)
    try:
-        with tarfile.open(args.package_dir) as tar:
-            tar.extractall(path=temp_dir)
+        with TarFile.open(args.package_dir) as tar:
+            safe_extractall(tar, temp_dir)

        # The extract directory is now the project dir
        try:
@@ -314,7 +324,7 @@ def _compute_platform(args: CommandLineArguments) -> PlatformName:
    if args.only:
        return _compute_platform_only(args.only)
    elif platform_option_value != "auto":
-        return typing.cast(PlatformName, platform_option_value)
+        return typing.cast("PlatformName", platform_option_value)

    return native_platform()

@@ -426,17 +436,17 @@ def print_preamble(platform: str, options: Options, identifiers: Sequence[str])
        msg = "\n".join(error_list)
        raise errors.ConfigurationError(msg)

+    n = len(identifiers)
+    print(f"{n} build{'s' if n != 1 else ''} selected:")
+    print(", ".join(identifiers))
+    print()
    print("Here we go!\n")


 def detect_errors(*, options: Options, identifiers: Iterable[str]) -> Generator[str, None, None]:
    # Check for deprecated CIBW_FREE_THREADED_SUPPORT environment variable
    if "CIBW_FREE_THREADED_SUPPORT" in os.environ:
-        yield (
-            "CIBW_FREE_THREADED_SUPPORT environment variable is no longer supported. "
-            'Use tool.cibuildwheel.enable = ["cpython-freethreading"] in pyproject.toml '
-            "or set CIBW_ENABLE=cpython-freethreading instead."
-        )
+        yield "CIBW_FREE_THREADED_SUPPORT environment variable is no longer supported."

    # Deprecated {python} and {pip}
    for option_name in ["test_command", "before_build"]:
@@ -463,13 +473,6 @@ def detect_warnings(*, options: Options) -> Generator[str, None, None]:
    build_selector = options.globals.build_selector
    test_selector = options.globals.test_selector

-    if EnableGroup.CPythonExperimentalRiscV64 in build_selector.enable:
-        yield (
-            "'cpython-experimental-riscv64' enable is deprecated and will be removed in a future version. "
-            "It should be removed from tool.cibuildwheel.enable in pyproject.toml "
-            "or CIBW_ENABLE environment variable."
-        )
-
    all_valid_identifiers = [
        config.identifier
        for module in ALL_PLATFORM_MODULES.values()
@@ -535,10 +538,16 @@ def check_for_invalid_selectors(
                msg += "This selector matches a group that wasn't enabled. Enable it using the `enable` option or remove this selector. "

            if "p2" in selector_ or "p35" in selector_:
-                msg += f"cibuildwheel 3.x no longer supports Python < 3.8. Please use the 1.x series or update `{selector_name}`. "
+                msg += f"cibuildwheel 4.x no longer supports Python < 3.9. Please use the 1.x series or update `{selector_name}`. "
                error_type = errors.DeprecationError
            if "p36" in selector_ or "p37" in selector_:
-                msg += f"cibuildwheel 3.x no longer supports Python < 3.8. Please use the 2.x series or update `{selector_name}`. "
+                msg += f"cibuildwheel 4.x no longer supports Python < 3.9. Please use the 2.x series or update `{selector_name}`. "
+                error_type = errors.DeprecationError
+            if "p38" in selector_:
+                msg += f"cibuildwheel 4.x no longer supports Python < 3.9. Please use the 3.x series or update `{selector_name}`. "
+                error_type = errors.DeprecationError
+            if "cp313t" in selector_:
+                msg += f"cibuildwheel 4.x no longer supports Python 3.13 free-threading. Please use the 3.x series or update `{selector_name}`. "
                error_type = errors.DeprecationError

            if selector_name == "build":
@@ -0,0 +1,71 @@
+# Based on https://github.com/pypa/build/blob/f4ebd495cc0c2c74155bd4fe48b76399fb7927ac/src/build/_compat/tarfile.py
+
+from __future__ import annotations
+
+import sys
+import tarfile
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+
+    TarFile = tarfile.TarFile
+
+# Per https://peps.python.org/pep-0706/, the "data" filter will become
+# the default in Python 3.14. The first series of releases with the filter
+# had a broken filter that could not process symlinks correctly.
+elif (3, 11, 5) <= sys.version_info < (3, 14):
+
+    class TarFile(tarfile.TarFile):  # pragma: no cover
+        extraction_filter = staticmethod(tarfile.data_filter)
+
+else:
+    TarFile = tarfile.TarFile  # pragma: no cover
+
+
+# Same availability matrix as the TarFile subclass above. On runtimes that
+# ship the stdlib ``data`` filter we delegate to it; the fallback branch is
+# only reached on 3.10.0-3.10.12 / 3.11.0-3.11.4 and validates each member
+# manually before extraction.
+if sys.version_info >= (3, 11, 5):
+
+    def safe_extractall(tar: tarfile.TarFile, path: Path) -> None:  # pragma: no cover
+        """Extract every member of ``tar`` into ``path`` via the PEP 706 ``data`` filter."""
+        tar.extractall(path, filter="data")
+
+else:
+
+    def safe_extractall(tar: tarfile.TarFile, path: Path) -> None:  # pragma: no cover
+        """Validate every member of ``tar``, then extract into ``path``.
+
+        Reached on 3.10.0-3.10.12 / 3.11.0-3.11.4 where the stdlib ``data`` filter is missing. Device or special files,
+        paths that escape ``path``, and symlinks/hardlinks whose targets resolve outside ``path`` are rejected before
+        any write hits the disk.
+
+        """
+        base = path.resolve()
+        for member in tar.getmembers():
+            _validate_safe_member(member, base)
+        tar.extractall(path)
+
+
+def _validate_safe_member(member: tarfile.TarInfo, base: Path) -> None:
+    if member.ischr() or member.isblk() or member.isfifo():
+        msg = f"refusing to extract special device file {member.name!r}"
+        raise tarfile.TarError(msg)
+    target = (base / member.name).resolve(strict=False)
+    if not target.is_relative_to(base):
+        msg = f"refusing to extract {member.name!r}: path escapes destination"
+        raise tarfile.TarError(msg)
+    if member.issym() or member.islnk():
+        link_base = target.parent if member.issym() else base
+        link_target = (link_base / member.linkname).resolve(strict=False)
+        if not link_target.is_relative_to(base):
+            msg = f"refusing to extract {member.name!r}: link target escapes destination"
+            raise tarfile.TarError(msg)
+
+
+__all__ = [
+    "TarFile",
+    "safe_extractall",
+]
@@ -1,16 +1,21 @@
+from __future__ import annotations
+
 import platform as platform_module
 import re
 import shutil
 import subprocess
 import sys
 import typing
-from collections.abc import Set
 from enum import StrEnum, auto
-from typing import Final, Literal

 from cibuildwheel import errors

-from .typing import PlatformName
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Set
+    from typing import Final, Literal, Self
+
+    from cibuildwheel.typing import PlatformName

 PRETTY_NAMES: Final[dict[PlatformName, str]] = {
    "linux": "Linux",
@@ -83,34 +88,34 @@ class Architecture(StrEnum):
    arm64_iphonesimulator = auto()
    x86_64_iphonesimulator = auto()

-    @staticmethod
-    def parse_config(config: str, platform: PlatformName) -> "set[Architecture]":
+    @classmethod
+    def parse_config(cls, config: str, platform: PlatformName) -> set[Self]:
        result = set()
        for arch_str in re.split(r"[\s,]+", config):
            match arch_str:
                case "auto":
-                    result |= Architecture.auto_archs(platform=platform)
+                    result |= cls.auto_archs(platform=platform)
                case "native":
-                    if native_arch := Architecture.native_arch(platform=platform):
+                    if native_arch := cls.native_arch(platform=platform):
                        result.add(native_arch)
                case "all":
-                    result |= Architecture.all_archs(platform=platform)
+                    result |= cls.all_archs(platform=platform)
                case "auto64":
-                    result |= Architecture.bitness_archs(platform=platform, bitness="64")
+                    result |= cls.bitness_archs(platform=platform, bitness="64")
                case "auto32":
-                    result |= Architecture.bitness_archs(platform=platform, bitness="32")
+                    result |= cls.bitness_archs(platform=platform, bitness="32")
                case _:
                    try:
-                        result.add(Architecture(arch_str))
+                        result.add(cls(arch_str))
                    except ValueError as e:
                        msg = f"Invalid architecture '{arch_str}'"
                        raise errors.ConfigurationError(msg) from e
        return result

-    @staticmethod
-    def native_arch(platform: PlatformName) -> "Architecture | None":
+    @classmethod
+    def native_arch(cls, platform: PlatformName) -> Self | None:
        native_machine = platform_module.machine()
-        native_architecture = Architecture(native_machine)
+        native_architecture = cls(native_machine)

        # Cross-platform support. Used for --print-build-identifiers or docker builds.
        host_platform: PlatformName = (
@@ -120,15 +125,15 @@ class Architecture(StrEnum):
        )

        if platform == "pyodide":
-            return Architecture.wasm32
+            return cls.wasm32
        elif platform == "ios":
            # Can only build for iOS on macOS. The "native" architecture is the
            # simulator for the macOS native platform.
            if host_platform == "macos":
-                if native_architecture == Architecture.x86_64:
-                    return Architecture.x86_64_iphonesimulator
+                if native_architecture == cls.x86_64:
+                    return cls.x86_64_iphonesimulator
                else:
-                    return Architecture.arm64_iphonesimulator
+                    return cls.arm64_iphonesimulator
            else:
                return None

@@ -140,64 +145,64 @@ class Architecture(StrEnum):
                # can't build anything on this platform
                return None

-            native_architecture = Architecture(synonym)
+            native_architecture = cls(synonym)

        return native_architecture

-    @staticmethod
-    def auto_archs(platform: PlatformName) -> "set[Architecture]":
-        native_arch = Architecture.native_arch(platform)
+    @classmethod
+    def auto_archs(cls, platform: PlatformName) -> set[Self]:
+        native_arch = cls.native_arch(platform)
        if native_arch is None:
            return set()  # can't build anything on this platform
        result = {native_arch}

        match platform:
-            case "windows" if Architecture.AMD64 in result:
-                result.add(Architecture.x86)
-            case "ios" if native_arch == Architecture.arm64_iphonesimulator:
+            case "windows" if cls.AMD64 in result:
+                result.add(cls.x86)
+            case "ios" if native_arch == cls.arm64_iphonesimulator:
                # Also build the device wheel if we're on ARM64.
-                result.add(Architecture.arm64_iphoneos)
+                result.add(cls.arm64_iphoneos)

        return result

-    @staticmethod
-    def all_archs(platform: PlatformName) -> "set[Architecture]":
+    @classmethod
+    def all_archs(cls, platform: PlatformName) -> set[Self]:
        all_archs_map = {
            "linux": {
-                Architecture.x86_64,
-                Architecture.i686,
-                Architecture.aarch64,
-                Architecture.ppc64le,
-                Architecture.s390x,
-                Architecture.armv7l,
-                Architecture.riscv64,
+                cls.x86_64,
+                cls.i686,
+                cls.aarch64,
+                cls.ppc64le,
+                cls.s390x,
+                cls.armv7l,
+                cls.riscv64,
            },
-            "macos": {Architecture.x86_64, Architecture.arm64, Architecture.universal2},
-            "windows": {Architecture.x86, Architecture.AMD64, Architecture.ARM64},
-            "pyodide": {Architecture.wasm32},
-            "android": {Architecture.x86_64, Architecture.arm64_v8a},
+            "macos": {cls.x86_64, cls.arm64, cls.universal2},
+            "windows": {cls.x86, cls.AMD64, cls.ARM64},
+            "pyodide": {cls.wasm32},
+            "android": {cls.x86_64, cls.arm64_v8a},
            "ios": {
-                Architecture.x86_64_iphonesimulator,
-                Architecture.arm64_iphonesimulator,
-                Architecture.arm64_iphoneos,
+                cls.x86_64_iphonesimulator,
+                cls.arm64_iphonesimulator,
+                cls.arm64_iphoneos,
            },
        }
        return all_archs_map[platform]

-    @staticmethod
-    def bitness_archs(platform: PlatformName, bitness: Literal["64", "32"]) -> "set[Architecture]":
+    @classmethod
+    def bitness_archs(cls, platform: PlatformName, bitness: Literal["64", "32"]) -> set[Self]:
        # This map maps 64-bit architectures to their 32-bit equivalents.
        archs_map = {
-            Architecture.x86_64: Architecture.i686,
-            Architecture.AMD64: Architecture.x86,
-            Architecture.aarch64: Architecture.armv7l,
+            cls.x86_64: cls.i686,
+            cls.AMD64: cls.x86,
+            cls.aarch64: cls.armv7l,
        }
-        native_arch = Architecture.native_arch(platform)
+        native_arch = cls.native_arch(platform)

        if native_arch is None:
            return set()  # can't build anything on this platform

-        if native_arch == Architecture.wasm32:
+        if native_arch == cls.wasm32:
            return {native_arch} if bitness == "32" else set()

        match bitness:
@@ -207,7 +212,7 @@ class Architecture(StrEnum):
                if native_arch in archs_map.values():
                    return {native_arch}
                elif native_arch in archs_map and platform in {"linux", "windows"}:
-                    if native_arch == Architecture.aarch64 and not _check_aarch32_el0():
+                    if native_arch == cls.aarch64 and not _check_aarch32_el0():
                        # If we're on aarch64, skip if we cannot build armv7l wheels.
                        return set()
                    return {archs_map[native_arch]}
@@ -0,0 +1,137 @@
+from __future__ import annotations
+
+import subprocess
+import sys
+from pathlib import Path
+
+from cibuildwheel import errors
+from cibuildwheel.logger import log
+from cibuildwheel.util.cmd import call, shell
+from cibuildwheel.util.helpers import prepare_command
+from cibuildwheel.util.packaging import is_abi3_wheel
+from cibuildwheel.venv import activate_virtualenv, find_uv, virtualenv
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from cibuildwheel.options import BuildOptions
+
+
+def run_audit(
+    *,
+    tmp_dir: Path,
+    build_options: BuildOptions,
+    wheel: Path,
+) -> None:
+    """
+    Run the audit commands on a single wheel.
+
+    Creates a virtualenv (or reuses an existing one) and installs any
+    audit requirements, then runs each audit command template against
+    the wheel. Commands containing {abi3_wheel} are skipped for
+    non-abi3 wheels.
+    """
+
+    if not needs_audit(build_options.audit_command, wheel.name):
+        return
+
+    log.step("Auditing wheel...")
+
+    use_uv = build_options.build_frontend.name in {"build[uv]", "uv"}
+    version = f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}"
+    dependency_constraint = build_options.dependency_constraints.get_for_python_version(
+        version=version, tmp_dir=tmp_dir
+    )
+
+    # Use the base interpreter, not the venv python, to avoid nested-venv
+    # issues where pip can't be found (seen on Windows + Python 3.13).
+    host_python = Path(getattr(sys, "_base_executable", sys.executable))
+
+    audit_venv_dir = tmp_dir / "audit_venv"
+    if not (audit_venv_dir / "pyvenv.cfg").exists():
+        env = virtualenv(
+            version,
+            host_python,
+            audit_venv_dir,
+            dependency_constraint=dependency_constraint,
+            use_uv=use_uv,
+        )
+    else:
+        env = activate_virtualenv(audit_venv_dir)
+
+    # install audit requirements. This is run every time in case the user has
+    # defined overrides.
+    audit_requires = build_options.audit_requires
+    if audit_requires:
+        print(f"Installing audit dependencies: {', '.join(audit_requires)}")
+
+        pip: list[str]
+        if use_uv:
+            uv_path = find_uv()
+            assert uv_path is not None
+            pip = [str(uv_path), "pip"]
+        else:
+            pip = ["pip"]
+        # we pin if the audit-requires is left as the default "abi3audit"
+        should_pin = audit_requires == ["abi3audit"] and dependency_constraint
+
+        call(
+            *pip,
+            "install",
+            *(["--constraint", str(dependency_constraint)] if should_pin else []),
+            *audit_requires,
+            env=env,
+        )
+
+    audit_command = build_options.audit_command
+
+    for command_template in audit_command:
+        if "{abi3_wheel}" in command_template and "{wheel}" in command_template:
+            msg = (
+                f"Invalid audit command {command_template!r}: cannot contain both {{abi3_wheel}} "
+                "and {{wheel}} placeholders"
+            )
+            raise errors.ConfigurationError(msg)
+
+        if "{abi3_wheel}" in command_template and not is_abi3_wheel(wheel.name):
+            continue
+
+        prepared_command = prepare_command(
+            command_template,
+            abi3_wheel=wheel,
+            wheel=wheel,
+            project=".",
+            package=build_options.package_dir,
+        )
+
+        print(f"Running audit command: {prepared_command}")
+        try:
+            shell(prepared_command, env=env)
+        except subprocess.CalledProcessError as e:
+            print(f"Audit command failed with exit code {e.returncode}")
+            msg = f"Audit command failed: {prepared_command}"
+            raise errors.AuditCommandFailedError(msg) from e
+
+
+def needs_audit(audit_commands: list[str], wheel_name: str) -> bool:
+    saw_abi3_placeholder = False
+    for audit_command in audit_commands:
+        if "{abi3_wheel}" not in audit_command and "{wheel}" not in audit_command:
+            msg = (
+                f"Invalid audit command {audit_command!r}: must contain either "
+                "{{abi3_wheel}} or {{wheel}} placeholder"
+            )
+            raise errors.ConfigurationError(msg)
+
+        if "{abi3_wheel}" in audit_command:
+            saw_abi3_placeholder = True
+            if is_abi3_wheel(wheel_name):
+                return True
+        elif "{wheel}" in audit_command:
+            return True
+
+    if saw_abi3_placeholder:
+        print("No audit required for this wheel, as it is not abi3")
+    else:
+        print("No audit configured")
+
+    return False
@@ -1,16 +1,21 @@
+from __future__ import annotations
+
 import dataclasses
 import subprocess
-from collections.abc import (
-    Callable,
-    Iterable,
-    Mapping,
-    Sequence,
-)

 import bashlex

-# a function that takes a command and the environment, and returns the result
-EnvironmentExecutor = Callable[[list[str], dict[str, str]], str]
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import (
+        Callable,
+        Iterable,
+        Mapping,
+        Sequence,
+    )
+
+    # a function that takes a command and the environment, and returns the result
+    EnvironmentExecutor = Callable[[list[str], dict[str, str]], str]


 def local_environment_executor(command: Sequence[str], env: Mapping[str, str]) -> str:
@@ -2,7 +2,7 @@ import os
 import re
 from enum import Enum

-from .util.helpers import strtobool
+from cibuildwheel.util.helpers import strtobool

 ANSI_CODE_REGEX = re.compile(r"(\033\[[0-9;]*m)")

@@ -14,7 +14,6 @@ class CIProvider(Enum):
    azure_pipelines = "azure_pipelines"
    github_actions = "github_actions"
    gitlab = "gitlab"
-    cirrus_ci = "cirrus_ci"

    # unofficial support
    appveyor = "appveyor"
@@ -35,8 +34,6 @@ 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:
@@ -1,11 +1,17 @@
+from __future__ import annotations
+
 import dataclasses
-from collections.abc import Mapping, Sequence
-from typing import Any, Protocol
+from typing import Protocol

 import bashlex
 import bashlex.errors

-from . import bashlex_eval
+from cibuildwheel import bashlex_eval
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Mapping, Sequence
+    from typing import Any


 class EnvironmentParseError(Exception):
@@ -131,7 +137,7 @@ class ParsedEnvironment:
    def __repr__(self) -> str:
        return f"{self.__class__.__name__}({[repr(a) for a in self.assignments]!r})"

-    def options_summary(self) -> Any:
+    def options_summary(self) -> list[EnvironmentAssignment]:
        return self.assignments


@@ -76,7 +76,7 @@ class RepairStepProducedNoWheelError(FatalError):
            Build failed because the repair step completed successfully but
            did not produce a wheel.

-            Your `repair-wheel-command` is expected to place the repaired
+            Your `repair-wheel-command` must place the repaired
            wheel in the {dest_dir} directory. See the documentation for
            example configurations:

@@ -94,7 +94,7 @@ class RepairStepProducedMultipleWheelsError(FatalError):
            Build failed because the repair step completed successfully but
            produced multiple wheels: {wheels}

-            Your `repair-wheel-command` is expected to place one repaired
+            Your `repair-wheel-command` must place exactly one repaired
            wheel in the {{dest_dir}} directory. See the documentation for
            example configurations:

@@ -103,3 +103,9 @@ class RepairStepProducedMultipleWheelsError(FatalError):
        )
        super().__init__(message)
        self.return_code = 8
+
+
+class AuditCommandFailedError(FatalError):
+    def __init__(self, message: str) -> None:
+        super().__init__(message)
+        self.return_code = 9
@@ -2,17 +2,24 @@
 These are utilities for the `/bin` scripts, not for the `cibuildwheel` program.
 """

+from __future__ import annotations
+
 import json
 import time
 import typing
 import urllib.error
 import urllib.request
-from collections.abc import Mapping, Sequence
 from io import StringIO
-from typing import Any, NotRequired, Protocol
+from typing import NotRequired, Protocol

 from cibuildwheel import __version__ as cibw_version

+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Mapping, Sequence
+    from typing import Any
+
+
 __all__ = ("Printable", "dump_python_configurations")


@@ -41,7 +48,7 @@ def dump_python_configurations(

 def _json_request(request: urllib.request.Request, timeout: int = 30) -> dict[str, Any]:
    with urllib.request.urlopen(request, timeout=timeout) as response:
-        return typing.cast(dict[str, Any], json.load(response))
+        return typing.cast("dict[str, Any]", json.load(response))


 def github_api_request(path: str, *, max_retries: int = 3) -> dict[str, Any]:
@@ -62,7 +69,7 @@ def github_api_request(path: str, *, max_retries: int = 3) -> dict[str, Any]:
            # pylint: disable=E1101
            if (
                isinstance(e, urllib.error.HTTPError)
-                and (e.code == 403 or e.code == 429)
+                and (e.code in {403, 429})
                and e.headers.get("x-ratelimit-remaining") == "0"
            ):
                reset_time = int(e.headers.get("x-ratelimit-reset", 0))
@@ -83,6 +90,7 @@ def github_api_request(path: str, *, max_retries: int = 3) -> dict[str, Any]:

 class PyodideXBuildEnvRelease(typing.TypedDict):
    version: str
+    sha256: str
    python_version: str
    emscripten_version: str
    min_pyodide_build_version: NotRequired[str]
@@ -98,4 +106,4 @@ def get_pyodide_xbuildenv_info() -> PyodideXBuildEnvInfo:
        "https://pyodide.github.io/pyodide/api/pyodide-cross-build-environments.json"
    )
    with urllib.request.urlopen(xbuildenv_info_url) as response:
-        return typing.cast(PyodideXBuildEnvInfo, json.loads(response.read().decode("utf-8")))
+        return typing.cast("PyodideXBuildEnvInfo", json.loads(response.read().decode("utf-8")))
@@ -1,13 +1,20 @@
+from __future__ import annotations
+
 import dataclasses
 import shlex
 import typing
-from collections.abc import Sequence
-from typing import Literal, Self, get_args
+from typing import Literal, get_args

-from .logger import log
-from .util.helpers import parse_key_value_string
+from cibuildwheel.util.helpers import parse_key_value_string, prepare_command

-BuildFrontendName = Literal["pip", "build", "build[uv]"]
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+    from typing import Self
+
+    from cibuildwheel.typing import PathOrStr
+
+BuildFrontendName = Literal["pip", "build", "build[uv]", "uv"]


@dataclasses.dataclass(frozen=True)
@@ -24,7 +31,7 @@ class BuildFrontendConfig:
            msg = f"Unrecognised build frontend {name!r}, must be one of {names}"
            raise ValueError(msg)

-        name = typing.cast(BuildFrontendName, name)
+        name = typing.cast("BuildFrontendName", name)

        args = config_dict.get("args") or []
        return cls(name=name, args=args)
@@ -38,11 +45,7 @@ class BuildFrontendConfig:

 def _get_verbosity_flags(level: int, frontend: BuildFrontendName) -> list[str]:
    if level < 0:
-        if frontend == "pip":
-            return ["-" + -level * "q"]
-
-        msg = f"build_verbosity {level} is not supported for {frontend} frontend. Ignoring."
-        log.warning(msg)
+        return ["-" + -level * "q"]

    if level > 0:
        if frontend == "pip":
@@ -58,6 +61,20 @@ def _split_config_settings(config_settings: str) -> list[str]:
    return [f"-C{setting}" for setting in config_settings_list]


+def prepare_config_settings(config_settings: str, *, project: PathOrStr, package: PathOrStr) -> str:
+    # Substitute the {project}/{package} placeholders on each already-split
+    # token rather than on the raw string. A substituted path may contain
+    # spaces or backslashes (e.g. a Windows `{package}` path), and the result
+    # is later re-parsed with shlex.split (in _split_config_settings /
+    # parse_config_settings) — substituting on the whole string would let
+    # those characters be reinterpreted, splitting one setting into several or
+    # eating backslashes. shlex.join re-quotes each token so the round-trip is
+    # lossless.
+    settings = shlex.split(config_settings)
+    prepared = [prepare_command(setting, project=project, package=package) for setting in settings]
+    return shlex.join(prepared)
+
+
 # Based on build.__main__.main.
 def parse_config_settings(config_settings_str: str) -> dict[str, str | list[str]]:
    config_settings: dict[str, str | list[str]] = {}
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import codecs
 import contextlib
 import dataclasses
@@ -9,18 +11,21 @@ import re
 import sys
 import textwrap
 import time
-from collections.abc import Generator
 from pathlib import Path
-from typing import IO, TYPE_CHECKING, AnyStr, Final, Literal

 import humanize

-from .ci import CIProvider, detect_ci_provider, filter_ansi_codes
+from cibuildwheel.ci import CIProvider, detect_ci_provider, filter_ansi_codes

+TYPE_CHECKING = False
 if TYPE_CHECKING:
-    from .options import Options
+    from collections.abc import Generator
+    from typing import IO, AnyStr, Final, Literal
+
+    from cibuildwheel.options import Options
+
+    FoldPattern = tuple[str, str]

-FoldPattern = tuple[str, str]
 DEFAULT_FOLD_PATTERN: Final[FoldPattern] = ("{name}", "")
 FOLD_PATTERNS: Final[dict[str, FoldPattern]] = {
    "azure": ("##[group]{name}", "##[endgroup]"),
@@ -234,7 +239,7 @@ class Logger:
            print(f"cibuildwheel: {c.bright_red}error{c.end}: {error}\n", file=sys.stderr)

    @contextlib.contextmanager
-    def print_summary(self, *, options: "Options") -> Generator[None, None, None]:
+    def print_summary(self, *, options: Options) -> Generator[None, None, None]:
        start = time.time()
        yield
        duration = time.time() - start
@@ -292,7 +297,7 @@ class Logger:
        # lowercase, shorten
        return identifier.lower()[:20]

-    def _github_step_summary(self, duration: float, options: "Options") -> str:
+    def _github_step_summary(self, duration: float, options: Options) -> str:
        """
        Returns the GitHub step summary, in markdown format.
        """
@@ -1,3 +1,6 @@
+from __future__ import annotations
+
+import contextlib
 import dataclasses
 import io
 import json
@@ -10,18 +13,24 @@ import sys
 import textwrap
 import typing
 import uuid
-from collections.abc import Mapping, Sequence
 from enum import Enum
-from pathlib import Path, PurePath, PurePosixPath
-from types import TracebackType
-from typing import IO, Literal, Self, assert_never
+from pathlib import PurePosixPath
+from typing import Literal, assert_never

-from .ci import CIProvider, detect_ci_provider
-from .errors import OCIEngineTooOldError
-from .logger import log
-from .typing import PathOrStr
-from .util.cmd import call
-from .util.helpers import FlexibleVersion, parse_key_value_string, strtobool
+from cibuildwheel.ci import CIProvider, detect_ci_provider
+from cibuildwheel.errors import OCIEngineTooOldError
+from cibuildwheel.logger import log
+from cibuildwheel.util.cmd import call
+from cibuildwheel.util.helpers import FlexibleVersion, parse_key_value_string, strtobool
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Mapping, Sequence
+    from pathlib import Path, PurePath
+    from types import TracebackType
+    from typing import IO, Self
+
+    from cibuildwheel.typing import PathOrStr

 ContainerEngineName = Literal["docker", "podman"]

@@ -37,7 +46,7 @@ class OCIPlatform(Enum):
    S390X = "linux/s390x"

    @classmethod
-    def native(cls) -> "OCIPlatform":
+    def native(cls) -> Self:
        """Return the current OCI platform, or raise ValueError if unknown."""
        arch = platform.machine().lower()
        mapping = {
@@ -78,7 +87,7 @@ class OCIContainerEngineConfig:
            msg = f"unknown container engine {name}"
            raise ValueError(msg)

-        name = typing.cast(ContainerEngineName, name)
+        name = typing.cast("ContainerEngineName", name)
        # some flexibility in the option names to cope with TOML conventions
        create_args = config_dict.get("create_args") or config_dict.get("create-args") or []
        disable_host_mount_options = (
@@ -116,11 +125,14 @@ DEFAULT_ENGINE = OCIContainerEngineConfig("docker")
 def _check_engine_version(engine: OCIContainerEngineConfig) -> None:
    try:
        version_string = call(engine.name, "version", "-f", "{{json .}}", capture_stdout=True)
-        version_info = json.loads(version_string.strip())
+        # We are using lowercase keys for all dicts so we are not affected by casing of keys
+        version_info = json.loads(
+            version_string.strip(), object_pairs_hook=lambda inp: {k.lower(): v for k, v in inp}
+        )
        match engine.name:
            case "docker":
-                client_api_version = FlexibleVersion(version_info["Client"]["ApiVersion"])
-                server_api_version = FlexibleVersion(version_info["Server"]["ApiVersion"])
+                client_api_version = FlexibleVersion(version_info["client"]["apiversion"])
+                server_api_version = FlexibleVersion(version_info["server"]["apiversion"])
                # --platform support was introduced in 1.32 as experimental, 1.41 removed the experimental flag
                version = min(client_api_version, server_api_version)
                minimum_version = FlexibleVersion("1.41")
@@ -135,9 +147,9 @@ def _check_engine_version(engine: OCIContainerEngineConfig) -> None:
                )
            case "podman":
                # podman uses the same version string for "Version" & "ApiVersion"
-                client_version = FlexibleVersion(version_info["Client"]["Version"])
-                if "Server" in version_info:
-                    server_version = FlexibleVersion(version_info["Server"]["Version"])
+                client_version = FlexibleVersion(version_info["client"]["version"])
+                if "server" in version_info:
+                    server_version = FlexibleVersion(version_info["server"]["version"])
                else:
                    server_version = client_version
                # --platform support was introduced in v3
@@ -195,7 +207,6 @@ class OCIContainer:

    UTILITY_PYTHON = "/opt/python/cp39-cp39/bin/python"

-    process: subprocess.Popen[bytes]
    bash_stdin: IO[bytes]
    bash_stdout: IO[bytes]

@@ -215,6 +226,7 @@ class OCIContainer:
        self.oci_platform = oci_platform
        self.cwd = cwd
        self.name: str | None = None
+        self.process: subprocess.Popen[bytes] | None = None
        self.engine = engine
        self.host_tar_format = ""
        if sys.platform.startswith("darwin"):
@@ -246,10 +258,12 @@ class OCIContainer:
                # this allows to run local only images
                pull = "never"
        except subprocess.CalledProcessError:
+            # silently fallback to "--pull=always"
            pass
        return f"--platform={oci_platform.value}", f"--pull={pull}"

    def __enter__(self) -> Self:
+        assert self.process is None
        self.name = f"cibuildwheel-{uuid.uuid4()}"

        _check_engine_version(self.engine)
@@ -285,7 +299,17 @@ class OCIContainer:
                    ).strip()
                else:
                    raise
-            simulate_32_bit = container_machine not in {"i686", "armv7l", "armv8l"}
+            if container_machine not in {"i686", "armv7l", "armv8l"}:
+                simulate_32_bit = True
+                # sanity check to ensure no deadlock waiting for container to start
+                call(
+                    *run_cmd,
+                    *platform_args,
+                    self.image,
+                    "linux32",
+                    "/bin/true",
+                    capture_stdout=True,
+                )

        shell_args = ["linux32", "/bin/bash"] if simulate_32_bit else ["/bin/bash"]

@@ -307,32 +331,41 @@ class OCIContainer:
            check=True,
        )

-        self.process = subprocess.Popen(
-            [
-                self.engine.name,
-                "start",
-                "--attach",
-                "--interactive",
-                self.name,
-            ],
-            stdin=subprocess.PIPE,
-            stdout=subprocess.PIPE,
-        )
+        try:
+            self.process = subprocess.Popen(
+                [
+                    self.engine.name,
+                    "start",
+                    "--attach",
+                    "--interactive",
+                    self.name,
+                ],
+                stdin=subprocess.PIPE,
+                stdout=subprocess.PIPE,
+            )

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

-        # run a noop command to block until the container is responding
-        self.call(["/bin/true"], cwd="/")
-
-        if self.cwd:
-            # Although `docker create -w` does create the working dir if it
-            # does not exist, podman does not. There does not seem to be a way
-            # to setup a workdir for a container running in podman.
-            self.call(["mkdir", "-p", os.fspath(self.cwd)], cwd="/")
+            # run a noop command to block until the container is responding
+            self.call(["/bin/true"], cwd="/")

+            if self.cwd:
+                # Although `docker create -w` does create the working dir if it
+                # does not exist, podman does not. There does not seem to be a way
+                # to setup a workdir for a container running in podman.
+                self.call(["mkdir", "-p", os.fspath(self.cwd)], cwd="/")
+        except BaseException:
+            # clean-up
+            if self.process is not None:
+                if self.process.poll() is None:
+                    self.process.kill()
+                self.process.communicate()
+            self.process = None
+            self._remove_container()
+            raise
        return self

    def __exit__(
@@ -341,29 +374,52 @@ class OCIContainer:
        exc_val: BaseException | None,
        exc_tb: TracebackType | None,
    ) -> None:
-        self.bash_stdin.write(b"exit 0\n")
-        self.bash_stdin.flush()
-        self.process.wait(timeout=30)
-        self.bash_stdin.close()
-        self.bash_stdout.close()
+        assert self.process is not None
+        try:
+            # Ask bash to exit cleanly and wait for the `start` process to finish.
+            # If the container/bash has already died, the write raises
+            # BrokenPipeError; if bash refuses to exit, `wait` raises
+            # TimeoutExpired. Both are handled below so we always reach the
+            # cleanup in `finally` rather than leaking the process or container.
+            self.bash_stdin.write(b"exit 0\n")
+            self.bash_stdin.flush()
+            self.process.wait(timeout=30)

-        if self.engine.name == "podman":
-            # This works around what seems to be a race condition in the podman
-            # backend. The full reason is not understood. See PR #966 for a
-            # discussion on possible causes and attempts to remove this line.
-            # For now, this seems to work "well enough".
-            self.process.wait()
+            if self.engine.name == "podman":
+                # This works around what seems to be a race condition in the
+                # podman backend. The full reason is not understood. See PR #966
+                # for a discussion on possible causes and attempts to remove this
+                # line. For now, this seems to work "well enough".
+                self.process.wait()
+        except (OSError, subprocess.TimeoutExpired):
+            # bash didn't shut down cleanly; force the process down so it isn't
+            # leaked, then continue to cleanup.
+            if self.process.poll() is None:
+                self.process.kill()
+                self.process.wait()
+        finally:
+            with contextlib.suppress(OSError):
+                self.bash_stdin.close()
+            with contextlib.suppress(OSError):
+                self.bash_stdout.close()
+            self.process = None

-        assert isinstance(self.name, str)
+            keep_container = strtobool(os.environ.get("CIBW_DEBUG_KEEP_CONTAINER", ""))
+            if not keep_container:
+                self._remove_container()

-        keep_container = strtobool(os.environ.get("CIBW_DEBUG_KEEP_CONTAINER", ""))
-        if not keep_container:
-            subprocess.run(
-                [self.engine.name, "rm", "--force", "-v", self.name],
-                stdout=subprocess.DEVNULL,
-                check=False,
-            )
-            self.name = None
+    def _remove_container(self) -> None:
+        assert self.name is not None
+        result = subprocess.run(
+            [self.engine.name, "rm", "--force", "-v", self.name],
+            stdout=subprocess.DEVNULL,
+            check=False,
+        )
+        # only warn when not running in CI
+        if result.returncode != 0 and detect_ci_provider() is None:
+            msg = f"Failed to remove {self.name!r} container."
+            log.warning(msg)
+        self.name = None

    def copy_into(self, from_path: Path, to_path: PurePath) -> None:
        if from_path.is_dir():
@@ -515,20 +571,19 @@ class OCIContainer:
                capture_output=True,
            )
        )
-        return typing.cast(dict[str, str], env)
+        return typing.cast("dict[str, str]", env)

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

    def debug_info(self) -> str:
+        command = [self.engine.name, "info"]
        if self.engine.name == "podman":
-            command = f"{self.engine.name} info --debug"
-        else:
-            command = f"{self.engine.name} info"
+            command.append("--debug")
+
        completed = subprocess.run(
            command,
-            shell=True,
            check=True,
            cwd=self.cwd,
            stdin=subprocess.PIPE,
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import collections
 import configparser
 import contextlib
@@ -8,24 +10,29 @@ import functools
 import shlex
 import textwrap
 import tomllib
-from collections.abc import Callable, Generator, Iterable, Mapping, Sequence, Set
+from collections.abc import Mapping, Sequence
 from pathlib import Path
-from typing import Any, Final, Literal, Self, assert_never
+from typing import assert_never

 from packaging.specifiers import SpecifierSet

-from . import errors
-from .architecture import Architecture
-from .environment import EnvironmentParseError, ParsedEnvironment, parse_environment
-from .frontend import BuildFrontendConfig
-from .logger import log
-from .oci_container import OCIContainerEngineConfig
-from .projectfiles import get_requires_python_str, resolve_dependency_groups
-from .selector import BuildSelector, EnableGroup, TestSelector, selector_matches
-from .typing import PLATFORMS, PlatformName
-from .util import resources
-from .util.helpers import format_safe, strtobool, unwrap
-from .util.packaging import DependencyConstraints
+from cibuildwheel import errors
+from cibuildwheel.architecture import Architecture
+from cibuildwheel.environment import EnvironmentParseError, ParsedEnvironment, parse_environment
+from cibuildwheel.frontend import BuildFrontendConfig
+from cibuildwheel.logger import log
+from cibuildwheel.oci_container import OCIContainerEngineConfig
+from cibuildwheel.projectfiles import get_requires_python_str, resolve_dependency_groups
+from cibuildwheel.selector import BuildSelector, EnableGroup, TestSelector, selector_matches
+from cibuildwheel.typing import PLATFORMS, PlatformName
+from cibuildwheel.util import resources
+from cibuildwheel.util.helpers import format_safe, parse_key_value_string, strtobool, unwrap
+from cibuildwheel.util.packaging import DependencyConstraints
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable, Generator, Iterable, Set
+    from typing import Any, Final, Literal, Self

 MANYLINUX_ARCHS: Final[tuple[str, ...]] = (
    "x86_64",
@@ -92,6 +99,20 @@ class GlobalOptions:
    allow_empty: bool


+@dataclasses.dataclass(frozen=True)
+class TestRuntimeConfig:
+    args: Sequence[str] = ()
+
+    @classmethod
+    def from_config_string(cls, config_string: str) -> Self:
+        config_dict = parse_key_value_string(config_string, [], ["args"])
+        args = config_dict.get("args") or []
+        return cls(args=args)
+
+    def options_summary(self) -> str | dict[str, str]:
+        return {"args": repr(self.args)}
+
+
@dataclasses.dataclass(frozen=True, kw_only=True)
 class BuildOptions:
    globals: GlobalOptions
@@ -99,6 +120,7 @@ class BuildOptions:
    before_all: str
    before_build: str | None
    xbuild_tools: list[str] | None
+    xbuild_files: dict[str, list[str]]
    repair_command: str
    manylinux_images: dict[str, str] | None
    musllinux_images: dict[str, str] | None
@@ -110,6 +132,9 @@ class BuildOptions:
    test_extras: str
    test_groups: list[str]
    test_environment: ParsedEnvironment
+    test_runtime: TestRuntimeConfig
+    audit_requires: list[str]
+    audit_command: list[str]
    build_verbosity: int
    build_frontend: BuildFrontendConfig
    config_settings: str
@@ -691,11 +716,12 @@ class Options:

    def _check_pinned_image(self, value: str, pinned_images: Mapping[str, str]) -> None:
        error_set = {"manylinux1", "manylinux2010", "manylinux_2_24", "musllinux_1_1"}
+        # Currently no warnings, next: https://github.com/pypa/manylinux/issues/1925
        warning_set: set[str] = set()

        if value in error_set:
            msg = (
-                f"cibuildwheel 3.x does not support the image {value!r}. Either upgrade to a "
+                f"cibuildwheel 4.x does not support the image {value!r}. Either upgrade to a "
                "supported image or continue using the image by pinning it directly with"
                " its full OCI registry '<name>{:<tag>|@<digest>}'."
            )
@@ -747,6 +773,14 @@ class Options:
            if xbuild_tools == ["\u0000"]:
                xbuild_tools = None

+            xbuild_files = parse_key_value_string(
+                self.reader.get(
+                    "xbuild-files",
+                    option_format=ShlexTableFormat(sep="; ", pair_sep=":", allow_merge=False),
+                ),
+                kw_arg_names=["*"],
+            )
+
            test_sources = shlex.split(
                self.reader.get(
                    "test-sources", option_format=ListFormat(sep=" ", quote=shlex.quote)
@@ -761,6 +795,20 @@ class Options:
                msg = f"Malformed environment option {test_environment_config!r}"
                raise errors.ConfigurationError(msg) from e

+            test_runtime_str = self.reader.get(
+                "test-runtime",
+                env_plat=False,
+                option_format=ShlexTableFormat(sep="; ", pair_sep=":", allow_merge=False),
+            )
+            if not test_runtime_str:
+                test_runtime = TestRuntimeConfig()
+            else:
+                try:
+                    test_runtime = TestRuntimeConfig.from_config_string(test_runtime_str)
+                except ValueError as e:
+                    msg = f"Failed to parse test runtime config. {e}"
+                    raise errors.ConfigurationError(msg) from e
+
            test_requires = self.reader.get(
                "test-requires", option_format=ListFormat(sep=" ")
            ).split()
@@ -832,11 +880,7 @@ class Options:
                        f"manylinux-{build_platform}-image", ignore_empty=True
                    )
                    self._check_pinned_image(config_value, pinned_images)
-                    if config_value in pinned_images:
-                        image = pinned_images[config_value]
-                    else:
-                        image = config_value
-                    manylinux_images[build_platform] = image
+                    manylinux_images[build_platform] = pinned_images.get(config_value, config_value)

                for build_platform in MUSLLINUX_ARCHS:
                    pinned_images = all_pinned_container_images[build_platform]
@@ -844,11 +888,7 @@ class Options:
                        f"musllinux-{build_platform}-image", ignore_empty=True
                    )
                    self._check_pinned_image(config_value, pinned_images)
-                    if config_value in pinned_images:
-                        image = pinned_images[config_value]
-                    else:
-                        image = config_value
-                    musllinux_images[build_platform] = image
+                    musllinux_images[build_platform] = pinned_images.get(config_value, config_value)

            container_engine_str = self.reader.get(
                "container-engine",
@@ -863,11 +903,21 @@ class Options:

            pyodide_version = self.reader.get("pyodide-version", env_plat=False)

+            audit_command_str = self.reader.get(
+                "audit-command", option_format=ListFormat(sep=" && ")
+            )
+            audit_command = audit_command_str.split(" && ") if audit_command_str else []
+
+            audit_requires = self.reader.get(
+                "audit-requires", option_format=ListFormat(sep=" ")
+            ).split()
+
            return BuildOptions(
                globals=self.globals,
                test_command=test_command,
                test_sources=test_sources,
                test_environment=test_environment,
+                test_runtime=test_runtime,
                test_requires=[*test_requires, *test_requirements_from_groups],
                test_extras=test_extras,
                test_groups=test_groups,
@@ -876,6 +926,7 @@ class Options:
                before_all=before_all,
                build_verbosity=build_verbosity,
                xbuild_tools=xbuild_tools,
+                xbuild_files=xbuild_files,
                repair_command=repair_command,
                environment=environment,
                dependency_constraints=dependency_constraints,
@@ -885,6 +936,8 @@ class Options:
                config_settings=config_settings,
                container_engine=container_engine,
                pyodide_version=pyodide_version or None,
+                audit_command=audit_command,
+                audit_requires=audit_requires,
            )

    def check_for_invalid_configuration(self, identifiers: Iterable[str]) -> None:
@@ -957,8 +1010,8 @@ class Options:
    def option_summary(
        self,
        option_name: str,
-        option_value: Any,
-        default_value: Any,
+        option_value: Any,  # noqa: ANN401
+        default_value: Any,  # noqa: ANN401
        overrides: Mapping[str, Any] | None = None,
        skip_unset: bool = False,
    ) -> str | None:
@@ -1010,7 +1063,7 @@ class Options:
            return value

    @staticmethod
-    def option_summary_value(option_value: Any) -> str:
+    def option_summary_value(option_value: Any) -> str:  # noqa: ANN401
        if hasattr(option_value, "options_summary"):
            option_value = option_value.options_summary()

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

 import sys
-from collections.abc import Sequence
-from pathlib import Path
-from typing import Final, Protocol
+from typing import Protocol

 from cibuildwheel import errors
-from cibuildwheel.architecture import Architecture
-from cibuildwheel.options import Options
 from cibuildwheel.platforms import android, ios, linux, macos, pyodide, windows
-from cibuildwheel.selector import BuildSelector
-from cibuildwheel.typing import GenericPythonConfiguration, PlatformName
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+    from pathlib import Path
+    from typing import Final
+
+    from cibuildwheel.architecture import Architecture
+    from cibuildwheel.options import Options
+    from cibuildwheel.selector import BuildSelector
+    from cibuildwheel.typing import GenericPythonConfiguration, PlatformName


 class PlatformModule(Protocol):
@@ -1,5 +1,5 @@
-import csv
-import hashlib
+from __future__ import annotations
+
 import os
 import platform
 import re
@@ -7,9 +7,7 @@ import shlex
 import shutil
 import subprocess
 import sys
-from collections.abc import Iterable, Iterator
 from dataclasses import dataclass
-from os.path import relpath
 from pathlib import Path
 from pprint import pprint
 from runpy import run_path
@@ -18,30 +16,43 @@ from typing import Any

 from build import ProjectBuilder
 from build.env import IsolatedEnv
-from elftools.common.exceptions import ELFError
-from elftools.elf.elffile import ELFFile
 from filelock import FileLock
+from packaging.utils import canonicalize_name

-from .. import errors, platforms  # pylint: disable=cyclic-import
-from ..architecture import Architecture, arch_synonym
-from ..frontend import get_build_frontend_extra_flags, parse_config_settings
-from ..logger import log
-from ..options import BuildOptions, Options
-from ..selector import BuildSelector
-from ..util import resources
-from ..util.cmd import call, shell
-from ..util.file import CIBW_CACHE_PATH, copy_test_sources, download, move_file
-from ..util.helpers import prepare_command
-from ..util.packaging import find_compatible_wheel
-from ..util.python_build_standalone import create_python_build_standalone_environment
-from ..venv import constraint_flags, virtualenv
+from cibuildwheel import errors, platforms  # pylint: disable=cyclic-import
+from cibuildwheel.architecture import Architecture, arch_synonym
+from cibuildwheel.audit import run_audit
+from cibuildwheel.frontend import (
+    get_build_frontend_extra_flags,
+    parse_config_settings,
+    prepare_config_settings,
+)
+from cibuildwheel.logger import log
+from cibuildwheel.util import resources
+from cibuildwheel.util.cmd import call, shell
+from cibuildwheel.util.file import (
+    CIBW_CACHE_PATH,
+    copy_test_sources,
+    download,
+    move_file,
+    remove_on_error,
+)
+from cibuildwheel.util.helpers import prepare_command
+from cibuildwheel.util.packaging import find_compatible_wheel
+from cibuildwheel.util.python_build_standalone import create_python_build_standalone_environment
+from cibuildwheel.venv import constraint_flags, find_uv, virtualenv

+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from cibuildwheel.options import BuildOptions, Options
+    from cibuildwheel.selector import BuildSelector
+    from cibuildwheel.typing import PathOrStr

-def android_triplet(identifier: str) -> str:
-    return {
-        "arm64_v8a": "aarch64-linux-android",
-        "x86_64": "x86_64-linux-android",
-    }[parse_identifier(identifier)[1]]
+RESOURCES_ANDROID = resources.PATH / "android"
+ANDROID_TRIPLET = {
+    "arm64_v8a": "aarch64-linux-android",
+    "x86_64": "x86_64-linux-android",
+}


 def parse_identifier(identifier: str) -> tuple[str, str]:
@@ -53,11 +64,16 @@ def parse_identifier(identifier: str) -> tuple[str, str]:
    return (f"{major}.{minor}", arch)


+def android_triplet(identifier: str) -> str:
+    return ANDROID_TRIPLET[parse_identifier(identifier)[1]]
+
+
@dataclass(frozen=True)
 class PythonConfiguration:
    version: str
    identifier: str
    url: str
+    sha256: str

    @property
    def arch(self) -> str:
@@ -131,9 +147,11 @@ def build(options: Options, tmp_path: Path) -> None:
            build_path.mkdir()
            python_dir = setup_target_python(config, build_path)
            build_env, android_env = setup_env(config, build_options, build_path, python_dir)
+
            state = BuildState(
                config, build_options, build_path, python_dir, build_env, android_env
            )
+            setup_xbuild_files(state)

            compatible_wheel = find_compatible_wheel(built_wheels, config.identifier)
            if compatible_wheel:
@@ -146,6 +164,7 @@ def build(options: Options, tmp_path: Path) -> None:
                before_build(state)
                built_wheel = build_wheel(state)
                repaired_wheel = repair_wheel(state, built_wheel)
+                run_audit(tmp_dir=tmp_path, build_options=build_options, wheel=repaired_wheel)

            test_wheel(state, repaired_wheel)

@@ -169,11 +188,22 @@ def setup_target_python(config: PythonConfiguration, build_path: Path) -> Path:
    python_tgz = CIBW_CACHE_PATH / config.url.rpartition("/")[-1]
    with FileLock(f"{python_tgz}.lock"):
        if not python_tgz.exists():
-            download(config.url, python_tgz)
+            with remove_on_error(python_tgz):
+                download(config.url, python_tgz, sha256=config.sha256)

    python_dir = build_path / "python"
    python_dir.mkdir()
    shutil.unpack_archive(python_tgz, python_dir)
+
+    # Patch a testbed bug. This code and the patch file can both be removed once we've
+    # updated to Python versions that include the fix.
+    call("patch", "-p1", "-i", RESOURCES_ANDROID / "android.patch", cwd=python_dir)
+
+    # Work around https://github.com/python/cpython/issues/138800. This can be removed
+    # once we've updated to Python versions that include the fix.
+    pc_path = python_dir / f"prefix/lib/pkgconfig/python-{config.version}.pc"
+    pc_path.write_text(pc_path.read_text().replace("$(BLDLIBRARY)", f"-lpython{config.version}"))
+
    return python_dir


@@ -187,6 +217,7 @@ def setup_env(
    * android_env, which uses the environment while simulating running on Android.
    """
    log.step("Setting up build environment...")
+    use_uv, pip = find_pip(build_options)

    # Create virtual environment
    python_exe = create_python_build_standalone_environment(
@@ -197,33 +228,39 @@ def setup_env(
        version=config.version, tmp_dir=build_path
    )
    build_env = virtualenv(
-        config.version, python_exe, venv_dir, dependency_constraint, use_uv=False
+        config.version, python_exe, venv_dir, dependency_constraint, use_uv=use_uv
    )
    create_cmake_toolchain(config, build_path, python_dir, build_env)

+    # See platforms.md for the reason why we use this default API level.
+    build_env.setdefault("ANDROID_API_LEVEL", "24")
+
    # Apply custom environment variables, and check environment is still valid
    build_env = build_options.environment.as_dictionary(build_env)
+    build_env["CIBUILDWHEEL_BUILD_IDENTIFIER"] = config.identifier
    build_env["PIP_DISABLE_PIP_VERSION_CHECK"] = "1"
-    for command in ["python", "pip"]:
-        which = call("which", command, env=build_env, capture_stdout=True).strip()
-        if which != f"{venv_dir}/bin/{command}":
+    for command in ["python"] if use_uv else ["python", "pip"]:
+        command_path = call("which", command, env=build_env, capture_stdout=True).strip()
+        if command_path != f"{venv_dir}/bin/{command}":
            msg = (
                f"{command} available on PATH doesn't match our installed instance. If you "
                f"have modified PATH, ensure that you don't overwrite cibuildwheel's entry "
                f"or insert {command} above it."
            )
            raise errors.FatalError(msg)
-        call(command, "--version", env=build_env)
-
-    # Construct an altered environment which simulates running on Android.
-    android_env = setup_android_env(config, python_dir, venv_dir, build_env)
+        if command == "python":
+            call(command, "-V", "-V", env=build_env)
+        else:
+            call(command, "--version", env=build_env)

    # Install build tools
-    build_frontend = build_options.build_frontend
-    if build_frontend.name != "build":
-        msg = "Android requires the build frontend to be 'build'"
-        raise errors.FatalError(msg)
-    call("pip", "install", "build", *constraint_flags(dependency_constraint), env=build_env)
+    tools = ["auditwheel", "patchelf", "pkgconf"]
+    if build_options.build_frontend.name in {"build", "build[uv]"}:
+        tools.append("build")
+    call(*pip, "install", *tools, *constraint_flags(dependency_constraint), env=build_env)
+
+    # Construct an altered environment which simulates running on Android.
+    android_env = setup_android_env(config, python_dir, build_env)

    # Build-time requirements must be queried within android_env, because
    # `get_requires_for_build` can run arbitrary code in setup.py scripts, which may be
@@ -243,13 +280,18 @@ def setup_env(

    pb = ProjectBuilder.from_isolated_env(AndroidEnv(), build_options.package_dir)
    if pb.build_system_requires:
-        call("pip", "install", *pb.build_system_requires, env=build_env)
+        call(*pip, "install", *pb.build_system_requires, env=build_env)

    requires_for_build = pb.get_requires_for_build(
-        "wheel", parse_config_settings(build_options.config_settings)
+        "wheel",
+        parse_config_settings(
+            prepare_config_settings(
+                build_options.config_settings, project=".", package=build_options.package_dir
+            )
+        ),
    )
    if requires_for_build:
-        call("pip", "install", *requires_for_build, env=build_env)
+        call(*pip, "install", *requires_for_build, env=build_env)

    return build_env, android_env

@@ -274,11 +316,15 @@ def create_cmake_toolchain(
                set(CMAKE_SYSTEM_VERSION 1)

                # Tell CMake where to look for headers and libraries.
-                list(INSERT CMAKE_FIND_ROOT_PATH 0 {python_dir}/prefix)
+                set(CMAKE_FIND_ROOT_PATH "{python_dir}/prefix")
                set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
                set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
                set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
                set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE BOTH)
+
+                # Allow CMake to run Python in the simulated Android environment when
+                # policy CMP0190 is active.
+                set(CMAKE_CROSSCOMPILING_EMULATOR /bin/sh -c [["$0" "$@"]])
                """
            ),
            file=toolchain_file,
@@ -310,8 +356,11 @@ def localized_vars(
            final = final.replace(orig_prefix, str(prefix))

        if key == "ANDROID_API_LEVEL":
-            if api_level := build_env.get(key):
-                final = int(api_level)
+            try:
+                final = int(build_env[key])
+            except ValueError as e:
+                msg = f"ANDROID_API_LEVEL: {e}. This variable must be an integer."
+                raise errors.FatalError(msg) from e

        # Build systems vary in whether FLAGS variables are read from sysconfig, and if so,
        # whether they're replaced by environment variables or combined with them. Even
@@ -334,15 +383,15 @@ def localized_vars(


 def setup_android_env(
-    config: PythonConfiguration, python_dir: Path, venv_dir: Path, build_env: dict[str, str]
+    config: PythonConfiguration, python_dir: Path, build_env: dict[str, str]
 ) -> dict[str, str]:
-    site_packages = next(venv_dir.glob("lib/python*/site-packages"))
+    site_packages = find_site_packages(build_env)
    for suffix in ["pth", "py"]:
-        shutil.copy(resources.PATH / f"_cross_venv.{suffix}", site_packages)
+        shutil.copy(RESOURCES_ANDROID / f"_cross_venv.{suffix}", site_packages)

    sysconfigdata_path = Path(
        shutil.copy(
-            next(python_dir.glob("prefix/lib/python*/_sysconfigdata_*.py")),
+            glob1(python_dir, "prefix/lib/python*/_sysconfigdata_*.py"),
            site_packages,
        )
    )
@@ -378,6 +427,20 @@ def setup_android_env(
    for key in ["CFLAGS", "CXXFLAGS"]:
        android_env[key] += " " + opt

+    # Cargo target linker needs to be specified after CC is set
+    setup_rust(config, python_dir, android_env)
+
+    # Create shims which install additional build tools on first use.
+    setup_fortran(android_env)
+
+    # `android.py env` returns PKG_CONFIG="pkg-config --define-prefix", but some build
+    # systems can't handle arguments in that variable. Since we have a known version
+    # of pkgconf, it's safe to use PKG_CONFIG_RELOCATE_PATHS instead.
+    android_env["PKG_CONFIG"] = call(
+        "which", "pkgconf-pypi", env=build_env, capture_stdout=True
+    ).strip()
+    android_env["PKG_CONFIG_RELOCATE_PATHS"] = "1"
+
    # Format the environment so it can be pasted into a shell when debugging.
    for key, value in sorted(android_env.items()):
        if os.environ.get(key) != value:
@@ -386,42 +449,161 @@ def setup_android_env(
    return android_env


+def setup_rust(config: PythonConfiguration, python_dir: Path, env: dict[str, str]) -> None:
+    cargo_target = android_triplet(config.identifier)
+
+    # CARGO_BUILD_TARGET is the variable used by Cargo and setuptools_rust
+    env["CARGO_BUILD_TARGET"] = cargo_target
+
+    # The linker needs to be specified after CC is set by android-env.sh
+    cargo_target_linker_env_name = f"CARGO_TARGET_{cargo_target.upper().replace('-', '_')}_LINKER"
+    # CC has already been set by calling android.py (it calls android-env.sh)
+    env[cargo_target_linker_env_name] = env["CC"]
+
+    # All Python extension modules must be explicitly linked against libpython3.x.so when building for Android.
+    # See: https://peps.python.org/pep-0738/#linkage
+    # For projects using PyO3, this requires setting PYO3_CROSS_LIB_DIR to the directory containing libpython3.x.so.
+    # See: https://pyo3.rs/v0.27.1/building-and-distribution.html#cross-compiling
+    env["PYO3_CROSS_LIB_DIR"] = str(python_dir / "prefix" / "lib")
+
+    venv_bin = Path(env["VIRTUAL_ENV"]) / "bin"
+    for tool in ["cargo", "rustup"]:
+        shim_path = venv_bin / tool
+        shutil.copy(RESOURCES_ANDROID / "rust_shim.py", shim_path)
+        shim_path.chmod(0o755)
+
+
+def setup_fortran(env: dict[str, str]) -> None:
+    # In case there's any autodetection based on the executable name, use the same name
+    # as the real executable (see fortran_shim.run_flang)
+    shim_in = RESOURCES_ANDROID / "fortran_shim.py"
+    shim_out = Path(env["VIRTUAL_ENV"]) / "bin/flang-new"
+
+    # The hashbang line runs the shim in cibuildwheel's own virtual environment, so it
+    # has access to utility functions for downloading and caching files.
+    shim_out.write_text(f"#!{sys.executable}\n\n" + shim_in.read_text())
+    shim_out.chmod(0o755)
+    env["FC"] = str(shim_out)
+
+
+def setup_xbuild_files(state: BuildState) -> None:
+    _, pip = find_pip(state.options)
+    xbf_dir = state.build_path / "xbuild_files"
+    xbf_dir.mkdir()
+
+    for requirement in call(*pip, "freeze", env=state.build_env, capture_stdout=True).splitlines():
+        name, _, _ = requirement.strip().partition("==")
+        xbuild_files = state.options.xbuild_files.get(canonicalize_name(name), [])
+        if xbuild_files:
+            log.step(f"Installing xbuild-files for {name}...")
+            pip_install_android(state, xbf_dir, "--no-deps", requirement)
+            for xbf in xbuild_files:
+                if (xbf_dir / xbf).exists():
+                    shutil.copy(
+                        xbf_dir / xbf,
+                        find_site_packages(state.build_env) / xbf,
+                    )
+                else:
+                    log.warning(f"{xbf_dir / xbf} does not exist")
+
+
+def pip_install_android(state: BuildState, target: Path, *args: PathOrStr) -> None:
+    use_uv, pip = find_pip(state.options)
+    call(
+        *pip,
+        "install",
+        "--only-binary=:all:",
+        *(["--python-platform", android_triplet(state.config.identifier)] if use_uv else []),
+        "--target",
+        target,
+        *args,
+        env=state.android_env,
+    )
+
+
+def find_site_packages(env: dict[str, str]) -> Path:
+    return glob1(Path(env["VIRTUAL_ENV"]), "lib/python*/site-packages")
+
+
+def glob1(base: Path, pattern: str) -> Path:
+    results = list(base.glob(pattern))
+    if len(results) != 1:
+        msg = f"{base} contains {len(results)} paths matching '{pattern}'; expected 1"
+        raise errors.FatalError(msg)
+    return results[0]
+
+
+def find_pip(build_options: BuildOptions) -> tuple[bool, list[str]]:
+    use_uv = build_options.build_frontend.name in {"build[uv]", "uv"}
+    uv_path = find_uv()
+    if use_uv and uv_path is None:
+        msg = "uv not found"
+        raise AssertionError(msg)
+    pip = ["pip"] if not use_uv else [str(uv_path), "pip"]
+    return use_uv, pip
+
+
 def before_build(state: BuildState) -> None:
    if state.options.before_build:
        log.step("Running before_build...")
        shell_prepared(
            state.options.before_build,
            build_options=state.options,
-            env=state.build_env,
+            env=state.android_env,
        )


 def build_wheel(state: BuildState) -> Path:
    log.step("Building wheel...")
    built_wheel_dir = state.build_path / "built_wheel"
-    call(
-        "python",
-        "-m",
-        "build",
-        state.options.package_dir,
-        "--wheel",
-        "--no-isolation",
-        "--skip-dependency-check",
-        f"--outdir={built_wheel_dir}",
-        *get_build_frontend_extra_flags(
-            state.options.build_frontend,
-            state.options.build_verbosity,
-            state.options.config_settings,
-        ),
-        env=state.android_env,
-    )
-
-    built_wheels = list(built_wheel_dir.glob("*.whl"))
-    if len(built_wheels) != 1:
-        msg = f"{built_wheel_dir} contains {len(built_wheels)} wheels; expected 1"
-        raise errors.FatalError(msg)
-    built_wheel = built_wheels[0]
+    match state.options.build_frontend.name:
+        case "build" | "build[uv]":
+            call(
+                "python",
+                "-m",
+                "build",
+                state.options.package_dir,
+                "--wheel",
+                "--no-isolation",
+                "--skip-dependency-check",
+                f"--outdir={built_wheel_dir}",
+                *get_build_frontend_extra_flags(
+                    state.options.build_frontend,
+                    state.options.build_verbosity,
+                    prepare_config_settings(
+                        state.options.config_settings,
+                        project=".",
+                        package=state.options.package_dir,
+                    ),
+                ),
+                env=state.android_env,
+            )
+        case "uv":
+            uv_path = find_uv()
+            assert uv_path is not None
+            call(
+                uv_path,
+                "build",
+                state.options.package_dir,
+                "--wheel",
+                "--no-build-isolation",
+                f"--out-dir={built_wheel_dir}",
+                *get_build_frontend_extra_flags(
+                    state.options.build_frontend,
+                    state.options.build_verbosity,
+                    prepare_config_settings(
+                        state.options.config_settings,
+                        project=".",
+                        package=state.options.package_dir,
+                    ),
+                ),
+                env=state.android_env,
+            )
+        case x:
+            msg = f"Android requires the build frontend to be 'build' or 'uv', not {x!r}"
+            raise errors.FatalError(msg)

+    built_wheel = glob1(built_wheel_dir, "*.whl")
    if built_wheel.name.endswith("none-any.whl"):
        raise errors.NonPlatformWheelError()
    return built_wheel
@@ -433,21 +615,37 @@ def repair_wheel(state: BuildState, built_wheel: Path) -> Path:
    repaired_wheel_dir.mkdir()

    if state.options.repair_command:
+        # Tell auditwheel the locations of compiler libraries.
+        toolchain = Path(state.android_env["CC"]).parent.parent
+        triplet = android_triplet(state.config.identifier)
+        ldpaths = ":".join(
+            str(glob1(toolchain, pattern))
+            for pattern in [
+                f"lib/clang/*/lib/linux/{triplet.split('-')[0]}",  # libomp
+                f"sysroot/usr/lib/{triplet}",  # libc++_shared
+            ]
+        )
        shell(
            prepare_command(
-                state.options.repair_command, wheel=built_wheel, dest_dir=repaired_wheel_dir
+                state.options.repair_command,
+                ldpaths=ldpaths,
+                wheel=built_wheel,
+                dest_dir=repaired_wheel_dir,
+                package=state.options.package_dir,
+                project=".",
            ),
            env=state.build_env,
        )
    else:
-        repair_default(state.android_env, built_wheel, repaired_wheel_dir)
+        shutil.move(built_wheel, repaired_wheel_dir)

    repaired_wheels = list(repaired_wheel_dir.glob("*.whl"))
    if len(repaired_wheels) == 0:
        raise errors.RepairStepProducedNoWheelError()
    if len(repaired_wheels) != 1:
-        msg = f"{repaired_wheel_dir} contains {len(repaired_wheels)} wheels; expected 1"
-        raise errors.FatalError(msg)
+        raise errors.RepairStepProducedMultipleWheelsError(
+            [rw.name for rw in repaired_wheels],
+        )
    repaired_wheel = repaired_wheels[0]

    if repaired_wheel.name.endswith("none-any.whl"):
@@ -455,95 +653,6 @@ def repair_wheel(state: BuildState, built_wheel: Path) -> Path:
    return repaired_wheel


-def repair_default(
-    android_env: dict[str, str], built_wheel: Path, repaired_wheel_dir: Path
-) -> None:
-    """
-    Adds libc++ to the wheel if anything links against it. In the future this should be
-    moved to auditwheel and generalized to support more libraries.
-    """
-    if (match := re.search(r"^(.+?)-", built_wheel.name)) is None:
-        msg = f"Failed to parse wheel filename: {built_wheel.name}"
-        raise errors.FatalError(msg)
-    wheel_name = match[1]
-
-    unpacked_dir = repaired_wheel_dir / "unpacked"
-    unpacked_dir.mkdir()
-    shutil.unpack_archive(built_wheel, unpacked_dir, format="zip")
-
-    # Some build systems are inconsistent about name normalization, so don't assume the
-    # dist-info name is identical to the wheel name.
-    record_paths = list(unpacked_dir.glob("*.dist-info/RECORD"))
-    if len(record_paths) != 1:
-        msg = f"{built_wheel.name} contains {len(record_paths)} dist-info/RECORD files; expected 1"
-        raise errors.FatalError(msg)
-
-    old_soname = "libc++_shared.so"
-    paths_to_patch = []
-    for path, elffile in elf_file_filter(
-        unpacked_dir / filename
-        for filename, *_ in csv.reader(record_paths[0].read_text().splitlines())
-    ):
-        if (dynamic := elffile.get_section_by_name(".dynamic")) and any(  # type: ignore[no-untyped-call]
-            tag.entry.d_tag == "DT_NEEDED" and tag.needed == old_soname
-            for tag in dynamic.iter_tags()
-        ):
-            paths_to_patch.append(path)
-
-    if not paths_to_patch:
-        shutil.copyfile(built_wheel, repaired_wheel_dir / built_wheel.name)
-    else:
-        # Android doesn't support DT_RPATH, but supports DT_RUNPATH since API level 24
-        # (https://github.com/aosp-mirror/platform_bionic/blob/master/android-changes-for-ndk-developers.md).
-        if int(sysconfig_print('get_config_vars()["ANDROID_API_LEVEL"]', android_env)) < 24:
-            msg = f"Adding {old_soname} requires ANDROID_API_LEVEL to be at least 24"
-            raise errors.FatalError(msg)
-
-        toolchain = Path(android_env["CC"]).parent.parent
-        src_path = toolchain / f"sysroot/usr/lib/{android_env['CIBW_HOST_TRIPLET']}/{old_soname}"
-
-        # Use the same library location as auditwheel would.
-        libs_dir = unpacked_dir / (wheel_name + ".libs")
-        libs_dir.mkdir()
-        new_soname = soname_with_hash(src_path)
-        dst_path = libs_dir / new_soname
-        shutil.copyfile(src_path, dst_path)
-        call("patchelf", "--set-soname", new_soname, dst_path)
-
-        for path in paths_to_patch:
-            call("patchelf", "--replace-needed", old_soname, new_soname, path)
-            call(
-                "patchelf",
-                "--set-rpath",
-                f"${{ORIGIN}}/{relpath(libs_dir, path.parent)}",
-                path,
-            )
-        call(sys.executable, "-m", "wheel", "pack", unpacked_dir, "-d", repaired_wheel_dir)
-
-
-def elf_file_filter(paths: Iterable[Path]) -> Iterator[tuple[Path, ELFFile]]:
-    """Filter through an iterator of filenames and load up only ELF files"""
-    for path in paths:
-        if not path.name.endswith(".py"):
-            try:
-                with open(path, "rb") as f:
-                    candidate = ELFFile(f)  # type: ignore[no-untyped-call]
-                    yield path, candidate
-            except ELFError:
-                pass  # Not an ELF file
-
-
-def soname_with_hash(src_path: Path) -> str:
-    """Return the same library filename as auditwheel would"""
-    shorthash = hashlib.sha256(src_path.read_bytes()).hexdigest()[:8]
-    src_name = src_path.name
-    base, ext = src_name.split(".", 1)
-    if not base.endswith(f"-{shorthash}"):
-        return f"{base}-{shorthash}.{ext}"
-    else:
-        return src_name
-
-
 def test_wheel(state: BuildState, wheel: Path) -> None:
    test_command = state.options.test_command
    if not (test_command and state.options.test_selector(state.config.identifier)):
@@ -562,23 +671,17 @@ def test_wheel(state: BuildState, wheel: Path) -> None:
        shell_prepared(
            state.options.before_test,
            build_options=state.options,
-            env=state.build_env,
+            env=state.android_env,
        )

    # Install the wheel and test-requires.
    site_packages_dir = state.build_path / "site-packages"
    site_packages_dir.mkdir()
-    call(
-        "pip",
-        "install",
-        "--only-binary=:all:",
-        "--platform",
-        sysconfig_print("get_platform()", state.android_env).replace("-", "_"),
-        "--target",
+    pip_install_android(
+        state,
        site_packages_dir,
        f"{wheel}{state.options.test_extras}",
        *state.options.test_requires,
-        env=state.build_env,
    )

    # Copy test-sources.
@@ -592,7 +695,7 @@ def test_wheel(state: BuildState, wheel: Path) -> None:
        )

    # Android doesn't support placeholders in the test command.
-    if any(("{" + placeholder + "}") in test_command for placeholder in ["project", "package"]):
+    if any(("{" + placeholder + "}") in test_command for placeholder in ("project", "package")):
        msg = (
            f"Test command {test_command!r} with a "
            "'{project}' or '{package}' placeholder is not supported on Android, "
@@ -602,9 +705,12 @@ def test_wheel(state: BuildState, wheel: Path) -> None:

    # Parse test-command.
    test_args = shlex.split(test_command)
-    if test_args[:2] in [["python", "-c"], ["python", "-m"]]:
-        test_args[:3] = [test_args[1], test_args[2], "--"]
-    elif test_args[0] in ["pytest"]:
+    if test_args[0] in {"python", "python3"} and any(arg in test_args for arg in ("-c", "-m")):
+        # Forward the args to the CPython testbed script. We require '-c' or '-m'
+        # to be in the command, because without those flags, the testbed script
+        # will prepend '-m test', which will run Python's own test suite.
+        del test_args[0]
+    elif test_args[0] == "pytest":
        # We transform some commands into the `python -m` form, but this is deprecated.
        msg = (
            f"Test command {test_command!r} is not supported on Android. "
@@ -612,34 +718,36 @@ def test_wheel(state: BuildState, wheel: Path) -> None:
            "If this works, all you need to do is add that to your test command."
        )
        log.warning(msg)
-        test_args[:1] = ["-m", test_args[0], "--"]
+        test_args.insert(0, "-m")
    else:
        msg = (
            f"Test command {test_command!r} is not supported on Android. "
-            f"Supported commands are 'python -m' and 'python -c'."
+            f"Command must begin with 'python' or 'python3', and contain '-m' or '-c'."
        )
        raise errors.FatalError(msg)

+    # By default, run on a testbed managed emulator running the newest supported
+    # Android version. However, if the user specifies a --managed or --connected
+    # test execution argument, that argument takes precedence.
+    test_runtime_args = state.options.test_runtime.args
+
+    if any(arg.startswith(("--managed", "--connected")) for arg in test_runtime_args):
+        emulator_args = []
+    else:
+        emulator_args = ["--managed", "maxVersion"]
+
    # Run the test app.
    call(
        state.python_dir / "android.py",
        "test",
-        "--managed",
-        "maxVersion",
        "--site-packages",
        site_packages_dir,
        "--cwd",
        cwd_dir,
+        *emulator_args,
+        *(["-v"] if state.options.build_verbosity > 0 else []),
+        *test_runtime_args,
+        "--",
        *test_args,
        env=state.build_env,
    )
-
-
-def sysconfig_print(method_call: str, env: dict[str, str]) -> str:
-    return call(
-        "python",
-        "-c",
-        f'import sysconfig; print(sysconfig.{method_call}, end="")',
-        env=env,
-        capture_stdout=True,
-    )
@@ -2,43 +2,48 @@ from __future__ import annotations

 import dataclasses
 import os
+import platform
 import shlex
 import shutil
 import subprocess
 import sys
 import textwrap
-from collections.abc import Sequence, Set
 from pathlib import Path
 from typing import assert_never

 from filelock import FileLock
+from packaging.version import Version

-from .. import errors
-from ..architecture import Architecture
-from ..environment import ParsedEnvironment
-from ..frontend import (
+from cibuildwheel import errors
+from cibuildwheel.audit import run_audit
+from cibuildwheel.frontend import (
    BuildFrontendName,
    get_build_frontend_extra_flags,
+    prepare_config_settings,
 )
-from ..logger import log
-from ..options import Options
-from ..selector import BuildSelector
-from ..util import resources
-from ..util.cmd import call, shell, split_command
-from ..util.file import (
+from cibuildwheel.logger import log
+from cibuildwheel.platforms.macos import install_cpython as install_build_cpython
+from cibuildwheel.util import resources
+from cibuildwheel.util.cmd import call, shell, split_command
+from cibuildwheel.util.file import (
    CIBW_CACHE_PATH,
    copy_test_sources,
    download,
    move_file,
+    remove_on_error,
 )
-from ..util.helpers import prepare_command, unwrap_preserving_paragraphs
-from ..util.packaging import (
-    combine_constraints,
-    find_compatible_wheel,
-    get_pip_version,
-)
-from ..venv import constraint_flags, virtualenv
-from .macos import install_cpython as install_build_cpython
+from cibuildwheel.util.helpers import prepare_command, unwrap_preserving_paragraphs
+from cibuildwheel.util.packaging import find_compatible_wheel
+from cibuildwheel.venv import constraint_flags, virtualenv
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Sequence, Set
+
+    from cibuildwheel.architecture import Architecture
+    from cibuildwheel.environment import ParsedEnvironment
+    from cibuildwheel.options import Options
+    from cibuildwheel.selector import BuildSelector


@dataclasses.dataclass(frozen=True, kw_only=True)
@@ -47,6 +52,8 @@ class PythonConfiguration:
    identifier: str
    url: str
    build_url: str
+    build_sha256: str
+    sha256: str

    @property
    def sdk(self) -> str:
@@ -79,7 +86,7 @@ def all_python_configurations() -> list[PythonConfiguration]:
    # configuration.
    macos_python_configs = resources.read_python_configs("macos")

-    def build_url(config_dict: dict[str, str]) -> str:
+    def build_python_config(config_dict: dict[str, str]) -> dict[str, str]:
        # The iOS identifier will be something like cp313-ios_arm64_iphoneos.
        # Drop the iphoneos suffix, then replace ios with macosx to yield
        # cp313-macosx_arm64, which will be a macOS build identifier.
@@ -88,18 +95,22 @@ def all_python_configurations() -> list[PythonConfiguration]:
        matching = [
            config for config in macos_python_configs if config["identifier"] == macos_identifier
        ]
-        return matching[0]["url"]
+        return matching[0]

    # Load the platform configuration
    full_python_configs = resources.read_python_configs("ios")
    # Build the configurations, annotating with macOS URL details.
-    return [
-        PythonConfiguration(
-            **item,
-            build_url=build_url(item),
+    python_configurations = []
+    for item in full_python_configs:
+        build_config = build_python_config(item)
+        python_configurations.append(
+            PythonConfiguration(
+                **item,
+                build_url=build_config["url"],
+                build_sha256=build_config["sha256"],
+            )
        )
-        for item in full_python_configs
-    ]
+    return python_configurations


 def get_python_configurations(
@@ -134,9 +145,10 @@ def install_target_cpython(tmp: Path, config: PythonConfiguration, free_threadin
    with FileLock(str(installation_path) + ".lock"):
        if not installation_path.exists():
            downloaded_tar_gz = tmp / ios_python_tar_gz
-            download(config.url, downloaded_tar_gz)
-            installation_path.mkdir(parents=True, exist_ok=True)
-            call("tar", "-C", installation_path, "-xf", downloaded_tar_gz)
+            download(config.url, downloaded_tar_gz, sha256=config.sha256)
+            with remove_on_error(installation_path):
+                installation_path.mkdir(parents=True)
+                call("tar", "-C", installation_path, "-xf", downloaded_tar_gz)
            downloaded_tar_gz.unlink()

    return installation_path
@@ -191,18 +203,37 @@ def cross_virtualenv(
    )

    # Convert the macOS virtual environment into an iOS virtual environment
-    # using the cross-platform conversion script in the iOS distribution.
+    # using make_cross_venv.py.

    # target_python is the path to the Python binary;
    # determine the root of the XCframework slice that is being used.
    slice_path = target_python.parent.parent
-    call(
-        "python",
-        str(slice_path / f"platform-config/{multiarch}/make_cross_venv.py"),
-        str(venv_path),
-        env=env,
-        cwd=venv_path,
-    )
+    if Version(py_version) >= Version("3.15"):
+        # python.org 3.15+ distributions: sysconfig data lives in the
+        # stdlib directory (lib-<arch>/python<version>); cross-venv scripts
+        # come from cibuildwheel resources.
+        arch = multiarch.split("-", maxsplit=1)[0]
+        stdlib_path = slice_path / f"lib-{arch}" / f"python{py_version}"
+        call(
+            "python",
+            str(resources.IOS_SUPPORT_FILES / "make_cross_venv.py"),
+            str(venv_path),
+            str(stdlib_path),
+            str(resources.IOS_SUPPORT_FILES),
+            env=env,
+            cwd=venv_path,
+        )
+    else:
+        # BeeWare distributions: platform-config already contains both
+        # sysconfig data and the make_cross_venv.py script.
+        platform_config_path = slice_path / f"platform-config/{multiarch}"
+        call(
+            "python",
+            str(platform_config_path / "make_cross_venv.py"),
+            str(venv_path),
+            env=env,
+            cwd=venv_path,
+        )

    # When running on macOS, it's easy for the build environment to leak into
    # the target environment, especially when building for ARM64 (because the
@@ -282,7 +313,8 @@ def setup_python(
    build_frontend: BuildFrontendName,
    xbuild_tools: Sequence[str] | None,
 ) -> tuple[Path, dict[str, str]]:
-    if build_frontend == "build[uv]":
+    # Not using set because mypy can't narrow it
+    if build_frontend == "build[uv]" or build_frontend == "uv":  # noqa: PLR1714
        msg = "uv doesn't support iOS"
        raise errors.FatalError(msg)

@@ -300,6 +332,7 @@ def setup_python(
            python_configuration.version,
            python_configuration.build_url,
            free_threading,
+            python_configuration.build_sha256,
        )
    else:
        msg = f"Unknown Python implementation: {implementation_id}"
@@ -319,8 +352,8 @@ def setup_python(
        / f"python{python_configuration.version}"
    )

-    assert target_python.exists(), (
-        f"{target_python.name} not found, has {list(target_install_path.iterdir())}"
+    assert target_python.parent.exists(), (
+        f"{target_python.parent} not found, has {list(target_install_path.iterdir())}"
    )

    log.step("Creating cross build environment...")
@@ -367,7 +400,7 @@ def setup_python(
            "entry or insert python above it."
        )
        raise errors.FatalError(msg)
-    call("python", "--version", env=env)
+    call("python", "-V", "-V", env=env)

    # Check what pip version we're on
    assert (venv_bin_path / "pip").exists()
@@ -439,7 +472,8 @@ def build(options: Options, tmp_path: Path) -> None:
            build_options = options.build_options(config.identifier)
            build_frontend = build_options.build_frontend
            # uv doesn't support iOS
-            if build_frontend.name == "build[uv]":
+            # Not using set because mypy can't narrow it
+            if build_frontend.name == "build[uv]" or build_frontend.name == "uv":  # noqa: PLR1714
                msg = "uv doesn't support iOS"
                raise errors.FatalError(msg)

@@ -448,6 +482,7 @@ def build(options: Options, tmp_path: Path) -> None:
            identifier_tmp_dir = tmp_path / config.identifier
            identifier_tmp_dir.mkdir()
            built_wheel_dir = identifier_tmp_dir / "built_wheel"
+            repaired_wheel_dir = identifier_tmp_dir / "repaired_wheel"

            constraints_path = build_options.dependency_constraints.get_for_python_version(
                version=config.version, tmp_dir=identifier_tmp_dir
@@ -461,7 +496,7 @@ def build(options: Options, tmp_path: Path) -> None:
                build_frontend=build_frontend.name,
                xbuild_tools=build_options.xbuild_tools,
            )
-            pip_version = get_pip_version(env)
+            env["CIBUILDWHEEL_BUILD_IDENTIFIER"] = config.identifier

            compatible_wheel = find_compatible_wheel(built_wheels, config.identifier)
            if compatible_wheel:
@@ -486,14 +521,15 @@ def build(options: Options, tmp_path: Path) -> None:
                built_wheel_dir.mkdir()

                extra_flags = get_build_frontend_extra_flags(
-                    build_frontend, build_options.build_verbosity, build_options.config_settings
+                    build_frontend,
+                    build_options.build_verbosity,
+                    prepare_config_settings(
+                        build_options.config_settings,
+                        project=".",
+                        package=build_options.package_dir,
+                    ),
                )

-                build_env = env.copy()
-                build_env["VIRTUALENV_PIP"] = pip_version
-                if constraints_path:
-                    combine_constraints(build_env, constraints_path, None)
-
                match build_frontend.name:
                    case "pip":
                        # Path.resolve() is needed. Without it pip wheel may try to
@@ -508,7 +544,7 @@ def build(options: Options, tmp_path: Path) -> None:
                            f"--wheel-dir={built_wheel_dir}",
                            "--no-deps",
                            *extra_flags,
-                            env=build_env,
+                            env=env,
                        )
                    case "build":
                        call(
@@ -519,27 +555,52 @@ def build(options: Options, tmp_path: Path) -> None:
                            "--wheel",
                            f"--outdir={built_wheel_dir}",
                            *extra_flags,
-                            env=build_env,
+                            env=env,
                        )
                    case _:
                        assert_never(build_frontend)

-                test_wheel = built_wheel = next(built_wheel_dir.glob("*.whl"))
+                built_wheel = next(built_wheel_dir.glob("*.whl"))

                if built_wheel.name.endswith("none-any.whl"):
                    raise errors.NonPlatformWheelError()

+                repaired_wheel_dir.mkdir()
+                if build_options.repair_command:
+                    log.step("Repairing wheel...")
+
+                    repair_command_prepared = prepare_command(
+                        build_options.repair_command,
+                        wheel=built_wheel,
+                        dest_dir=repaired_wheel_dir,
+                        package=build_options.package_dir,
+                        project=".",
+                    )
+                    shell(repair_command_prepared, env=env)
+                else:
+                    shutil.move(str(built_wheel), repaired_wheel_dir)
+
+                try:
+                    repaired_wheel = next(repaired_wheel_dir.glob("*.whl"))
+                except StopIteration:
+                    raise errors.RepairStepProducedNoWheelError() from None
+
+                if repaired_wheel.name in {wheel.name for wheel in built_wheels}:
+                    raise errors.AlreadyBuiltWheelError(repaired_wheel.name)
+
                log.step_end()

+                run_audit(tmp_dir=tmp_path, build_options=build_options, wheel=repaired_wheel)
+
+                test_wheel = repaired_wheel
+
            if build_options.test_command and build_options.test_selector(config.identifier):
                if not config.is_simulator:
                    log.step("Skipping tests on non-simulator SDK")
                elif config.arch != os.uname().machine:
                    log.step("Skipping tests on non-native simulator architecture")
                else:
-                    test_env = build_options.test_environment.as_dictionary(
-                        prev_environment=build_env
-                    )
+                    test_env = build_options.test_environment.as_dictionary(prev_environment=env)

                    if build_options.before_test:
                        before_test_prepared = prepare_command(
@@ -653,11 +714,35 @@ def build(options: Options, tmp_path: Path) -> None:
                                    )
                                    raise errors.FatalError(msg)

+                            test_runtime_args = build_options.test_runtime.args
+
+                            # 2025-10: The GitHub Actions macos-15 runner has a known issue where
+                            # the default simulator won't start due to a disk performance issue;
+                            # see https://github.com/actions/runner-images/issues/12777 for details.
+                            # In the meantime, if it looks like we're running on a GitHub Actions
+                            # macos-15 runner, use a simulator that is known to work, unless the
+                            # user explicitly specifies a simulator.
+                            os_version, _, arch = platform.mac_ver()
+                            if (
+                                "GITHUB_ACTIONS" in os.environ
+                                and os_version.startswith("15.")
+                                and arch == "arm64"
+                                and not any(
+                                    arg.startswith("--simulator") for arg in test_runtime_args
+                                )
+                            ):
+                                test_runtime_args = [
+                                    "--simulator",
+                                    "iPhone 16e,OS=18.5",
+                                    *test_runtime_args,
+                                ]
+
                            call(
                                "python",
                                testbed_path,
                                "run",
                                *(["--verbose"] if build_options.build_verbosity > 0 else []),
+                                *test_runtime_args,
                                "--",
                                *final_command,
                                env=test_env,
@@ -674,11 +759,11 @@ def build(options: Options, tmp_path: Path) -> None:
            # We're all done here; move it to output (overwrite existing)
            output_wheel: Path | None = None
            if compatible_wheel is None:
-                output_wheel = build_options.output_dir.joinpath(built_wheel.name)
-                moved_wheel = move_file(built_wheel, output_wheel)
+                output_wheel = build_options.output_dir.joinpath(repaired_wheel.name)
+                moved_wheel = move_file(repaired_wheel, output_wheel)
                if moved_wheel != output_wheel.resolve():
                    log.warning(
-                        f"{built_wheel} was moved to {moved_wheel} instead of {output_wheel}"
+                        f"{repaired_wheel} was moved to {moved_wheel} instead of {output_wheel}"
                    )
                built_wheels.append(output_wheel)

@@ -1,25 +1,33 @@
+from __future__ import annotations
+
 import contextlib
 import dataclasses
+import shutil
 import subprocess
 import sys
 import textwrap
 from collections import OrderedDict
-from collections.abc import Iterable, Iterator, Sequence, Set
 from pathlib import Path, PurePath, PurePosixPath
 from typing import assert_never

-from .. import errors
-from ..architecture import Architecture
-from ..frontend import get_build_frontend_extra_flags
-from ..logger import log
-from ..oci_container import OCIContainer, OCIContainerEngineConfig, OCIPlatform
-from ..options import BuildOptions, Options
-from ..selector import BuildSelector
-from ..typing import PathOrStr
-from ..util import resources
-from ..util.file import copy_test_sources
-from ..util.helpers import prepare_command, unwrap
-from ..util.packaging import find_compatible_wheel
+from cibuildwheel import errors
+from cibuildwheel.architecture import Architecture
+from cibuildwheel.audit import needs_audit, run_audit
+from cibuildwheel.frontend import get_build_frontend_extra_flags, prepare_config_settings
+from cibuildwheel.logger import log
+from cibuildwheel.oci_container import OCIContainer, OCIContainerEngineConfig, OCIPlatform
+from cibuildwheel.util import resources
+from cibuildwheel.util.file import copy_test_sources
+from cibuildwheel.util.helpers import prepare_command, unwrap
+from cibuildwheel.util.packaging import find_compatible_wheel
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Iterable, Iterator, Sequence, Set
+
+    from cibuildwheel.options import BuildOptions, Options
+    from cibuildwheel.selector import BuildSelector
+    from cibuildwheel.typing import PathOrStr

 ARCHITECTURE_OCI_PLATFORM_MAP = {
    Architecture.x86_64: OCIPlatform.AMD64,
@@ -205,7 +213,7 @@ def build_in_container(
        local_identifier_tmp_dir = local_tmp_dir / config.identifier
        build_options = options.build_options(config.identifier)
        build_frontend = build_options.build_frontend
-        use_uv = build_frontend.name == "build[uv]"
+        use_uv = build_frontend.name in {"build[uv]", "uv"}
        pip = ["uv", "pip"] if use_uv else ["pip"]

        log.step("Setting up build environment...")
@@ -229,12 +237,14 @@ def build_in_container(
        env["PATH"] = f"{python_bin}:{env['PATH']}"

        env = build_options.environment.as_dictionary(env, executor=container.environment_executor)
+        env["CIBUILDWHEEL_BUILD_IDENTIFIER"] = config.identifier

        # check config python is still on PATH
        which_python = container.call(["which", "python"], env=env, capture_output=True).strip()
        if PurePosixPath(which_python) != python_bin / "python":
            msg = "python available on PATH doesn't match our installed instance. If you have modified PATH, ensure that you don't overwrite cibuildwheel's entry or insert python above it."
            raise errors.FatalError(msg)
+        container.call(["python", "-V", "-V"], env=env)

        if use_uv:
            which_uv = container.call(["which", "uv"], env=env, capture_output=True).strip()
@@ -262,7 +272,16 @@ def build_in_container(
                    project=container_project_path,
                    package=container_package_dir,
                )
-                container.call(["sh", "-c", before_build_prepared], env=env)
+                before_build_env = env.copy()
+                if use_uv:
+                    # On Linux, no virtualenv is created for the build environment
+                    # (unlike macOS/Windows, where one is set up before before_build
+                    # runs). uv requires either an active venv or an explicit Python
+                    # target to install packages. Pin UV_PYTHON to the exact interpreter
+                    # for this build so that `uv pip install` works in before_build
+                    # without requiring users to pass --system.
+                    before_build_env["UV_PYTHON"] = str(python_bin / "python")
+                container.call(["sh", "-c", before_build_prepared], env=before_build_env)

            log.step("Building wheel...")

@@ -272,7 +291,13 @@ def build_in_container(
            container.call(["mkdir", "-p", built_wheel_dir])

            extra_flags = get_build_frontend_extra_flags(
-                build_frontend, build_options.build_verbosity, build_options.config_settings
+                build_frontend,
+                build_options.build_verbosity,
+                prepare_config_settings(
+                    build_options.config_settings,
+                    project=container_project_path,
+                    package=container_package_dir,
+                ),
            )

            match build_frontend.name:
@@ -305,6 +330,19 @@ def build_in_container(
                        ],
                        env=env,
                    )
+                case "uv":
+                    container.call(
+                        [
+                            "uv",
+                            "build",
+                            f"--python={python_bin / 'python'}",
+                            container_package_dir,
+                            "--wheel",
+                            f"--out-dir={built_wheel_dir}",
+                            *extra_flags,
+                        ],
+                        env=env,
+                    )
                case _:
                    assert_never(build_frontend)

@@ -320,7 +358,11 @@ def build_in_container(
            if build_options.repair_command:
                log.step("Repairing wheel...")
                repair_command_prepared = prepare_command(
-                    build_options.repair_command, wheel=built_wheel, dest_dir=repaired_wheel_dir
+                    build_options.repair_command,
+                    wheel=built_wheel,
+                    dest_dir=repaired_wheel_dir,
+                    package=container_package_dir,
+                    project=container_project_path,
                )
                container.call(["sh", "-c", repair_command_prepared], env=env)
            else:
@@ -337,6 +379,18 @@ def build_in_container(
            if repaired_wheel.name in {wheel.name for wheel in built_wheels}:
                raise errors.AlreadyBuiltWheelError(repaired_wheel.name)

+            log.step_end()
+
+            if needs_audit(build_options.audit_command, repaired_wheel.name):
+                local_abi3audit_dir = local_identifier_tmp_dir / "audit"
+                local_abi3audit_dir.mkdir(parents=True, exist_ok=True)
+                try:
+                    container.copy_out(repaired_wheel_dir, local_abi3audit_dir)
+                    local_wheel = local_abi3audit_dir / repaired_wheel.name
+                    run_audit(tmp_dir=local_tmp_dir, build_options=build_options, wheel=local_wheel)
+                finally:
+                    shutil.rmtree(local_abi3audit_dir, ignore_errors=True)
+
        if build_options.test_command and build_options.test_selector(config.identifier):
            log.step("Testing wheel...")

@@ -439,7 +493,7 @@ def build(options: Options, tmp_path: Path) -> None:
    abs_package_dir = options.globals.package_dir.resolve()
    if cwd != abs_package_dir and cwd not in abs_package_dir.parents:
        msg = "package_dir must be inside the working directory"
-        raise Exception(msg)
+        raise errors.ConfigurationError(msg)

    container_project_path = PurePosixPath("/project")
    container_package_dir = container_project_path / abs_package_dir.relative_to(cwd)
@@ -459,8 +513,7 @@ def build(options: Options, tmp_path: Path) -> None:
                Docker or Podman is required to run Linux builds. 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.
+                `setup_remote_docker` step to your .circleci/config.yml.
                """
            )
            raise errors.ConfigurationError(msg) from error
@@ -503,6 +556,7 @@ def _matches_prepared_command(error_cmd: Sequence[str], command_template: str) -
 def troubleshoot(options: Options, error: Exception) -> None:
    if isinstance(error, subprocess.CalledProcessError) and (
        error.cmd[0:4] == ["python", "-m", "pip", "wheel"]
+        or error.cmd[0:2] == ["uv", "build"]
        or error.cmd[0:3] == ["python", "-m", "build"]
        or _matches_prepared_command(
            error.cmd, options.build_options(None).repair_command
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import dataclasses
 import functools
 import inspect
@@ -8,32 +10,43 @@ import shutil
 import subprocess
 import sys
 import typing
-from collections.abc import Set
 from pathlib import Path
-from typing import Literal, assert_never
+from typing import assert_never

 from filelock import FileLock
 from packaging.version import Version

-from .. import errors
-from ..architecture import Architecture
-from ..ci import detect_ci_provider
-from ..environment import ParsedEnvironment
-from ..frontend import BuildFrontendName, get_build_frontend_extra_flags
-from ..logger import log
-from ..options import Options
-from ..selector import BuildSelector
-from ..util import resources
-from ..util.cmd import call, shell
-from ..util.file import (
+from cibuildwheel import errors
+from cibuildwheel.audit import run_audit
+from cibuildwheel.ci import detect_ci_provider
+from cibuildwheel.frontend import (
+    BuildFrontendName,
+    get_build_frontend_extra_flags,
+    prepare_config_settings,
+)
+from cibuildwheel.logger import log
+from cibuildwheel.util import resources
+from cibuildwheel.util.cmd import call, shell
+from cibuildwheel.util.file import (
    CIBW_CACHE_PATH,
    copy_test_sources,
    download,
    move_file,
+    remove_on_error,
 )
-from ..util.helpers import prepare_command, unwrap
-from ..util.packaging import combine_constraints, find_compatible_wheel, get_pip_version
-from ..venv import constraint_flags, find_uv, virtualenv
+from cibuildwheel.util.helpers import prepare_command, unwrap
+from cibuildwheel.util.packaging import find_compatible_wheel, get_pip_version
+from cibuildwheel.venv import constraint_flags, find_uv, target_marker_env, virtualenv
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Set
+    from typing import Literal
+
+    from cibuildwheel.architecture import Architecture
+    from cibuildwheel.environment import ParsedEnvironment
+    from cibuildwheel.options import Options
+    from cibuildwheel.selector import BuildSelector


@functools.cache
@@ -60,7 +73,7 @@ def get_macos_version() -> tuple[int, int]:
            capture_stdout=True,
        )
        version = tuple(map(int, version_str.split(".")[:2]))
-    return typing.cast(tuple[int, int], version)
+    return typing.cast("tuple[int, int]", version)


@functools.cache
@@ -81,6 +94,7 @@ class PythonConfiguration:
    version: str
    identifier: str
    url: str
+    sha256: str


 def all_python_configurations() -> list[PythonConfiguration]:
@@ -128,7 +142,7 @@ def get_python_configurations(
    return python_configurations


-def install_cpython(_tmp: Path, version: str, url: str, free_threading: bool) -> Path:
+def install_cpython(_tmp: Path, version: str, url: str, free_threading: bool, sha256: str) -> Path:
    ft = "T" if free_threading else ""
    installation_path = Path(f"/Library/Frameworks/Python{ft}.framework/Versions/{version}")
    with FileLock(CIBW_CACHE_PATH / f"cpython{version}.lock"):
@@ -141,7 +155,8 @@ def install_cpython(_tmp: Path, version: str, url: str, free_threading: bool) ->
                # let the user know & provide a link to the installer
                msg = inspect.cleandoc(
                    f"""
-                        Error: CPython {version} is not installed.
+                        Framework CPython {version} not detected as installed in:
+                            {installation_path}
                        cibuildwheel will not perform system-wide installs when running outside of CI.
                        To build locally, install CPython {version} on this machine, or, disable this
                        version of Python using CIBW_SKIP=cp{version.replace(".", "")}-macosx_*
@@ -150,16 +165,15 @@ def install_cpython(_tmp: Path, version: str, url: str, free_threading: bool) ->
                    """
                )
                raise errors.FatalError(msg)
-            python_filename = url.split("/")[-1]
+            python_filename = url.rsplit("/", maxsplit=1)[-1]
            pkg_path = CIBW_CACHE_PATH / "cpython-installer" / python_filename
            if not pkg_path.exists():
-                download(url, pkg_path)
+                download(url, pkg_path, sha256=sha256)
            args = []
-            if version.startswith("3.13"):
-                # Python 3.13 is the first version to have a free-threading option
-                args += ["-applyChoiceChangesXML", str(resources.FREE_THREAD_ENABLE_313.resolve())]
-            elif version.startswith("3.14"):
+            if version.startswith("3.14"):
                args += ["-applyChoiceChangesXML", str(resources.FREE_THREAD_ENABLE_314.resolve())]
+            elif version.startswith("3.15"):
+                args += ["-applyChoiceChangesXML", str(resources.FREE_THREAD_ENABLE_315.resolve())]
            call("sudo", "installer", "-pkg", pkg_path, *args, "-target", "/")
            pkg_path.unlink()
            env = os.environ.copy()
@@ -178,7 +192,7 @@ def install_cpython(_tmp: Path, version: str, url: str, free_threading: bool) ->
    return installation_path / "bin" / (f"python{version}t" if free_threading else "python3")


-def install_pypy(tmp: Path, url: str) -> Path:
+def install_pypy(tmp: Path, url: str, sha256: str) -> Path:
    pypy_tar_bz2 = url.rsplit("/", 1)[-1]
    extension = ".tar.bz2"
    assert pypy_tar_bz2.endswith(extension)
@@ -186,14 +200,15 @@ def install_pypy(tmp: Path, url: str) -> Path:
    with FileLock(str(installation_path) + ".lock"):
        if not installation_path.exists():
            downloaded_tar_bz2 = tmp / pypy_tar_bz2
-            download(url, downloaded_tar_bz2)
+            download(url, downloaded_tar_bz2, sha256=sha256)
            installation_path.parent.mkdir(parents=True, exist_ok=True)
-            call("tar", "-C", installation_path.parent, "-xf", downloaded_tar_bz2)
+            with remove_on_error(installation_path):
+                call("tar", "-C", installation_path.parent, "-xf", downloaded_tar_bz2)
            downloaded_tar_bz2.unlink()
    return installation_path / "bin" / "pypy3"


-def install_graalpy(tmp: Path, url: str) -> Path:
+def install_graalpy(tmp: Path, url: str, sha256: str) -> Path:
    graalpy_archive = url.rsplit("/", 1)[-1]
    extension = ".tar.gz"
    assert graalpy_archive.endswith(extension)
@@ -201,10 +216,18 @@ def install_graalpy(tmp: Path, url: str) -> Path:
    with FileLock(str(installation_path) + ".lock"):
        if not installation_path.exists():
            downloaded_archive = tmp / graalpy_archive
-            download(url, downloaded_archive)
-            installation_path.mkdir(parents=True)
-            # GraalPy top-folder name is inconsistent with archive name
-            call("tar", "-C", installation_path, "--strip-components=1", "-xzf", downloaded_archive)
+            download(url, downloaded_archive, sha256=sha256)
+            with remove_on_error(installation_path):
+                installation_path.mkdir(parents=True)
+                # GraalPy top-folder name is inconsistent with archive name
+                call(
+                    "tar",
+                    "-C",
+                    installation_path,
+                    "--strip-components=1",
+                    "-xzf",
+                    downloaded_archive,
+                )
            downloaded_archive.unlink()
    return installation_path / "bin" / "graalpy"

@@ -217,7 +240,7 @@ def setup_python(
    build_frontend: BuildFrontendName,
 ) -> tuple[Path, dict[str, str]]:
    uv_path = find_uv()
-    use_uv = build_frontend == "build[uv]"
+    use_uv = build_frontend in {"build[uv]", "uv"}

    tmp.mkdir()
    implementation_id = python_configuration.identifier.split("-")[0]
@@ -225,13 +248,17 @@ def setup_python(
    if implementation_id.startswith("cp"):
        free_threading = "t-macos" in python_configuration.identifier
        base_python = install_cpython(
-            tmp, python_configuration.version, python_configuration.url, free_threading
+            tmp,
+            python_configuration.version,
+            python_configuration.url,
+            free_threading,
+            python_configuration.sha256,
        )

    elif implementation_id.startswith("pp"):
-        base_python = install_pypy(tmp, python_configuration.url)
+        base_python = install_pypy(tmp, python_configuration.url, python_configuration.sha256)
    elif implementation_id.startswith("gp"):
-        base_python = install_graalpy(tmp, python_configuration.url)
+        base_python = install_graalpy(tmp, python_configuration.url, python_configuration.sha256)
    else:
        msg = "Unknown Python implementation"
        raise ValueError(msg)
@@ -247,6 +274,7 @@ def setup_python(
        venv_path,
        dependency_constraint,
        use_uv=use_uv,
+        marker_env=target_marker_env(implementation_id=implementation_id),
    )
    venv_bin_path = venv_path / "bin"
    assert venv_bin_path.exists()
@@ -257,6 +285,10 @@ def setup_python(
    # https://github.com/pypa/virtualenv/issues/620
    # Also see https://github.com/python/cpython/pull/9516
    env.pop("__PYVENV_LAUNCHER__", None)
+    # uv uses this over the current environment's python, so remove it to avoid confusion
+    env.pop("PYTHON_VERSION", None)
+    env.pop("PYTHON_ARCH", None)
+    env.pop("UV_PYTHON", None)

    # we version pip ourselves, so we don't care about pip version checking
    env["PIP_DISABLE_PIP_VERSION_CHECK"] = "1"
@@ -270,7 +302,7 @@ def setup_python(
    if which_python != str(venv_bin_path / "python"):
        msg = "python available on PATH doesn't match our installed instance. If you have modified PATH, ensure that you don't overwrite cibuildwheel's entry or insert python above it."
        raise errors.FatalError(msg)
-    call("python", "--version", env=env)
+    call("python", "-V", "-V", env=env)

    # check what pip version we're on
    if not use_uv:
@@ -289,8 +321,11 @@ def setup_python(
    # For arm64, the minimal deployment target is 11.0.
    # On x86_64 (or universal2), use 10.9 as a default.
    # CPython 3.12.6+ needs 10.13.
+    # CPython 3.14.0 needs 10.15.
    if config_is_arm64:
        default_target = "11.0"
+    elif Version(python_configuration.version) >= Version("3.14"):
+        default_target = "10.15"
    elif Version(python_configuration.version) >= Version("3.12"):
        default_target = "10.13"
    elif python_configuration.identifier.startswith("pp") and Version(
@@ -371,12 +406,27 @@ def setup_python(
                uv_path,
                "pip",
                "install",
+                "--python",
+                which_python,
                "--upgrade",
                "delocate",
                "build[virtualenv, uv]",
                *constraint_flags(dependency_constraint),
                env=env,
            )
+        case "uv":
+            assert uv_path is not None
+            call(
+                uv_path,
+                "pip",
+                "install",
+                "--python",
+                which_python,
+                "--upgrade",
+                "delocate",
+                *constraint_flags(dependency_constraint),
+                env=env,
+            )
        case _:
            assert_never(build_frontend)

@@ -409,7 +459,7 @@ def build(options: Options, tmp_path: Path) -> None:
        for config in python_configurations:
            build_options = options.build_options(config.identifier)
            build_frontend = build_options.build_frontend
-            use_uv = build_frontend.name == "build[uv]"
+            use_uv = build_frontend.name in {"build[uv]", "uv"}
            uv_path = find_uv()
            if use_uv and uv_path is None:
                msg = "uv not found"
@@ -436,6 +486,7 @@ def build(options: Options, tmp_path: Path) -> None:
                build_options.environment,
                build_frontend.name,
            )
+            env["CIBUILDWHEEL_BUILD_IDENTIFIER"] = config.identifier
            pip_version = None if use_uv else get_pip_version(env)

            compatible_wheel = find_compatible_wheel(built_wheels, config.identifier)
@@ -457,16 +508,16 @@ def build(options: Options, tmp_path: Path) -> None:
                built_wheel_dir.mkdir()

                extra_flags = get_build_frontend_extra_flags(
-                    build_frontend, build_options.build_verbosity, build_options.config_settings
+                    build_frontend,
+                    build_options.build_verbosity,
+                    prepare_config_settings(
+                        build_options.config_settings,
+                        project=".",
+                        package=build_options.package_dir,
+                    ),
                )

                build_env = env.copy()
-                if pip_version is not None:
-                    build_env["VIRTUALENV_PIP"] = pip_version
-                if constraints_path:
-                    combine_constraints(
-                        build_env, constraints_path, identifier_tmp_dir if use_uv else None
-                    )

                match build_frontend.name:
                    case "pip":
@@ -500,6 +551,18 @@ def build(options: Options, tmp_path: Path) -> None:
                            *extra_flags,
                            env=build_env,
                        )
+                    case "uv":
+                        assert uv_path is not None
+                        call(
+                            uv_path,
+                            "build",
+                            f"--python={base_python}",
+                            build_options.package_dir,
+                            "--wheel",
+                            f"--out-dir={built_wheel_dir}",
+                            *extra_flags,
+                            env=build_env,
+                        )
                    case _:
                        assert_never(build_frontend)

@@ -525,6 +588,8 @@ def build(options: Options, tmp_path: Path) -> None:
                        wheel=built_wheel,
                        dest_dir=repaired_wheel_dir,
                        delocate_archs=delocate_archs,
+                        package=build_options.package_dir,
+                        project=".",
                    )
                    shell(repair_command_prepared, env=env)
                else:
@@ -540,15 +605,10 @@ def build(options: Options, tmp_path: Path) -> None:

                log.step_end()

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

                if config_is_arm64:
@@ -596,24 +656,6 @@ def build(options: Options, tmp_path: Path) -> None:
                        # skip this test
                        continue

-                    is_cp38 = config.identifier.startswith("cp38-")
-                    if testing_arch == "arm64" and is_cp38 and python_arch != "arm64":
-                        log.warning(
-                            unwrap(
-                                """
-                                While cibuildwheel can build CPython 3.8 universal2/arm64 wheels, we
-                                cannot test the arm64 part of them, even when running on an Apple
-                                Silicon machine. This is because we use the x86_64 installer of
-                                CPython 3.8. See the discussion in
-                                https://github.com/pypa/cibuildwheel/pull/1169 for the details. To
-                                silence this warning, set `CIBW_TEST_SKIP: "cp38-macosx_*:arm64"`.
-                                """
-                            )
-                        )
-
-                        # skip this test
-                        continue
-
                    log.step(
                        "Testing wheel..."
                        if testing_arch == machine_arch
@@ -670,33 +712,16 @@ def build(options: Options, tmp_path: Path) -> None:
                        shell_with_arch(before_test_prepared, env=virtualenv_env)

                    # install the wheel
-                    if is_cp38 and python_arch == "x86_64":
-                        virtualenv_env_install_wheel = virtualenv_env.copy()
-                        virtualenv_env_install_wheel["SYSTEM_VERSION_COMPAT"] = "0"
-                        log.notice(
-                            unwrap(
-                                """
-                                Setting SYSTEM_VERSION_COMPAT=0 to ensure CPython 3.8 can get
-                                correct macOS version and allow installation of wheels with
-                                MACOSX_DEPLOYMENT_TARGET >= 11.0.
-                                See https://github.com/pypa/cibuildwheel/issues/1767 for the
-                                details.
-                                """
-                            )
-                        )
-                    else:
-                        virtualenv_env_install_wheel = virtualenv_env
-
                    pip_install(
                        f"{repaired_wheel}{build_options.test_extras}",
-                        env=virtualenv_env_install_wheel,
+                        env=virtualenv_env,
                    )

                    # test the wheel
                    if build_options.test_requires:
                        pip_install(
                            *build_options.test_requires,
-                            env=virtualenv_env_install_wheel,
+                            env=virtualenv_env,
                        )

                    # run the tests from a temp dir, with an absolute path in the command
@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import dataclasses
 import functools
 import json
@@ -7,37 +9,43 @@ import subprocess
 import sys
 import tomllib
 import typing
-from collections.abc import Set
 from pathlib import Path
 from tempfile import TemporaryDirectory
 from typing import Final, TypedDict

 from filelock import FileLock

-from .. import errors
-from ..architecture import Architecture
-from ..environment import ParsedEnvironment
-from ..frontend import get_build_frontend_extra_flags
-from ..logger import log
-from ..options import Options
-from ..selector import BuildSelector
-from ..util import resources
-from ..util.cmd import call, shell
-from ..util.file import (
+from cibuildwheel import errors
+from cibuildwheel.architecture import Architecture
+from cibuildwheel.audit import run_audit
+from cibuildwheel.frontend import get_build_frontend_extra_flags, prepare_config_settings
+from cibuildwheel.logger import log
+from cibuildwheel.util import resources
+from cibuildwheel.util.cmd import call, shell
+from cibuildwheel.util.file import (
    CIBW_CACHE_PATH,
    copy_test_sources,
    download,
    extract_tar,
    extract_zip,
    move_file,
+    remove_on_error,
 )
-from ..util.helpers import prepare_command, unwrap, unwrap_preserving_paragraphs
-from ..util.packaging import combine_constraints, find_compatible_wheel, get_pip_version
-from ..util.python_build_standalone import (
+from cibuildwheel.util.helpers import prepare_command, unwrap, unwrap_preserving_paragraphs
+from cibuildwheel.util.packaging import find_compatible_wheel, get_pip_version
+from cibuildwheel.util.python_build_standalone import (
    PythonBuildStandaloneError,
    create_python_build_standalone_environment,
 )
-from ..venv import constraint_flags, virtualenv
+from cibuildwheel.venv import constraint_flags, virtualenv
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Set
+
+    from cibuildwheel.environment import ParsedEnvironment
+    from cibuildwheel.options import Options
+    from cibuildwheel.selector import BuildSelector

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

@@ -48,6 +56,7 @@ class PythonConfiguration:
    identifier: str
    default_pyodide_version: str
    node_version: str
+    sha256: str = ""


 class PyodideXBuildEnvInfoVersionRange(TypedDict):
@@ -84,32 +93,40 @@ def ensure_node(major_version: str) -> Path:
            with TemporaryDirectory() as tmp_path:
                archive = Path(tmp_path) / f"{name}.{ext}"
                download(url, archive)
-                if ext == "zip":
-                    extract_zip(archive, path.parent)
-                else:
-                    extract_tar(archive, path.parent)
+                with remove_on_error(path):
+                    if ext == "zip":
+                        extract_zip(archive, path.parent)
+                    else:
+                        extract_tar(archive, path.parent)
    assert path.exists()
    if not IS_WIN:
        return path / "bin"
    return path


-def install_emscripten(tmp: Path, version: str) -> Path:
-    url = f"https://github.com/emscripten-core/emsdk/archive/refs/tags/{version}.zip"
-    installation_path = CIBW_CACHE_PATH / f"emsdk-{version}"
-    emsdk_path = installation_path / f"emsdk-{version}/emsdk"
-    emcc_path = installation_path / f"emsdk-{version}/upstream/emscripten/emcc"
-    with FileLock(f"{installation_path}.lock"):
-        if installation_path.exists():
-            return emcc_path
-        emsdk_zip = tmp / "emsdk.zip"
-        download(url, emsdk_zip)
-        installation_path.mkdir()
-        extract_zip(emsdk_zip, installation_path)
-        call(emsdk_path, "install", version)
-        call(emsdk_path, "activate", version)
-
-    return emcc_path
+def install_emscripten(env: dict[str, str], version: str, xbuildenv_cache_path: Path) -> Path:
+    """Install Emscripten via pyodide-build, which also applies Pyodide-specific patches."""
+    emscripten_dir = Path(
+        call("pyodide", "config", "get", "emscripten_dir", env=env, capture_stdout=True).strip()
+    )
+    with FileLock(CIBW_CACHE_PATH / "emscripten.lock"):
+        if emscripten_dir.exists():
+            return emscripten_dir
+        with remove_on_error(emscripten_dir):
+            call(
+                "pyodide",
+                "xbuildenv",
+                "install-emscripten",
+                "--force",
+                "--version",
+                version,
+                "--path",
+                str(xbuildenv_cache_path),
+                env=env,
+                cwd=CIBW_CACHE_PATH,
+            )
+    assert emscripten_dir.exists()
+    return emscripten_dir


 def get_all_xbuildenv_version_info(env: dict[str, str]) -> list[PyodideXBuildEnvInfo]:
@@ -130,7 +147,7 @@ def get_all_xbuildenv_version_info(env: dict[str, str]) -> list[PyodideXBuildEnv
        msg = f"Invalid xbuildenvs info, got {xbuildenvs_info}"
        raise ValueError(msg)

-    return typing.cast(list[PyodideXBuildEnvInfo], xbuildenvs_info["environments"])
+    return typing.cast("list[PyodideXBuildEnvInfo]", xbuildenvs_info["environments"])


 def get_xbuildenv_version_info(
@@ -180,12 +197,8 @@ def validate_pyodide_build_version(
        raise errors.FatalError(msg)


-def install_xbuildenv(env: dict[str, str], pyodide_build_version: str, pyodide_version: str) -> str:
+def install_xbuildenv(env: dict[str, str], xbuildenv_cache_path: Path, pyodide_version: str) -> str:
    """Install a particular Pyodide xbuildenv version and set a path to the Pyodide root."""
-    # Since pyodide-build was unvendored from Pyodide v0.27.0, the versions of
-    # pyodide-build are uncoupled from the versions of Pyodide. So, we specify
-    # both the pyodide-build version and the Pyodide version in the temp path.
-    xbuildenv_cache_path = CIBW_CACHE_PATH / f"pyodide-build-{pyodide_build_version}"
    pyodide_root = xbuildenv_cache_path / pyodide_version / "xbuildenv" / "pyodide-root"

    with FileLock(CIBW_CACHE_PATH / "xbuildenv.lock"):
@@ -198,17 +211,18 @@ def install_xbuildenv(env: dict[str, str], pyodide_build_version: str, pyodide_v
        env.pop("PYODIDE_ROOT", None)

        # Install the xbuildenv
-        call(
-            "pyodide",
-            "xbuildenv",
-            "install",
-            "--path",
-            str(xbuildenv_cache_path),
-            pyodide_version,
-            env=env,
-            cwd=CIBW_CACHE_PATH,
-        )
-        assert pyodide_root.exists()
+        with remove_on_error(xbuildenv_cache_path / pyodide_version):
+            call(
+                "pyodide",
+                "xbuildenv",
+                "install",
+                "--path",
+                str(xbuildenv_cache_path),
+                pyodide_version,
+                env=env,
+                cwd=CIBW_CACHE_PATH,
+            )
+            assert pyodide_root.exists()

    return str(pyodide_root)

@@ -268,7 +282,7 @@ def setup_python(
    if which_python != str(venv_bin_path / "python"):
        msg = "python available on PATH doesn't match our venv instance. If you have modified PATH, ensure that you don't overwrite cibuildwheel's entry or insert python above it."
        raise errors.FatalError(msg)
-    call("python", "--version", env=env)
+    call("python", "-V", "-V", env=env)

    # check what pip version we're on
    assert (venv_bin_path / "pip").exists()
@@ -285,7 +299,6 @@ def setup_python(
        "install",
        "--upgrade",
        "pyodide-build",
-        "build[virtualenv]",
        *constraint_flags(constraints_path),
        env=env,
    )
@@ -304,14 +317,18 @@ def setup_python(
        pyodide_build_version=pyodide_build_version,
    )

-    emscripten_version = xbuildenv_info["emscripten"]
-    log.step(f"Installing Emscripten version: {emscripten_version} ...")
-    emcc_path = install_emscripten(tmp, emscripten_version)
-
-    env["PATH"] = os.pathsep.join([str(emcc_path.parent), env["PATH"]])
+    xbuildenv_cache_path = CIBW_CACHE_PATH / f"pyodide-build-{pyodide_build_version}"

    log.step(f"Installing Pyodide xbuildenv version: {pyodide_version} ...")
-    env["PYODIDE_ROOT"] = install_xbuildenv(env, pyodide_build_version, pyodide_version)
+    env["PYODIDE_ROOT"] = install_xbuildenv(env, xbuildenv_cache_path, pyodide_version)
+
+    emscripten_version = xbuildenv_info["emscripten"]
+    log.step(
+        f"Installing Emscripten {emscripten_version} and applying Pyodide-specific patches ..."
+    )
+    emscripten_dir = install_emscripten(env, emscripten_version, xbuildenv_cache_path)
+
+    env["PATH"] = os.pathsep.join([str(emscripten_dir), env["PATH"]])

    return env

@@ -379,6 +396,7 @@ def build(options: Options, tmp_path: Path) -> None:
                environment=build_options.environment,
                user_pyodide_version=build_options.pyodide_version,
            )
+            env["CIBUILDWHEEL_BUILD_IDENTIFIER"] = config.identifier
            pip_version = get_pip_version(env)
            # The Pyodide command line runner mounts all directories in the host
            # filesystem into the Pyodide file system, except for the custom
@@ -416,20 +434,22 @@ def build(options: Options, tmp_path: Path) -> None:
                log.step("Building wheel...")

                extra_flags = get_build_frontend_extra_flags(
-                    build_frontend, build_options.build_verbosity, build_options.config_settings
+                    build_frontend,
+                    build_options.build_verbosity,
+                    prepare_config_settings(
+                        build_options.config_settings,
+                        project=".",
+                        package=build_options.package_dir,
+                    ),
                )

-                build_env = env.copy()
-                if constraints_path:
-                    combine_constraints(build_env, constraints_path, identifier_tmp_dir)
-                build_env["VIRTUALENV_PIP"] = pip_version
                call(
                    "pyodide",
                    "build",
                    build_options.package_dir,
                    f"--outdir={built_wheel_dir}",
                    *extra_flags,
-                    env=build_env,
+                    env=env,
                )
                built_wheel = next(built_wheel_dir.glob("*.whl"))

@@ -443,6 +463,8 @@ def build(options: Options, tmp_path: Path) -> None:
                        build_options.repair_command,
                        wheel=built_wheel,
                        dest_dir=repaired_wheel_dir,
+                        package=build_options.package_dir,
+                        project=".",
                    )
                    shell(repair_command_prepared, env=env)
                    log.step_end()
@@ -454,6 +476,8 @@ def build(options: Options, tmp_path: Path) -> None:
                if repaired_wheel.name in {wheel.name for wheel in built_wheels}:
                    raise errors.AlreadyBuiltWheelError(repaired_wheel.name)

+                run_audit(tmp_dir=tmp_path, build_options=build_options, wheel=repaired_wheel)
+
            if build_options.test_command and build_options.test_selector(config.identifier):
                log.step("Testing wheel...")

@@ -1,30 +1,47 @@
+from __future__ import annotations
+
 import dataclasses
-import json
 import os
 import platform as platform_module
 import shutil
 import subprocess
 import textwrap
-from collections.abc import MutableMapping, Set
 from functools import cache
 from pathlib import Path
 from typing import assert_never

 from filelock import FileLock

-from .. import errors
-from ..architecture import Architecture
-from ..environment import ParsedEnvironment
-from ..frontend import BuildFrontendName, get_build_frontend_extra_flags
-from ..logger import log
-from ..options import Options
-from ..selector import BuildSelector
-from ..util import resources
-from ..util.cmd import call, shell
-from ..util.file import CIBW_CACHE_PATH, copy_test_sources, download, extract_zip, move_file
-from ..util.helpers import prepare_command, unwrap
-from ..util.packaging import combine_constraints, find_compatible_wheel, get_pip_version
-from ..venv import constraint_flags, find_uv, virtualenv
+from cibuildwheel import errors
+from cibuildwheel.architecture import Architecture
+from cibuildwheel.audit import run_audit
+from cibuildwheel.frontend import (
+    BuildFrontendName,
+    get_build_frontend_extra_flags,
+    prepare_config_settings,
+)
+from cibuildwheel.logger import log
+from cibuildwheel.util import resources
+from cibuildwheel.util.cmd import call, shell
+from cibuildwheel.util.file import (
+    CIBW_CACHE_PATH,
+    copy_test_sources,
+    download,
+    extract_zip,
+    move_file,
+    remove_on_error,
+)
+from cibuildwheel.util.helpers import prepare_command, unwrap
+from cibuildwheel.util.packaging import find_compatible_wheel, get_pip_version
+from cibuildwheel.venv import constraint_flags, find_uv, target_marker_env, virtualenv
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import MutableMapping, Sequence, Set
+
+    from cibuildwheel.environment import ParsedEnvironment
+    from cibuildwheel.options import Options
+    from cibuildwheel.selector import BuildSelector


 def get_nuget_args(
@@ -54,9 +71,17 @@ def get_nuget_args(
@dataclasses.dataclass(frozen=True, kw_only=True)
 class PythonConfiguration:
    version: str
-    arch: str
    identifier: str
    url: str | None = None
+    sha256: str = ""
+
+    @property
+    def arch(self) -> str:
+        return {
+            "win32": "32",
+            "win_amd64": "64",
+            "win_arm64": "ARM64",
+        }[self.identifier.split("-")[-1]]


 def all_python_configurations() -> list[PythonConfiguration]:
@@ -87,7 +112,8 @@ def _ensure_nuget() -> Path:
    nuget = CIBW_CACHE_PATH / "nuget.exe"
    with FileLock(str(nuget) + ".lock"):
        if not nuget.exists():
-            download("https://dist.nuget.org/win-x86-commandline/latest/nuget.exe", nuget)
+            with remove_on_error(nuget):
+                download("https://dist.nuget.org/win-x86-commandline/latest/nuget.exe", nuget)
    return nuget


@@ -103,11 +129,12 @@ def install_cpython(configuration: PythonConfiguration, arch: str | None = None)
    with FileLock(str(base_output_dir) + f"-{version}{free_threaded_str}-{arch}.lock"):
        if not installation_path.exists():
            nuget = _ensure_nuget()
-            call(nuget, "install", *nuget_args)
+            with remove_on_error(installation_path.parent):
+                call(nuget, "install", *nuget_args)
    return installation_path / "python.exe"


-def install_pypy(tmp: Path, arch: str, url: str) -> Path:
+def install_pypy(tmp: Path, arch: str, url: str, sha256: str) -> Path:
    assert arch == "64"
    assert "win64" in url
    # Inside the PyPy zip file is a directory with the same name
@@ -118,13 +145,14 @@ def install_pypy(tmp: Path, arch: str, url: str) -> Path:
    with FileLock(str(installation_path) + ".lock"):
        if not installation_path.exists():
            pypy_zip = tmp / zip_filename
-            download(url, pypy_zip)
-            # Extract to the parent directory because the zip file still contains a directory
-            extract_zip(pypy_zip, installation_path.parent)
+            download(url, pypy_zip, sha256=sha256)
+            with remove_on_error(installation_path):
+                # Extract to the parent directory because the zip file still contains a directory
+                extract_zip(pypy_zip, installation_path.parent)
    return installation_path / "python.exe"


-def install_graalpy(tmp: Path, url: str) -> Path:
+def install_graalpy(tmp: Path, url: str, sha256: str) -> Path:
    zip_filename = url.rsplit("/", 1)[-1]
    extension = ".zip"
    assert zip_filename.endswith(extension)
@@ -132,9 +160,10 @@ def install_graalpy(tmp: Path, url: str) -> Path:
    with FileLock(str(installation_path) + ".lock"):
        if not installation_path.exists():
            graalpy_zip = tmp / zip_filename
-            download(url, graalpy_zip)
-            # Extract to the parent directory because the zip file still contains a directory
-            extract_zip(graalpy_zip, installation_path.parent)
+            download(url, graalpy_zip, sha256=sha256)
+            with remove_on_error(installation_path):
+                # Extract to the parent directory because the zip file still contains a directory
+                extract_zip(graalpy_zip, installation_path.parent)
    return installation_path / "bin" / "graalpy.exe"


@@ -225,11 +254,6 @@ def setup_rust_cross_compile(
        )


-def can_use_uv(python_configuration: PythonConfiguration) -> bool:
-    conditions = (not python_configuration.identifier.startswith("pp38-"),)
-    return all(conditions)
-
-
 def setup_python(
    tmp: Path,
    python_configuration: PythonConfiguration,
@@ -253,18 +277,20 @@ def setup_python(
            base_python = install_cpython(python_configuration, arch=native_arch)
    elif implementation_id.startswith("pp"):
        assert python_configuration.url is not None
-        base_python = install_pypy(tmp, python_configuration.arch, python_configuration.url)
+        assert python_configuration.sha256
+        base_python = install_pypy(
+            tmp, python_configuration.arch, python_configuration.url, python_configuration.sha256
+        )
    elif implementation_id.startswith("gp"):
-        base_python = install_graalpy(tmp, python_configuration.url or "")
+        assert python_configuration.url is not None
+        assert python_configuration.sha256
+        base_python = install_graalpy(tmp, python_configuration.url, python_configuration.sha256)
    else:
        msg = "Unknown Python implementation"
        raise ValueError(msg)
    assert base_python.exists()

-    if build_frontend == "build[uv]" and not can_use_uv(python_configuration):
-        build_frontend = "build"
-
-    use_uv = build_frontend == "build[uv]"
+    use_uv = build_frontend in {"build[uv]", "uv"}
    uv_path = find_uv()

    log.step("Setting up build environment...")
@@ -275,12 +301,15 @@ def setup_python(
        venv_path,
        dependency_constraint,
        use_uv=use_uv,
+        marker_env=target_marker_env(implementation_id=implementation_id),
    )

    # set up environment variables for run_with_env
    env["PYTHON_VERSION"] = python_configuration.version
    env["PYTHON_ARCH"] = python_configuration.arch
-    env["PIP_DISABLE_PIP_VERSION_CHECK"] = "1"
+    env.pop("UV_PYTHON", None)
+    if not use_uv:
+        env["PIP_DISABLE_PIP_VERSION_CHECK"] = "1"

    # update env with results from CIBW_ENVIRONMENT
    env = environment.as_dictionary(prev_environment=env)
@@ -291,7 +320,7 @@ def setup_python(
    if where_python != str(venv_path / "Scripts" / "python.exe"):
        msg = "python available on PATH doesn't match our installed instance. If you have modified PATH, ensure that you don't overwrite cibuildwheel's entry or insert python above it."
        raise errors.FatalError(msg)
-    call("python", "--version", env=env)
+    call("python", "-V", "-V", env=env)
    call("python", "-c", "\"import struct; print(struct.calcsize('P') * 8)\"", env=env)

    # check what pip version we're on
@@ -306,12 +335,22 @@ def setup_python(

    log.step("Installing build tools...")
    match build_frontend:
+        case "pip":
+            call(
+                "pip",
+                "install",
+                "--upgrade",
+                "delvewheel",
+                *constraint_flags(dependency_constraint),
+                env=env,
+            )
        case "build":
            call(
                "pip",
                "install",
                "--upgrade",
                "build[virtualenv]",
+                "delvewheel",
                *constraint_flags(dependency_constraint),
                env=env,
            )
@@ -321,53 +360,35 @@ def setup_python(
                uv_path,
                "pip",
                "install",
+                "--python",
+                where_python,
                "--upgrade",
                "build[virtualenv]",
+                "delvewheel",
                *constraint_flags(dependency_constraint),
                env=env,
            )
+        case "uv":
+            assert uv_path is not None
+            call(
+                uv_path,
+                "pip",
+                "install",
+                "--python",
+                where_python,
+                "--upgrade",
+                "delvewheel",
+                *constraint_flags(dependency_constraint),
+                env=env,
+            )
+        case _:
+            assert_never(build_frontend)

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

-    if implementation_id.startswith("gp"):
-        # GraalPy fails to discover compilers, setup the relevant environment
-        # variables. Adapted from
-        # https://github.com/microsoft/vswhere/wiki/Start-Developer-Command-Prompt
-        # Remove when https://github.com/oracle/graalpython/issues/492 is fixed.
-        vcpath = call(
-            Path(os.environ["PROGRAMFILES(X86)"])
-            / "Microsoft Visual Studio"
-            / "Installer"
-            / "vswhere.exe",
-            "-products",
-            "*",
-            "-latest",
-            "-property",
-            "installationPath",
-            capture_stdout=True,
-        ).strip()
-        log.notice(f"Discovering Visual Studio for GraalPy at {vcpath}")
-        vcvars_file = tmp / "vcvars.json"
-        call(
-            f"{vcpath}\\Common7\\Tools\\vsdevcmd.bat",
-            "-no_logo",
-            "-arch=amd64",
-            "-host_arch=amd64",
-            "&&",
-            "python",
-            "-c",
-            # this command needs to be one line for Windows reasons
-            "import sys, json, pathlib, os; pathlib.Path(sys.argv[1]).write_text(json.dumps(dict(os.environ)))",
-            vcvars_file,
-            env=env,
-        )
-        with open(vcvars_file, encoding="utf-8") as f:
-            vcvars = json.load(f)
-        env.update(vcvars)
-
    return base_python, env


@@ -379,6 +400,8 @@ def build(options: Options, tmp_path: Path) -> None:
    if not python_configurations:
        return

+    uv_path = find_uv()
+
    try:
        before_all_options_identifier = python_configurations[0].identifier
        before_all_options = options.build_options(before_all_options_identifier)
@@ -396,8 +419,7 @@ def build(options: Options, tmp_path: Path) -> None:
        for config in python_configurations:
            build_options = options.build_options(config.identifier)
            build_frontend = build_options.build_frontend
-
-            use_uv = build_frontend.name == "build[uv]" and can_use_uv(config)
+            use_uv = build_frontend.name in {"build[uv]", "uv"}
            log.build_start(config.identifier)

            identifier_tmp_dir = tmp_path / config.identifier
@@ -418,6 +440,7 @@ def build(options: Options, tmp_path: Path) -> None:
                build_options.environment,
                build_frontend.name,
            )
+            env["CIBUILDWHEEL_BUILD_IDENTIFIER"] = config.identifier
            pip_version = None if use_uv else get_pip_version(env)

            compatible_wheel = find_compatible_wheel(built_wheels, config.identifier)
@@ -442,32 +465,15 @@ def build(options: Options, tmp_path: Path) -> None:
                built_wheel_dir.mkdir()

                extra_flags = get_build_frontend_extra_flags(
-                    build_frontend, build_options.build_verbosity, build_options.config_settings
+                    build_frontend,
+                    build_options.build_verbosity,
+                    prepare_config_settings(
+                        build_options.config_settings,
+                        project=".",
+                        package=options.globals.package_dir,
+                    ),
                )

-                if (
-                    config.identifier.startswith("gp")
-                    and build_frontend.name == "build"
-                    and "--no-isolation" not in extra_flags
-                    and "-n" not in extra_flags
-                ):
-                    # GraalPy fails to discover its standard library when a venv is created
-                    # from a virtualenv seeded executable. See
-                    # https://github.com/oracle/graalpython/issues/491 and remove this once
-                    # fixed upstream.
-                    log.notice(
-                        "Disabling build isolation to workaround GraalPy bug. If the build fails, consider using pip or build[uv] as build frontend."
-                    )
-                    shell("graalpy -m pip install setuptools wheel", env=env)
-                    extra_flags = [*extra_flags, "-n"]
-
-                build_env = env.copy()
-                if pip_version is not None:
-                    build_env["VIRTUALENV_PIP"] = pip_version
-
-                if constraints_path:
-                    combine_constraints(build_env, constraints_path, identifier_tmp_dir)
-
                match build_frontend.name:
                    case "pip":
                        # Path.resolve() is needed. Without it pip wheel may try to fetch package from pypi.org
@@ -481,7 +487,7 @@ def build(options: Options, tmp_path: Path) -> None:
                            f"--wheel-dir={built_wheel_dir}",
                            "--no-deps",
                            *extra_flags,
-                            env=build_env,
+                            env=env,
                        )
                    case "build" | "build[uv]":
                        if (
@@ -499,7 +505,19 @@ def build(options: Options, tmp_path: Path) -> None:
                            "--wheel",
                            f"--outdir={built_wheel_dir}",
                            *extra_flags,
-                            env=build_env,
+                            env=env,
+                        )
+                    case "uv":
+                        assert uv_path is not None
+                        call(
+                            uv_path,
+                            "build",
+                            f"--python={base_python}",
+                            build_options.package_dir,
+                            "--wheel",
+                            f"--out-dir={built_wheel_dir}",
+                            *extra_flags,
+                            env=env,
                        )
                    case _:
                        assert_never(build_frontend)
@@ -518,6 +536,8 @@ def build(options: Options, tmp_path: Path) -> None:
                        build_options.repair_command,
                        wheel=built_wheel,
                        dest_dir=repaired_wheel_dir,
+                        package=build_options.package_dir,
+                        project=".",
                    )
                    shell(repair_command_prepared, env=env)
                else:
@@ -531,6 +551,8 @@ def build(options: Options, tmp_path: Path) -> None:
                if repaired_wheel.name in {wheel.name for wheel in built_wheels}:
                    raise errors.AlreadyBuiltWheelError(repaired_wheel.name)

+                run_audit(tmp_dir=tmp_path, build_options=build_options, wheel=repaired_wheel)
+
            test_selected = options.globals.test_selector(config.identifier)
            if test_selected and config.arch == "ARM64" != platform_module.machine():
                log.warning(
@@ -573,7 +595,12 @@ def build(options: Options, tmp_path: Path) -> None:
                    )
                    shell(before_test_prepared, env=virtualenv_env)

-                pip = ["uv", "pip"] if use_uv else ["pip"]
+                pip: Sequence[Path | str]
+                if use_uv:
+                    assert uv_path is not None
+                    pip = [uv_path, "pip"]
+                else:
+                    pip = ["pip"]

                # install the wheel
                call(
@@ -1,11 +1,16 @@
+from __future__ import annotations
+
 import ast
 import configparser
 import contextlib
-from pathlib import Path
-from typing import Any

 import dependency_groups

+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+    from typing import Any
+

 def get_parent(node: ast.AST | None, depth: int = 1) -> ast.AST | None:
    for _ in range(depth):
@@ -50,7 +55,7 @@ class Analyzer(ast.NodeVisitor):
        )

        match node:
-            case ast.keyword(arg="python_requires", value=ast.Constant(value=str(version))):
+            case ast.keyword(arg="python_requires", value=ast.Constant(value=str() as version)):
                if unnested or name_main_unnested:
                    self.requires_python = version

@@ -14,6 +14,9 @@ def initialize() -> None:
    if not (host_triplet := os.environ.get("CIBW_HOST_TRIPLET")):
        return

+    # Pre-import any modules which would fail to import after the monkey-patching.
+    import ctypes  # noqa: F401, PLC0415 - uses get_config_var("LDLIBRARY")
+
    # os ######################################################################
    def cross_os_uname() -> os.uname_result:
        return os.uname_result(
@@ -68,16 +71,20 @@ def initialize() -> None:

    # sysconfig ###############################################################
    #
-    # We don't change the actual sys.base_prefix and base_exec_prefix, because that
-    # could have unpredictable effects. Instead, we change the internal variables
-    # used to generate sysconfig.get_path("include").
-    exec_prefix = sysconfig.get_config_var("exec_prefix")
-    sysconfig._BASE_PREFIX = sysconfig._BASE_EXEC_PREFIX = exec_prefix  # type: ignore[attr-defined]
-
-    # Reload the sysconfigdata file, generating its name from sys.abiflags,
+    # Load the sysconfigdata file, generating its name from sys.abiflags,
    # sys.platform, and sys.implementation._multiarch.
    sysconfig._init_config_vars()  # type: ignore[attr-defined]

+    # We don't change the actual sys.base_prefix and base_exec_prefix, because that
+    # could have unpredictable effects. Instead, we change the sysconfig variables
+    # used by sysconfig.get_paths().
+    vars = sysconfig.get_config_vars()
+    try:
+        host_prefix = vars["host_prefix"]  # This variable was added in Python 3.14.
+    except KeyError:
+        host_prefix = vars["exec_prefix"]
+    vars["installed_base"] = vars["installed_platbase"] = host_prefix
+
    # sysconfig.get_platform, which determines the wheel tag, is implemented in terms of
    # sys.platform, sysconfig.get_config_var("ANDROID_API_LEVEL") (see localized_vars in
    # android.py), and os.uname.
@@ -0,0 +1,11 @@
+--- a/android.py
+++ b/android.py
+@@ -1021,7 +1021,7 @@ def main():
+     context = parse_args()
+ 
+     # Set the CROSS_BUILD_DIR if an argument was provided
+-    if context.cross_build_dir:
+    if getattr(context, "cross_build_dir", None):
+         global CROSS_BUILD_DIR
+         CROSS_BUILD_DIR = context.cross_build_dir.resolve()
+ 
@@ -0,0 +1,121 @@
+# This file intentionally has no hashbang line in the source: cibuildwheel will add it
+# above this comment when the file is deployed.
+
+import os
+import re
+import shutil
+import sys
+from pathlib import Path
+from tempfile import gettempdir
+
+from filelock import FileLock
+
+from cibuildwheel.util.file import CIBW_CACHE_PATH, download
+
+# In the future we might pick a different Flang release depending on the NDK version,
+# but so far all Python versions use the same NDK version, so there's no need.
+RELEASE_URL = "https://github.com/termux/ndk-toolchain-clang-with-flang/releases/download"
+RELEASE_VERSION = "r27c"
+ARCHS = ["aarch64", "x86_64"]
+
+# The compiler is built for Linux x86_64, so we use Docker on macOS.
+DOCKER_IMAGE = "debian:trixie-slim"
+
+
+def main() -> None:
+    cache_dir = CIBW_CACHE_PATH / f"flang-android-{RELEASE_VERSION}"
+    with FileLock(f"{cache_dir}.lock"):
+        if not cache_dir.exists():
+            download_flang(cache_dir)
+
+    run_flang(cache_dir)
+
+
+def download_flang(cache_dir: Path) -> None:
+    tmp_dir = Path(f"{cache_dir}.tmp")
+    if tmp_dir.exists():
+        shutil.rmtree(tmp_dir)
+    tmp_dir.mkdir(parents=True)
+
+    for archive_name in [f"package-flang-{arch}.tar.bz2" for arch in ARCHS] + [
+        "package-flang-host.tar.bz2",
+        "package-install.tar.bz2",
+    ]:
+        archive_path = tmp_dir / archive_name
+        download(f"{RELEASE_URL}/{RELEASE_VERSION}/{archive_name}", archive_path)
+        shutil.unpack_archive(archive_path, tmp_dir)
+        archive_path.unlink()
+
+    # Merge the extracted trees together, along with the necessary parts of the NDK. Based on
+    # https://github.com/kivy/python-for-android/blob/develop/pythonforandroid/recipes/fortran/__init__.py.
+    flang_toolchain = tmp_dir / "toolchain"
+    (tmp_dir / "out/install/linux-x86/clang-dev").rename(flang_toolchain)
+
+    ndk_toolchain = Path(os.environ["CC"]).parents[1]
+    if (clang_ver_flang := clang_ver(flang_toolchain)) != (
+        clang_ver_ndk := clang_ver(ndk_toolchain)
+    ):
+        msg = f"Flang uses Clang {clang_ver_flang}, but NDK uses Clang {clang_ver_ndk}"
+        raise ValueError(msg)
+
+    clang_lib_path = f"lib/clang/{clang_ver_ndk}/lib"
+    shutil.rmtree(flang_toolchain / clang_lib_path)
+
+    for src, dst in [
+        (f"{tmp_dir}/build-{arch}-install", f"sysroot/usr/lib/{arch}-linux-android")
+        for arch in ARCHS
+    ] + [
+        (f"{tmp_dir}/build-host-install", ""),
+        (f"{ndk_toolchain}/{clang_lib_path}", clang_lib_path),
+        (f"{ndk_toolchain}/sysroot", "sysroot"),
+    ]:
+        shutil.copytree(src, flang_toolchain / dst, symlinks=True, dirs_exist_ok=True)
+
+    flang_toolchain.rename(cache_dir)
+    shutil.rmtree(tmp_dir)
+
+
+def clang_ver(toolchain: Path) -> str:
+    versions = [p.name for p in (toolchain / "lib/clang").iterdir()]
+    assert len(versions) == 1
+    return versions[0]
+
+
+def run_flang(cache_dir: Path) -> None:
+    match = re.fullmatch(r".+/(.+)-clang", os.environ["CC"])
+    assert match is not None
+    target = match[1]
+
+    # In a future Flang version the executable name will change to "flang"
+    # (https://blog.llvm.org/posts/2025-03-11-flang-new/).
+    flang_args = [f"{cache_dir}/bin/flang-new", f"--target={target}", *sys.argv[1:]]
+
+    if sys.platform == "linux":
+        args = flang_args
+    elif sys.platform == "darwin":
+        args = ["docker", "run", "--rm", "--platform", "linux/amd64"]
+        # Docker on macOS only allows certain directories to be mounted as volumes
+        # by default, but they include all the locations we're likely to need.
+        for path in [
+            # Location of CIBW_CACHE_PATH (containing the Fortran compiler), and
+            # probably the project directory.
+            Path.home(),
+            # Temporary directories created by build backends and cibuildwheel itself.
+            # This is controlled by the TMPDIR environment variable, which is set to
+            # an unpredictable subdirectory of /var/folders. /var is itself a symlink
+            # to /private/var.
+            Path(gettempdir()),
+            Path(gettempdir()).resolve(),
+        ]:
+            args += ["-v", f"{path}:{path}"]
+        args += ["--workdir", str(Path.cwd())]
+        args += ["--entrypoint", flang_args[0], DOCKER_IMAGE, *flang_args[1:]]
+    else:
+        msg = f"unknown platform: {sys.platform}"
+        raise ValueError(msg)
+
+    os.execvp(args[0], args)
+
+
+if __name__ == "__main__":
+    main()
@@ -0,0 +1,57 @@
+#!/usr/bin/env python3
+
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+
+def main() -> None:
+    # CIBW_HOST_TRIPLET is set in the android_env to the Android target triplet.
+    target = os.environ.get("CIBW_HOST_TRIPLET")
+
+    cmd_name = Path(sys.argv[0]).name
+
+    # Find the real command in PATH, excluding the current script's directory
+    path_env = os.environ.get("PATH", "")
+    script_dir = Path(__file__).resolve().parent
+
+    paths = path_env.split(os.pathsep)
+    # Filter out the script directory to avoid recursion
+    filtered_paths = [p for p in paths if Path(p).resolve() != script_dir]
+    filtered_path_env = os.pathsep.join(filtered_paths)
+
+    real_cmd = shutil.which(cmd_name, path=filtered_path_env)
+
+    if not real_cmd:
+        sys.stderr.write(f"cibuildwheel: Error: Could not find system {cmd_name}\n")
+        sys.exit(1)
+
+    # If we have a target (i.e. we are in the android_env), try to install it.
+    if target:
+        # Check if rustup is available to install the target
+        rustup_path = shutil.which("rustup", path=filtered_path_env)
+
+        if rustup_path:
+            try:
+                # We call rustup to ensure the target is installed.
+                subprocess.run(
+                    [rustup_path, "target", "add", target],
+                    check=True,
+                    stdout=subprocess.DEVNULL,
+                    stderr=subprocess.PIPE,
+                    text=True,
+                )
+            except subprocess.CalledProcessError as e:
+                sys.stderr.write(
+                    f"cibuildwheel: Error: Failed to install Rust target {target}: {e.stderr}\n"
+                )
+                sys.exit(1)
+
+    # Execute the real command
+    os.execv(real_cmd, [real_cmd, *sys.argv[1:]])
+
+
+if __name__ == "__main__":
+    main()
@@ -1,241 +1,244 @@
 [linux]
 python_configurations = [
-  { identifier = "cp38-manylinux_x86_64", version = "3.8", path_str = "/opt/python/cp38-cp38" },
  { identifier = "cp39-manylinux_x86_64", version = "3.9", path_str = "/opt/python/cp39-cp39" },
  { identifier = "cp310-manylinux_x86_64", version = "3.10", path_str = "/opt/python/cp310-cp310" },
  { identifier = "cp311-manylinux_x86_64", version = "3.11", path_str = "/opt/python/cp311-cp311" },
  { identifier = "cp312-manylinux_x86_64", version = "3.12", path_str = "/opt/python/cp312-cp312" },
  { identifier = "cp313-manylinux_x86_64", version = "3.13", path_str = "/opt/python/cp313-cp313" },
-  { identifier = "cp313t-manylinux_x86_64", version = "3.13", path_str = "/opt/python/cp313-cp313t" },
  { identifier = "cp314-manylinux_x86_64", version = "3.14", path_str = "/opt/python/cp314-cp314" },
  { identifier = "cp314t-manylinux_x86_64", version = "3.14", path_str = "/opt/python/cp314-cp314t" },
-  { identifier = "cp38-manylinux_i686", version = "3.8", path_str = "/opt/python/cp38-cp38" },
+  { identifier = "cp315-manylinux_x86_64", version = "3.15", path_str = "/opt/python/cp315-cp315" },
+  { identifier = "cp315t-manylinux_x86_64", version = "3.15", path_str = "/opt/python/cp315-cp315t" },
  { identifier = "cp39-manylinux_i686", version = "3.9", path_str = "/opt/python/cp39-cp39" },
  { identifier = "cp310-manylinux_i686", version = "3.10", path_str = "/opt/python/cp310-cp310" },
  { identifier = "cp311-manylinux_i686", version = "3.11", path_str = "/opt/python/cp311-cp311" },
  { identifier = "cp312-manylinux_i686", version = "3.12", path_str = "/opt/python/cp312-cp312" },
  { identifier = "cp313-manylinux_i686", version = "3.13", path_str = "/opt/python/cp313-cp313" },
-  { identifier = "cp313t-manylinux_i686", version = "3.13", path_str = "/opt/python/cp313-cp313t" },
  { identifier = "cp314-manylinux_i686", version = "3.14", path_str = "/opt/python/cp314-cp314" },
  { identifier = "cp314t-manylinux_i686", version = "3.14", path_str = "/opt/python/cp314-cp314t" },
-  { identifier = "pp38-manylinux_x86_64", version = "3.8", path_str = "/opt/python/pp38-pypy38_pp73" },
+  { identifier = "cp315-manylinux_i686", version = "3.15", path_str = "/opt/python/cp315-cp315" },
+  { identifier = "cp315t-manylinux_i686", version = "3.15", path_str = "/opt/python/cp315-cp315t" },
  { identifier = "pp39-manylinux_x86_64", version = "3.9", path_str = "/opt/python/pp39-pypy39_pp73" },
  { identifier = "pp310-manylinux_x86_64", version = "3.10", path_str = "/opt/python/pp310-pypy310_pp73" },
  { identifier = "pp311-manylinux_x86_64", version = "3.11", path_str = "/opt/python/pp311-pypy311_pp73" },
-  { identifier = "gp311_242-manylinux_x86_64", version = "3.11", path_str = "/opt/python/graalpy311-graalpy242_311_native" },
-  { identifier = "cp38-manylinux_aarch64", version = "3.8", path_str = "/opt/python/cp38-cp38" },
+  { identifier = "gp312_250-manylinux_x86_64", version = "3.12", path_str = "/opt/python/graalpy312-graalpy250_312_native" },
  { identifier = "cp39-manylinux_aarch64", version = "3.9", path_str = "/opt/python/cp39-cp39" },
  { identifier = "cp310-manylinux_aarch64", version = "3.10", path_str = "/opt/python/cp310-cp310" },
  { identifier = "cp311-manylinux_aarch64", version = "3.11", path_str = "/opt/python/cp311-cp311" },
  { identifier = "cp312-manylinux_aarch64", version = "3.12", path_str = "/opt/python/cp312-cp312" },
  { identifier = "cp313-manylinux_aarch64", version = "3.13", path_str = "/opt/python/cp313-cp313" },
-  { identifier = "cp313t-manylinux_aarch64", version = "3.13", path_str = "/opt/python/cp313-cp313t" },
  { identifier = "cp314-manylinux_aarch64", version = "3.14", path_str = "/opt/python/cp314-cp314" },
  { identifier = "cp314t-manylinux_aarch64", version = "3.14", path_str = "/opt/python/cp314-cp314t" },
-  { identifier = "cp38-manylinux_ppc64le", version = "3.8", path_str = "/opt/python/cp38-cp38" },
+  { identifier = "cp315-manylinux_aarch64", version = "3.15", path_str = "/opt/python/cp315-cp315" },
+  { identifier = "cp315t-manylinux_aarch64", version = "3.15", path_str = "/opt/python/cp315-cp315t" },
  { identifier = "cp39-manylinux_ppc64le", version = "3.9", path_str = "/opt/python/cp39-cp39" },
  { identifier = "cp310-manylinux_ppc64le", version = "3.10", path_str = "/opt/python/cp310-cp310" },
  { identifier = "cp311-manylinux_ppc64le", version = "3.11", path_str = "/opt/python/cp311-cp311" },
  { identifier = "cp312-manylinux_ppc64le", version = "3.12", path_str = "/opt/python/cp312-cp312" },
  { identifier = "cp313-manylinux_ppc64le", version = "3.13", path_str = "/opt/python/cp313-cp313" },
-  { identifier = "cp313t-manylinux_ppc64le", version = "3.13", path_str = "/opt/python/cp313-cp313t" },
  { identifier = "cp314-manylinux_ppc64le", version = "3.14", path_str = "/opt/python/cp314-cp314" },
  { identifier = "cp314t-manylinux_ppc64le", version = "3.14", path_str = "/opt/python/cp314-cp314t" },
-  { identifier = "cp38-manylinux_s390x", version = "3.8", path_str = "/opt/python/cp38-cp38" },
+  { identifier = "cp315-manylinux_ppc64le", version = "3.15", path_str = "/opt/python/cp315-cp315" },
+  { identifier = "cp315t-manylinux_ppc64le", version = "3.15", path_str = "/opt/python/cp315-cp315t" },
  { identifier = "cp39-manylinux_s390x", version = "3.9", path_str = "/opt/python/cp39-cp39" },
  { identifier = "cp310-manylinux_s390x", version = "3.10", path_str = "/opt/python/cp310-cp310" },
  { identifier = "cp311-manylinux_s390x", version = "3.11", path_str = "/opt/python/cp311-cp311" },
  { identifier = "cp312-manylinux_s390x", version = "3.12", path_str = "/opt/python/cp312-cp312" },
  { identifier = "cp313-manylinux_s390x", version = "3.13", path_str = "/opt/python/cp313-cp313" },
-  { identifier = "cp313t-manylinux_s390x", version = "3.13", path_str = "/opt/python/cp313-cp313t" },
  { identifier = "cp314-manylinux_s390x", version = "3.14", path_str = "/opt/python/cp314-cp314" },
  { identifier = "cp314t-manylinux_s390x", version = "3.14", path_str = "/opt/python/cp314-cp314t" },
-  { identifier = "cp38-manylinux_armv7l", version = "3.8", path_str = "/opt/python/cp38-cp38" },
+  { identifier = "cp315-manylinux_s390x", version = "3.15", path_str = "/opt/python/cp315-cp315" },
+  { identifier = "cp315t-manylinux_s390x", version = "3.15", path_str = "/opt/python/cp315-cp315t" },
  { identifier = "cp39-manylinux_armv7l", version = "3.9", path_str = "/opt/python/cp39-cp39" },
  { identifier = "cp310-manylinux_armv7l", version = "3.10", path_str = "/opt/python/cp310-cp310" },
  { identifier = "cp311-manylinux_armv7l", version = "3.11", path_str = "/opt/python/cp311-cp311" },
  { identifier = "cp312-manylinux_armv7l", version = "3.12", path_str = "/opt/python/cp312-cp312" },
  { identifier = "cp313-manylinux_armv7l", version = "3.13", path_str = "/opt/python/cp313-cp313" },
-  { identifier = "cp313t-manylinux_armv7l", version = "3.13", path_str = "/opt/python/cp313-cp313t" },
  { identifier = "cp314-manylinux_armv7l", version = "3.14", path_str = "/opt/python/cp314-cp314" },
  { identifier = "cp314t-manylinux_armv7l", version = "3.14", path_str = "/opt/python/cp314-cp314t" },
-  { identifier = "cp38-manylinux_riscv64", version = "3.8", path_str = "/opt/python/cp38-cp38" },
+  { identifier = "cp315-manylinux_armv7l", version = "3.15", path_str = "/opt/python/cp315-cp315" },
+  { identifier = "cp315t-manylinux_armv7l", version = "3.15", path_str = "/opt/python/cp315-cp315t" },
  { identifier = "cp39-manylinux_riscv64", version = "3.9", path_str = "/opt/python/cp39-cp39" },
  { identifier = "cp310-manylinux_riscv64", version = "3.10", path_str = "/opt/python/cp310-cp310" },
  { identifier = "cp311-manylinux_riscv64", version = "3.11", path_str = "/opt/python/cp311-cp311" },
  { identifier = "cp312-manylinux_riscv64", version = "3.12", path_str = "/opt/python/cp312-cp312" },
  { identifier = "cp313-manylinux_riscv64", version = "3.13", path_str = "/opt/python/cp313-cp313" },
-  { identifier = "cp313t-manylinux_riscv64", version = "3.13", path_str = "/opt/python/cp313-cp313t" },
  { identifier = "cp314-manylinux_riscv64", version = "3.14", path_str = "/opt/python/cp314-cp314" },
  { identifier = "cp314t-manylinux_riscv64", version = "3.14", path_str = "/opt/python/cp314-cp314t" },
-  { identifier = "pp38-manylinux_aarch64", version = "3.8", path_str = "/opt/python/pp38-pypy38_pp73" },
+  { identifier = "cp315-manylinux_riscv64", version = "3.15", path_str = "/opt/python/cp315-cp315" },
+  { identifier = "cp315t-manylinux_riscv64", version = "3.15", path_str = "/opt/python/cp315-cp315t" },
  { identifier = "pp39-manylinux_aarch64", version = "3.9", path_str = "/opt/python/pp39-pypy39_pp73" },
  { identifier = "pp310-manylinux_aarch64", version = "3.10", path_str = "/opt/python/pp310-pypy310_pp73" },
  { identifier = "pp311-manylinux_aarch64", version = "3.11", path_str = "/opt/python/pp311-pypy311_pp73" },
-  { identifier = "gp311_242-manylinux_aarch64", version = "3.11", path_str = "/opt/python/graalpy311-graalpy242_311_native" },
-  { identifier = "pp38-manylinux_i686", version = "3.8", path_str = "/opt/python/pp38-pypy38_pp73" },
+  { identifier = "gp312_250-manylinux_aarch64", version = "3.12", path_str = "/opt/python/graalpy312-graalpy250_312_native" },
  { identifier = "pp39-manylinux_i686", version = "3.9", path_str = "/opt/python/pp39-pypy39_pp73" },
  { identifier = "pp310-manylinux_i686", version = "3.10", path_str = "/opt/python/pp310-pypy310_pp73" },
  { identifier = "pp311-manylinux_i686", version = "3.11", path_str = "/opt/python/pp311-pypy311_pp73" },
-  { identifier = "cp38-musllinux_x86_64", version = "3.8", path_str = "/opt/python/cp38-cp38" },
  { identifier = "cp39-musllinux_x86_64", version = "3.9", path_str = "/opt/python/cp39-cp39" },
  { identifier = "cp310-musllinux_x86_64", version = "3.10", path_str = "/opt/python/cp310-cp310" },
  { identifier = "cp311-musllinux_x86_64", version = "3.11", path_str = "/opt/python/cp311-cp311" },
  { identifier = "cp312-musllinux_x86_64", version = "3.12", path_str = "/opt/python/cp312-cp312" },
  { identifier = "cp313-musllinux_x86_64", version = "3.13", path_str = "/opt/python/cp313-cp313" },
-  { identifier = "cp313t-musllinux_x86_64", version = "3.13", path_str = "/opt/python/cp313-cp313t" },
  { identifier = "cp314-musllinux_x86_64", version = "3.14", path_str = "/opt/python/cp314-cp314" },
  { identifier = "cp314t-musllinux_x86_64", version = "3.14", path_str = "/opt/python/cp314-cp314t" },
-  { identifier = "cp38-musllinux_i686", version = "3.8", path_str = "/opt/python/cp38-cp38" },
+  { identifier = "cp315-musllinux_x86_64", version = "3.15", path_str = "/opt/python/cp315-cp315" },
+  { identifier = "cp315t-musllinux_x86_64", version = "3.15", path_str = "/opt/python/cp315-cp315t" },
  { identifier = "cp39-musllinux_i686", version = "3.9", path_str = "/opt/python/cp39-cp39" },
  { identifier = "cp310-musllinux_i686", version = "3.10", path_str = "/opt/python/cp310-cp310" },
  { identifier = "cp311-musllinux_i686", version = "3.11", path_str = "/opt/python/cp311-cp311" },
  { identifier = "cp312-musllinux_i686", version = "3.12", path_str = "/opt/python/cp312-cp312" },
  { identifier = "cp313-musllinux_i686", version = "3.13", path_str = "/opt/python/cp313-cp313" },
-  { identifier = "cp313t-musllinux_i686", version = "3.13", path_str = "/opt/python/cp313-cp313t" },
  { identifier = "cp314-musllinux_i686", version = "3.14", path_str = "/opt/python/cp314-cp314" },
  { identifier = "cp314t-musllinux_i686", version = "3.14", path_str = "/opt/python/cp314-cp314t" },
-  { identifier = "cp38-musllinux_aarch64", version = "3.8", path_str = "/opt/python/cp38-cp38" },
+  { identifier = "cp315-musllinux_i686", version = "3.15", path_str = "/opt/python/cp315-cp315" },
+  { identifier = "cp315t-musllinux_i686", version = "3.15", path_str = "/opt/python/cp315-cp315t" },
  { identifier = "cp39-musllinux_aarch64", version = "3.9", path_str = "/opt/python/cp39-cp39" },
  { identifier = "cp310-musllinux_aarch64", version = "3.10", path_str = "/opt/python/cp310-cp310" },
  { identifier = "cp311-musllinux_aarch64", version = "3.11", path_str = "/opt/python/cp311-cp311" },
  { identifier = "cp312-musllinux_aarch64", version = "3.12", path_str = "/opt/python/cp312-cp312" },
  { identifier = "cp313-musllinux_aarch64", version = "3.13", path_str = "/opt/python/cp313-cp313" },
-  { identifier = "cp313t-musllinux_aarch64", version = "3.13", path_str = "/opt/python/cp313-cp313t" },
  { identifier = "cp314-musllinux_aarch64", version = "3.14", path_str = "/opt/python/cp314-cp314" },
  { identifier = "cp314t-musllinux_aarch64", version = "3.14", path_str = "/opt/python/cp314-cp314t" },
-  { identifier = "cp38-musllinux_ppc64le", version = "3.8", path_str = "/opt/python/cp38-cp38" },
+  { identifier = "cp315-musllinux_aarch64", version = "3.15", path_str = "/opt/python/cp315-cp315" },
+  { identifier = "cp315t-musllinux_aarch64", version = "3.15", path_str = "/opt/python/cp315-cp315t" },
  { identifier = "cp39-musllinux_ppc64le", version = "3.9", path_str = "/opt/python/cp39-cp39" },
  { identifier = "cp310-musllinux_ppc64le", version = "3.10", path_str = "/opt/python/cp310-cp310" },
  { identifier = "cp311-musllinux_ppc64le", version = "3.11", path_str = "/opt/python/cp311-cp311" },
  { identifier = "cp312-musllinux_ppc64le", version = "3.12", path_str = "/opt/python/cp312-cp312" },
  { identifier = "cp313-musllinux_ppc64le", version = "3.13", path_str = "/opt/python/cp313-cp313" },
-  { identifier = "cp313t-musllinux_ppc64le", version = "3.13", path_str = "/opt/python/cp313-cp313t" },
  { identifier = "cp314-musllinux_ppc64le", version = "3.14", path_str = "/opt/python/cp314-cp314" },
  { identifier = "cp314t-musllinux_ppc64le", version = "3.14", path_str = "/opt/python/cp314-cp314t" },
-  { identifier = "cp38-musllinux_s390x", version = "3.8", path_str = "/opt/python/cp38-cp38" },
+  { identifier = "cp315-musllinux_ppc64le", version = "3.15", path_str = "/opt/python/cp315-cp315" },
+  { identifier = "cp315t-musllinux_ppc64le", version = "3.15", path_str = "/opt/python/cp315-cp315t" },
  { identifier = "cp39-musllinux_s390x", version = "3.9", path_str = "/opt/python/cp39-cp39" },
  { identifier = "cp310-musllinux_s390x", version = "3.10", path_str = "/opt/python/cp310-cp310" },
  { identifier = "cp311-musllinux_s390x", version = "3.11", path_str = "/opt/python/cp311-cp311" },
  { identifier = "cp312-musllinux_s390x", version = "3.12", path_str = "/opt/python/cp312-cp312" },
  { identifier = "cp313-musllinux_s390x", version = "3.13", path_str = "/opt/python/cp313-cp313" },
-  { identifier = "cp313t-musllinux_s390x", version = "3.13", path_str = "/opt/python/cp313-cp313t" },
  { identifier = "cp314-musllinux_s390x", version = "3.14", path_str = "/opt/python/cp314-cp314" },
  { identifier = "cp314t-musllinux_s390x", version = "3.14", path_str = "/opt/python/cp314-cp314t" },
-  { identifier = "cp38-musllinux_armv7l", version = "3.8", path_str = "/opt/python/cp38-cp38" },
+  { identifier = "cp315-musllinux_s390x", version = "3.15", path_str = "/opt/python/cp315-cp315" },
+  { identifier = "cp315t-musllinux_s390x", version = "3.15", path_str = "/opt/python/cp315-cp315t" },
  { identifier = "cp39-musllinux_armv7l", version = "3.9", path_str = "/opt/python/cp39-cp39" },
  { identifier = "cp310-musllinux_armv7l", version = "3.10", path_str = "/opt/python/cp310-cp310" },
  { identifier = "cp311-musllinux_armv7l", version = "3.11", path_str = "/opt/python/cp311-cp311" },
  { identifier = "cp312-musllinux_armv7l", version = "3.12", path_str = "/opt/python/cp312-cp312" },
  { identifier = "cp313-musllinux_armv7l", version = "3.13", path_str = "/opt/python/cp313-cp313" },
-  { identifier = "cp313t-musllinux_armv7l", version = "3.13", path_str = "/opt/python/cp313-cp313t" },
  { identifier = "cp314-musllinux_armv7l", version = "3.14", path_str = "/opt/python/cp314-cp314" },
  { identifier = "cp314t-musllinux_armv7l", version = "3.14", path_str = "/opt/python/cp314-cp314t" },
-  { identifier = "cp38-musllinux_riscv64", version = "3.8", path_str = "/opt/python/cp38-cp38" },
+  { identifier = "cp315-musllinux_armv7l", version = "3.15", path_str = "/opt/python/cp315-cp315" },
+  { identifier = "cp315t-musllinux_armv7l", version = "3.15", path_str = "/opt/python/cp315-cp315t" },
  { identifier = "cp39-musllinux_riscv64", version = "3.9", path_str = "/opt/python/cp39-cp39" },
  { identifier = "cp310-musllinux_riscv64", version = "3.10", path_str = "/opt/python/cp310-cp310" },
  { identifier = "cp311-musllinux_riscv64", version = "3.11", path_str = "/opt/python/cp311-cp311" },
  { identifier = "cp312-musllinux_riscv64", version = "3.12", path_str = "/opt/python/cp312-cp312" },
  { identifier = "cp313-musllinux_riscv64", version = "3.13", path_str = "/opt/python/cp313-cp313" },
-  { identifier = "cp313t-musllinux_riscv64", version = "3.13", path_str = "/opt/python/cp313-cp313t" },
  { identifier = "cp314-musllinux_riscv64", version = "3.14", path_str = "/opt/python/cp314-cp314" },
  { identifier = "cp314t-musllinux_riscv64", version = "3.14", path_str = "/opt/python/cp314-cp314t" },
+  { identifier = "cp315-musllinux_riscv64", version = "3.15", path_str = "/opt/python/cp315-cp315" },
+  { identifier = "cp315t-musllinux_riscv64", version = "3.15", path_str = "/opt/python/cp315-cp315t" },
 ]

 [macos]
 python_configurations = [
-  { identifier = "cp38-macosx_x86_64", version = "3.8", url = "https://www.python.org/ftp/python/3.8.10/python-3.8.10-macosx10.9.pkg" },
-  { identifier = "cp38-macosx_arm64", version = "3.8", url = "https://www.python.org/ftp/python/3.8.10/python-3.8.10-macosx10.9.pkg" },
-  { identifier = "cp38-macosx_universal2", version = "3.8", url = "https://www.python.org/ftp/python/3.8.10/python-3.8.10-macosx10.9.pkg" },
-  { 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.11/python-3.10.11-macos11.pkg" },
-  { identifier = "cp310-macosx_arm64", version = "3.10", url = "https://www.python.org/ftp/python/3.10.11/python-3.10.11-macos11.pkg" },
-  { identifier = "cp310-macosx_universal2", version = "3.10", url = "https://www.python.org/ftp/python/3.10.11/python-3.10.11-macos11.pkg" },
-  { identifier = "cp311-macosx_x86_64", version = "3.11", url = "https://www.python.org/ftp/python/3.11.9/python-3.11.9-macos11.pkg" },
-  { identifier = "cp311-macosx_arm64", version = "3.11", url = "https://www.python.org/ftp/python/3.11.9/python-3.11.9-macos11.pkg" },
-  { identifier = "cp311-macosx_universal2", version = "3.11", url = "https://www.python.org/ftp/python/3.11.9/python-3.11.9-macos11.pkg" },
-  { identifier = "cp312-macosx_x86_64", version = "3.12", url = "https://www.python.org/ftp/python/3.12.10/python-3.12.10-macos11.pkg" },
-  { identifier = "cp312-macosx_arm64", version = "3.12", url = "https://www.python.org/ftp/python/3.12.10/python-3.12.10-macos11.pkg" },
-  { identifier = "cp312-macosx_universal2", version = "3.12", url = "https://www.python.org/ftp/python/3.12.10/python-3.12.10-macos11.pkg" },
-  { identifier = "cp313-macosx_x86_64", version = "3.13", url = "https://www.python.org/ftp/python/3.13.7/python-3.13.7-macos11.pkg" },
-  { identifier = "cp313-macosx_arm64", version = "3.13", url = "https://www.python.org/ftp/python/3.13.7/python-3.13.7-macos11.pkg" },
-  { identifier = "cp313-macosx_universal2", version = "3.13", url = "https://www.python.org/ftp/python/3.13.7/python-3.13.7-macos11.pkg" },
-  { identifier = "cp313t-macosx_x86_64", version = "3.13", url = "https://www.python.org/ftp/python/3.13.7/python-3.13.7-macos11.pkg" },
-  { identifier = "cp313t-macosx_arm64", version = "3.13", url = "https://www.python.org/ftp/python/3.13.7/python-3.13.7-macos11.pkg" },
-  { identifier = "cp313t-macosx_universal2", version = "3.13", url = "https://www.python.org/ftp/python/3.13.7/python-3.13.7-macos11.pkg" },
-  { identifier = "cp314-macosx_x86_64", version = "3.14", url = "https://www.python.org/ftp/python/3.14.0/python-3.14.0rc2-macos11.pkg" },
-  { identifier = "cp314-macosx_arm64", version = "3.14", url = "https://www.python.org/ftp/python/3.14.0/python-3.14.0rc2-macos11.pkg" },
-  { identifier = "cp314-macosx_universal2", version = "3.14", url = "https://www.python.org/ftp/python/3.14.0/python-3.14.0rc2-macos11.pkg" },
-  { identifier = "cp314t-macosx_x86_64", version = "3.14", url = "https://www.python.org/ftp/python/3.14.0/python-3.14.0rc2-macos11.pkg" },
-  { identifier = "cp314t-macosx_arm64", version = "3.14", url = "https://www.python.org/ftp/python/3.14.0/python-3.14.0rc2-macos11.pkg" },
-  { identifier = "cp314t-macosx_universal2", version = "3.14", url = "https://www.python.org/ftp/python/3.14.0/python-3.14.0rc2-macos11.pkg" },
-  { identifier = "pp38-macosx_x86_64", version = "3.8", url = "https://downloads.python.org/pypy/pypy3.8-v7.3.11-macos_x86_64.tar.bz2" },
-  { identifier = "pp38-macosx_arm64", version = "3.8", url = "https://downloads.python.org/pypy/pypy3.8-v7.3.11-macos_arm64.tar.bz2" },
-  { identifier = "pp39-macosx_x86_64", version = "3.9", url = "https://downloads.python.org/pypy/pypy3.9-v7.3.16-macos_x86_64.tar.bz2" },
-  { identifier = "pp39-macosx_arm64", version = "3.9", url = "https://downloads.python.org/pypy/pypy3.9-v7.3.16-macos_arm64.tar.bz2" },
-  { identifier = "pp310-macosx_x86_64", version = "3.10", url = "https://downloads.python.org/pypy/pypy3.10-v7.3.19-macos_x86_64.tar.bz2" },
-  { identifier = "pp310-macosx_arm64", version = "3.10", url = "https://downloads.python.org/pypy/pypy3.10-v7.3.19-macos_arm64.tar.bz2" },
-  { identifier = "pp311-macosx_x86_64", version = "3.11", url = "https://downloads.python.org/pypy/pypy3.11-v7.3.20-macos_x86_64.tar.bz2" },
-  { identifier = "pp311-macosx_arm64", version = "3.11", url = "https://downloads.python.org/pypy/pypy3.11-v7.3.20-macos_arm64.tar.bz2" },
-  { identifier = "gp311_242-macosx_x86_64", version = "3.11", url = "https://github.com/oracle/graalpython/releases/download/graal-24.2.2/graalpy-24.2.2-macos-amd64.tar.gz" },
-  { identifier = "gp311_242-macosx_arm64", version = "3.11", url = "https://github.com/oracle/graalpython/releases/download/graal-24.2.2/graalpy-24.2.2-macos-aarch64.tar.gz" },
+  { identifier = "cp39-macosx_x86_64", version = "3.9", url = "https://www.python.org/ftp/python/3.9.13/python-3.9.13-macos11.pkg", sha256 = "351fe18f4fb03be7afac5e4012fc0a51345f43202af43ef620cf1eee5ee36578" },
+  { identifier = "cp39-macosx_arm64", version = "3.9", url = "https://www.python.org/ftp/python/3.9.13/python-3.9.13-macos11.pkg", sha256 = "351fe18f4fb03be7afac5e4012fc0a51345f43202af43ef620cf1eee5ee36578" },
+  { identifier = "cp39-macosx_universal2", version = "3.9", url = "https://www.python.org/ftp/python/3.9.13/python-3.9.13-macos11.pkg", sha256 = "351fe18f4fb03be7afac5e4012fc0a51345f43202af43ef620cf1eee5ee36578" },
+  { identifier = "cp310-macosx_x86_64", version = "3.10", url = "https://www.python.org/ftp/python/3.10.11/python-3.10.11-macos11.pkg", sha256 = "767ed35ad688d28ea4494081ae96408a0318d0d5bb9ca0139d74d6247b231cfc" },
+  { identifier = "cp310-macosx_arm64", version = "3.10", url = "https://www.python.org/ftp/python/3.10.11/python-3.10.11-macos11.pkg", sha256 = "767ed35ad688d28ea4494081ae96408a0318d0d5bb9ca0139d74d6247b231cfc" },
+  { identifier = "cp310-macosx_universal2", version = "3.10", url = "https://www.python.org/ftp/python/3.10.11/python-3.10.11-macos11.pkg", sha256 = "767ed35ad688d28ea4494081ae96408a0318d0d5bb9ca0139d74d6247b231cfc" },
+  { identifier = "cp311-macosx_x86_64", version = "3.11", url = "https://www.python.org/ftp/python/3.11.9/python-3.11.9-macos11.pkg", sha256 = "b6cfdee2571ca56ee895043ca1e7110fb78a878cee3eb0c21accb2de34d24b55" },
+  { identifier = "cp311-macosx_arm64", version = "3.11", url = "https://www.python.org/ftp/python/3.11.9/python-3.11.9-macos11.pkg", sha256 = "b6cfdee2571ca56ee895043ca1e7110fb78a878cee3eb0c21accb2de34d24b55" },
+  { identifier = "cp311-macosx_universal2", version = "3.11", url = "https://www.python.org/ftp/python/3.11.9/python-3.11.9-macos11.pkg", sha256 = "b6cfdee2571ca56ee895043ca1e7110fb78a878cee3eb0c21accb2de34d24b55" },
+  { identifier = "cp312-macosx_x86_64", version = "3.12", url = "https://www.python.org/ftp/python/3.12.10/python-3.12.10-macos11.pkg", sha256 = "8373e58da4ea146b3eb1c1f9834f19a319440b6b679b06050b1f9ee3237aa8e4" },
+  { identifier = "cp312-macosx_arm64", version = "3.12", url = "https://www.python.org/ftp/python/3.12.10/python-3.12.10-macos11.pkg", sha256 = "8373e58da4ea146b3eb1c1f9834f19a319440b6b679b06050b1f9ee3237aa8e4" },
+  { identifier = "cp312-macosx_universal2", version = "3.12", url = "https://www.python.org/ftp/python/3.12.10/python-3.12.10-macos11.pkg", sha256 = "8373e58da4ea146b3eb1c1f9834f19a319440b6b679b06050b1f9ee3237aa8e4" },
+  { identifier = "cp313-macosx_x86_64", version = "3.13", url = "https://www.python.org/ftp/python/3.13.13/python-3.13.13-macos11.pkg", sha256 = "a909cb655af5db67d5a90b3603437a1d58bec3446d624e4034e278ac62023cc9" },
+  { identifier = "cp313-macosx_arm64", version = "3.13", url = "https://www.python.org/ftp/python/3.13.13/python-3.13.13-macos11.pkg", sha256 = "a909cb655af5db67d5a90b3603437a1d58bec3446d624e4034e278ac62023cc9" },
+  { identifier = "cp313-macosx_universal2", version = "3.13", url = "https://www.python.org/ftp/python/3.13.13/python-3.13.13-macos11.pkg", sha256 = "a909cb655af5db67d5a90b3603437a1d58bec3446d624e4034e278ac62023cc9" },
+  { identifier = "cp314-macosx_x86_64", version = "3.14", url = "https://www.python.org/ftp/python/3.14.5/python-3.14.5-macos11.pkg", sha256 = "b28a8dc33c456dd06c97024697d63ca916cfb494594c06fa3e4ef4d41fa82335" },
+  { identifier = "cp314-macosx_arm64", version = "3.14", url = "https://www.python.org/ftp/python/3.14.5/python-3.14.5-macos11.pkg", sha256 = "b28a8dc33c456dd06c97024697d63ca916cfb494594c06fa3e4ef4d41fa82335" },
+  { identifier = "cp314-macosx_universal2", version = "3.14", url = "https://www.python.org/ftp/python/3.14.5/python-3.14.5-macos11.pkg", sha256 = "b28a8dc33c456dd06c97024697d63ca916cfb494594c06fa3e4ef4d41fa82335" },
+  { identifier = "cp314t-macosx_x86_64", version = "3.14", url = "https://www.python.org/ftp/python/3.14.5/python-3.14.5-macos11.pkg", sha256 = "b28a8dc33c456dd06c97024697d63ca916cfb494594c06fa3e4ef4d41fa82335" },
+  { identifier = "cp314t-macosx_arm64", version = "3.14", url = "https://www.python.org/ftp/python/3.14.5/python-3.14.5-macos11.pkg", sha256 = "b28a8dc33c456dd06c97024697d63ca916cfb494594c06fa3e4ef4d41fa82335" },
+  { identifier = "cp314t-macosx_universal2", version = "3.14", url = "https://www.python.org/ftp/python/3.14.5/python-3.14.5-macos11.pkg", sha256 = "b28a8dc33c456dd06c97024697d63ca916cfb494594c06fa3e4ef4d41fa82335" },
+  { identifier = "cp315-macosx_x86_64", version = "3.15", url = "https://www.python.org/ftp/python/3.15.0/python-3.15.0b2-macos11.pkg", sha256 = "29b5c95f255f846f77e1c119146836445f929de1392a3ae9ef24f559e1345418" },
+  { identifier = "cp315-macosx_arm64", version = "3.15", url = "https://www.python.org/ftp/python/3.15.0/python-3.15.0b2-macos11.pkg", sha256 = "29b5c95f255f846f77e1c119146836445f929de1392a3ae9ef24f559e1345418" },
+  { identifier = "cp315-macosx_universal2", version = "3.15", url = "https://www.python.org/ftp/python/3.15.0/python-3.15.0b2-macos11.pkg", sha256 = "29b5c95f255f846f77e1c119146836445f929de1392a3ae9ef24f559e1345418" },
+  { identifier = "cp315t-macosx_x86_64", version = "3.15", url = "https://www.python.org/ftp/python/3.15.0/python-3.15.0b2-macos11.pkg", sha256 = "29b5c95f255f846f77e1c119146836445f929de1392a3ae9ef24f559e1345418" },
+  { identifier = "cp315t-macosx_arm64", version = "3.15", url = "https://www.python.org/ftp/python/3.15.0/python-3.15.0b2-macos11.pkg", sha256 = "29b5c95f255f846f77e1c119146836445f929de1392a3ae9ef24f559e1345418" },
+  { identifier = "cp315t-macosx_universal2", version = "3.15", url = "https://www.python.org/ftp/python/3.15.0/python-3.15.0b2-macos11.pkg", sha256 = "29b5c95f255f846f77e1c119146836445f929de1392a3ae9ef24f559e1345418" },
+  { identifier = "pp39-macosx_x86_64", version = "3.9", url = "https://downloads.python.org/pypy/pypy3.9-v7.3.16-macos_x86_64.tar.bz2", sha256 = "fda015431621e7e5aa16359d114f2c45a77ed936992c1efff86302e768a6b21c" },
+  { identifier = "pp39-macosx_arm64", version = "3.9", url = "https://downloads.python.org/pypy/pypy3.9-v7.3.16-macos_arm64.tar.bz2", sha256 = "88f824e7a2d676440d09bc90fc959ae0fd3557d7e2f14bfbbe53d41d159a47fe" },
+  { identifier = "pp310-macosx_x86_64", version = "3.10", url = "https://downloads.python.org/pypy/pypy3.10-v7.3.19-macos_x86_64.tar.bz2", sha256 = "2c5e5c2a33ac882551d7f28b98d19d486b8995aa50824a73b4edcc6aeec35c63" },
+  { identifier = "pp310-macosx_arm64", version = "3.10", url = "https://downloads.python.org/pypy/pypy3.10-v7.3.19-macos_arm64.tar.bz2", sha256 = "3db8a03fc496164801646844d7f3b12baa0adb3ad9a0b7cb124521bc2e168a36" },
+  { identifier = "pp311-macosx_x86_64", version = "3.11", url = "https://downloads.python.org/pypy/pypy3.11-v7.3.23-macos_x86_64.tar.bz2", sha256 = "c95363c4e87235d11a6cec8128239c291b1eb67a752778fbcfe029a71da82b5e" },
+  { identifier = "pp311-macosx_arm64", version = "3.11", url = "https://downloads.python.org/pypy/pypy3.11-v7.3.23-macos_arm64.tar.bz2", sha256 = "4747b3aceba4c1c6104cddc0fe5ea302101d32955f0957347b9ecc4fbd7aed05" },
+  { identifier = "gp312_250-macosx_x86_64", version = "3.12", url = "https://github.com/oracle/graalpython/releases/download/graal-25.0.1/graalpy-25.0.1-macos-amd64.tar.gz", sha256 = "10b0721d52397f0cc85f038900318da2203711cbcfae7899e3faed49d3dc6221" },
+  { identifier = "gp312_250-macosx_arm64", version = "3.12", url = "https://github.com/oracle/graalpython/releases/download/graal-25.0.3/graalpy-25.0.3-macos-aarch64.tar.gz", sha256 = "387d9f5b376860842bea4d55aae5820974f3f3b68fc36c77ae863a061a888857" },
 ]

 [windows]
 python_configurations = [
-  { identifier = "cp38-win32", version = "3.8.10", arch = "32" },
-  { 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.11", arch = "32" },
-  { identifier = "cp310-win_amd64", version = "3.10.11", arch = "64" },
-  { identifier = "cp311-win32", version = "3.11.9", arch = "32" },
-  { identifier = "cp311-win_amd64", version = "3.11.9", arch = "64" },
-  { identifier = "cp312-win32", version = "3.12.10", arch = "32" },
-  { identifier = "cp312-win_amd64", version = "3.12.10", arch = "64" },
-  { identifier = "cp313-win32", version = "3.13.7", arch = "32" },
-  { identifier = "cp313t-win32", version = "3.13.7", arch = "32" },
-  { identifier = "cp313-win_amd64", version = "3.13.7", arch = "64" },
-  { identifier = "cp313t-win_amd64", version = "3.13.7", arch = "64" },
-  { identifier = "cp314-win32", version = "3.14.0-rc2", arch = "32" },
-  { identifier = "cp314t-win32", version = "3.14.0-rc2", arch = "32" },
-  { identifier = "cp314-win_amd64", version = "3.14.0-rc2", arch = "64" },
-  { identifier = "cp314t-win_amd64", version = "3.14.0-rc2", arch = "64" },
-  { identifier = "cp39-win_arm64", version = "3.9.10", arch = "ARM64" },
-  { identifier = "cp310-win_arm64", version = "3.10.11", arch = "ARM64" },
-  { identifier = "cp311-win_arm64", version = "3.11.9", arch = "ARM64" },
-  { identifier = "cp312-win_arm64", version = "3.12.10", arch = "ARM64" },
-  { identifier = "cp313-win_arm64", version = "3.13.7", arch = "ARM64" },
-  { identifier = "cp313t-win_arm64", version = "3.13.7", arch = "ARM64" },
-  { identifier = "cp314-win_arm64", version = "3.14.0-rc2", arch = "ARM64" },
-  { identifier = "cp314t-win_arm64", version = "3.14.0-rc2", arch = "ARM64" },
-  { identifier = "pp38-win_amd64", version = "3.8", arch = "64", url = "https://downloads.python.org/pypy/pypy3.8-v7.3.11-win64.zip" },
-  { identifier = "pp39-win_amd64", version = "3.9", arch = "64", url = "https://downloads.python.org/pypy/pypy3.9-v7.3.16-win64.zip" },
-  { identifier = "pp310-win_amd64", version = "3.10", arch = "64", url = "https://downloads.python.org/pypy/pypy3.10-v7.3.19-win64.zip" },
-  { identifier = "pp311-win_amd64", version = "3.11", arch = "64", url = "https://downloads.python.org/pypy/pypy3.11-v7.3.20-win64.zip" },
-  { identifier = "gp311_242-win_amd64", version = "3.11", arch = "64", url = "https://github.com/oracle/graalpython/releases/download/graal-24.2.2/graalpy-24.2.2-windows-amd64.zip" },
+  { identifier = "cp39-win32", version = "3.9.13" },
+  { identifier = "cp39-win_amd64", version = "3.9.13" },
+  { identifier = "cp310-win32", version = "3.10.11" },
+  { identifier = "cp310-win_amd64", version = "3.10.11" },
+  { identifier = "cp311-win32", version = "3.11.9" },
+  { identifier = "cp311-win_amd64", version = "3.11.9" },
+  { identifier = "cp312-win32", version = "3.12.10" },
+  { identifier = "cp312-win_amd64", version = "3.12.10" },
+  { identifier = "cp313-win32", version = "3.13.13" },
+  { identifier = "cp313-win_amd64", version = "3.13.13" },
+  { identifier = "cp314-win32", version = "3.14.5" },
+  { identifier = "cp314t-win32", version = "3.14.5" },
+  { identifier = "cp314-win_amd64", version = "3.14.5" },
+  { identifier = "cp314t-win_amd64", version = "3.14.5" },
+  { identifier = "cp315-win32", version = "3.15.0-b2" },
+  { identifier = "cp315t-win32", version = "3.15.0-b2" },
+  { identifier = "cp315-win_amd64", version = "3.15.0-b2" },
+  { identifier = "cp315t-win_amd64", version = "3.15.0-b2" },
+  { identifier = "cp39-win_arm64", version = "3.9.10" },
+  { identifier = "cp310-win_arm64", version = "3.10.11" },
+  { identifier = "cp311-win_arm64", version = "3.11.9" },
+  { identifier = "cp312-win_arm64", version = "3.12.10" },
+  { identifier = "cp313-win_arm64", version = "3.13.13" },
+  { identifier = "cp314-win_arm64", version = "3.14.5" },
+  { identifier = "cp314t-win_arm64", version = "3.14.5" },
+  { identifier = "cp315-win_arm64", version = "3.15.0-b2" },
+  { identifier = "cp315t-win_arm64", version = "3.15.0-b2" },
+  { identifier = "pp39-win_amd64", version = "3.9", url = "https://downloads.python.org/pypy/pypy3.9-v7.3.16-win64.zip", sha256 = "06ec12a5e964dc0ad33e6f380185a4d295178dce6d6df512f508e7aee00a1323" },
+  { identifier = "pp310-win_amd64", version = "3.10", url = "https://downloads.python.org/pypy/pypy3.10-v7.3.19-win64.zip", sha256 = "c0d07bba6c8fb4e5804f4a8b3f8ef07cc3d89f6ad1db42a45ffb9be60bbb7cc2" },
+  { identifier = "pp311-win_amd64", version = "3.11", url = "https://downloads.python.org/pypy/pypy3.11-v7.3.23-win64.zip", sha256 = "948b8ea58dea5b9917210fe4afd242c788fbfaba1c3f1a25e696a404f703389a" },
+  { identifier = "gp312_250-win_amd64", version = "3.12", url = "https://github.com/oracle/graalpython/releases/download/graal-25.0.3/graalpy-25.0.3-windows-amd64.zip", sha256 = "2ae5c42b93e08d9e106a017634a3442b272ccae6d08ace157244de0449e937d4" },
 ]

 [pyodide]
 python_configurations = [
-  { identifier = "cp312-pyodide_wasm32", version = "3.12", default_pyodide_version = "0.27.7", node_version = "v22" },
-  { identifier = "cp313-pyodide_wasm32", version = "3.13", default_pyodide_version = "0.28.2", node_version = "v22" },
+  { identifier = "cp312-pyodide_wasm32", version = "3.12", default_pyodide_version = "0.27.7", node_version = "v22", sha256 = "0c2e7db42efa5d1dac38b50f8b3d659a1e3885d0a233494831b8206281307d52" },
+  { identifier = "cp313-pyodide_wasm32", version = "3.13", default_pyodide_version = "0.29.4", node_version = "v22", sha256 = "a29fc4a076408a18fc29eb4b280f80c6dddc95c19514c874c29e590d0931c02a" },
+  { identifier = "cp314-pyodide_wasm32", version = "3.14", default_pyodide_version = "314.0.0a2", node_version = "v24", sha256 = "ac7bbcdf289ab3ae25621c436b1d013099ef6bec644ad0538dae5d65552c5c95" },
 ]

 [android]
 python_configurations = [
-  { identifier = "cp313-android_arm64_v8a", version = "3.13", url = "https://repo.maven.apache.org/maven2/com/chaquo/python/python/3.13.5+20250722.214220/python-3.13.5+20250722.214220-aarch64-linux-android.tar.gz" },
-  { identifier = "cp313-android_x86_64", version = "3.13", url = "https://repo.maven.apache.org/maven2/com/chaquo/python/python/3.13.5+20250722.214220/python-3.13.5+20250722.214220-x86_64-linux-android.tar.gz" },
+  { identifier = "cp313-android_arm64_v8a", version = "3.13", url = "https://repo.maven.apache.org/maven2/com/chaquo/python/python/3.13.13/python-3.13.13-aarch64-linux-android.tar.gz", sha256 = "a21250c246b36eb704be096be51e40ab24cafa3ae1d7ca4c396e6bf780cf87cf" },
+  { identifier = "cp313-android_x86_64", version = "3.13", url = "https://repo.maven.apache.org/maven2/com/chaquo/python/python/3.13.13/python-3.13.13-x86_64-linux-android.tar.gz", sha256 = "b021b76df2c8d64e41c76d18a2d91f27652356bd932c06f9076bac1b664c0e37" },
+  { identifier = "cp314-android_arm64_v8a", version = "3.14", url = "https://www.python.org/ftp/python/3.14.5/python-3.14.5-aarch64-linux-android.tar.gz", sha256 = "f008321abf837fcaec569df143283ece0e764b18d8c75763200160553f906af1" },
+  { identifier = "cp314-android_x86_64", version = "3.14", url = "https://www.python.org/ftp/python/3.14.5/python-3.14.5-x86_64-linux-android.tar.gz", sha256 = "36184e31464b2b959d92c81ded8d025834342cc080623bced282a2a9a57bd47c" },
+  { identifier = "cp315-android_arm64_v8a", version = "3.15", url = "https://www.python.org/ftp/python/3.15.0/python-3.15.0b2-aarch64-linux-android.tar.gz", sha256 = "de5e36ffc3c33b63a1ed53fe83db4dee16b003a3180ac35e5c4c203d3750e076" },
+  { identifier = "cp315-android_x86_64", version = "3.15", url = "https://www.python.org/ftp/python/3.15.0/python-3.15.0b2-x86_64-linux-android.tar.gz", sha256 = "e05ef9c142ea83b41b194b16014ffe2249d27783313c3b00b97f6c93d9a56b92" },
 ]

 [ios]
 python_configurations = [
-  { identifier = "cp313-ios_arm64_iphoneos", version = "3.13", url = "https://github.com/beeware/Python-Apple-support/releases/download/3.13-b10/Python-3.13-iOS-support.b10.tar.gz" },
-  { identifier = "cp313-ios_x86_64_iphonesimulator", version = "3.13", url = "https://github.com/beeware/Python-Apple-support/releases/download/3.13-b10/Python-3.13-iOS-support.b10.tar.gz" },
-  { identifier = "cp313-ios_arm64_iphonesimulator", version = "3.13", url = "https://github.com/beeware/Python-Apple-support/releases/download/3.13-b10/Python-3.13-iOS-support.b10.tar.gz" },
-  { identifier = "cp314-ios_arm64_iphoneos", version = "3.14", url = "https://github.com/beeware/Python-Apple-support/releases/download/3.14-b6/Python-3.14-iOS-support.b6.tar.gz" },
-  { identifier = "cp314-ios_x86_64_iphonesimulator", version = "3.14", url = "https://github.com/beeware/Python-Apple-support/releases/download/3.14-b6/Python-3.14-iOS-support.b6.tar.gz" },
-  { identifier = "cp314-ios_arm64_iphonesimulator", version = "3.14", url = "https://github.com/beeware/Python-Apple-support/releases/download/3.14-b6/Python-3.14-iOS-support.b6.tar.gz" },
+  { identifier = "cp313-ios_arm64_iphoneos", version = "3.13", url = "https://github.com/beeware/Python-Apple-support/releases/download/3.13-b13/Python-3.13-iOS-support.b13.tar.gz", sha256 = "d1f95f95137a4b91dc0cbe9b99ddfc0a78918dde883c7fbe7147074a5e715274" },
+  { identifier = "cp313-ios_x86_64_iphonesimulator", version = "3.13", url = "https://github.com/beeware/Python-Apple-support/releases/download/3.13-b13/Python-3.13-iOS-support.b13.tar.gz", sha256 = "d1f95f95137a4b91dc0cbe9b99ddfc0a78918dde883c7fbe7147074a5e715274" },
+  { identifier = "cp313-ios_arm64_iphonesimulator", version = "3.13", url = "https://github.com/beeware/Python-Apple-support/releases/download/3.13-b13/Python-3.13-iOS-support.b13.tar.gz", sha256 = "d1f95f95137a4b91dc0cbe9b99ddfc0a78918dde883c7fbe7147074a5e715274" },
+  { identifier = "cp314-ios_arm64_iphoneos", version = "3.14", url = "https://github.com/beeware/Python-Apple-support/releases/download/3.14-b9/Python-3.14-iOS-support.b9.tar.gz", sha256 = "8e4123b543bf17fdae2e2c6c033434487752438431014eb12e6d833aa35927a8" },
+  { identifier = "cp314-ios_x86_64_iphonesimulator", version = "3.14", url = "https://github.com/beeware/Python-Apple-support/releases/download/3.14-b9/Python-3.14-iOS-support.b9.tar.gz", sha256 = "8e4123b543bf17fdae2e2c6c033434487752438431014eb12e6d833aa35927a8" },
+  { identifier = "cp314-ios_arm64_iphonesimulator", version = "3.14", url = "https://github.com/beeware/Python-Apple-support/releases/download/3.14-b9/Python-3.14-iOS-support.b9.tar.gz", sha256 = "8e4123b543bf17fdae2e2c6c033434487752438431014eb12e6d833aa35927a8" },
+  { identifier = "cp315-ios_arm64_iphoneos", version = "3.15", url = "https://www.python.org/ftp/python/3.15.0/python-3.15.0b2-iOS-XCframework.tar.gz", sha256 = "fd6b6fb8f82cf44622d28ea53b8197c89fb06505557d29d4d7a47f9386c1c896" },
+  { identifier = "cp315-ios_x86_64_iphonesimulator", version = "3.15", url = "https://www.python.org/ftp/python/3.15.0/python-3.15.0b2-iOS-XCframework.tar.gz", sha256 = "fd6b6fb8f82cf44622d28ea53b8197c89fb06505557d29d4d7a47f9386c1c896" },
+  { identifier = "cp315-ios_arm64_iphonesimulator", version = "3.15", url = "https://www.python.org/ftp/python/3.15.0/python-3.15.0b2-iOS-XCframework.tar.gz", sha256 = "fd6b6fb8f82cf44622d28ea53b8197c89fb06505557d29d4d7a47f9386c1c896" },
 ]
@@ -13,8 +13,6 @@
    },
    "enable": {
      "enum": [
-        "cpython-experimental-riscv64",
-        "cpython-freethreading",
        "cpython-prerelease",
        "graalpy",
        "pyodide-prerelease",
@@ -28,6 +26,36 @@
  "description": "cibuildwheel's settings.",
  "type": "object",
  "properties": {
+    "audit-command": {
+      "description": "Execute a shell command to audit each wheel after it is repaired. Use {wheel} for each wheel path, or {abi3_wheel} to only audit abi3 wheels.",
+      "oneOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      ],
+      "title": "CIBW_AUDIT_COMMAND"
+    },
+    "audit-requires": {
+      "description": "Install Python dependencies for the audit step.",
+      "oneOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      ],
+      "title": "CIBW_AUDIT_REQUIRES"
+    },
    "archs": {
      "description": "Change the architectures built on your machine by default.",
      "oneOf": [
@@ -108,13 +136,14 @@
    },
    "build-frontend": {
      "default": "default",
-      "description": "Set the tool to use to build, either \"build\" (default), \"build[uv]\", or \"pip\"",
+      "description": "Set the tool to use to build, either \"build\" (default), \"build[uv]\", \"uv\", or \"pip\"",
      "oneOf": [
        {
          "enum": [
            "pip",
            "build",
            "build[uv]",
+            "uv",
            "default"
          ]
        },
@@ -130,6 +159,10 @@
          "type": "string",
          "pattern": "^build\\[uv\\]; ?args:"
        },
+        {
+          "type": "string",
+          "pattern": "^uv; ?args:"
+        },
        {
          "type": "object",
          "additionalProperties": false,
@@ -141,7 +174,8 @@
              "enum": [
                "pip",
                "build",
-                "build[uv]"
+                "build[uv]",
+                "uv"
              ]
            },
            "args": {
@@ -426,6 +460,34 @@
      ],
      "title": "CIBW_XBUILD_TOOLS"
    },
+    "xbuild-files": {
+      "description": "Platform-specific files in the build environment",
+      "oneOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "patternProperties": {
+            ".+": {
+              "oneOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                }
+              ]
+            }
+          }
+        }
+      ],
+      "title": "CIBW_XBUILD_FILES"
+    },
    "pyodide-version": {
      "type": "string",
      "description": "Specify the version of Pyodide to use",
@@ -569,6 +631,39 @@
      ],
      "title": "CIBW_TEST_ENVIRONMENT"
    },
+    "test-runtime": {
+      "description": "Additional configuration for the test runner",
+      "oneOf": [
+        {
+          "type": "string",
+          "pattern": "^$"
+        },
+        {
+          "type": "object",
+          "additionalProperties": false
+        },
+        {
+          "type": "string",
+          "pattern": "args:"
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "args"
+          ],
+          "properties": {
+            "args": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      ],
+      "title": "CIBW_TEST_RUNTIME"
+    },
    "overrides": {
      "type": "array",
      "description": "An overrides array",
@@ -597,6 +692,12 @@
            "type": "object",
            "additionalProperties": false,
            "properties": {
+              "audit-command": {
+                "$ref": "#/$defs/inherit"
+              },
+              "audit-requires": {
+                "$ref": "#/$defs/inherit"
+              },
              "before-all": {
                "$ref": "#/$defs/inherit"
              },
@@ -606,6 +707,9 @@
              "xbuild-tools": {
                "$ref": "#/$defs/inherit"
              },
+              "xbuild-files": {
+                "$ref": "#/$defs/inherit"
+              },
              "before-test": {
                "$ref": "#/$defs/inherit"
              },
@@ -638,9 +742,18 @@
              },
              "test-environment": {
                "$ref": "#/$defs/inherit"
+              },
+              "test-runtime": {
+                "$ref": "#/$defs/inherit"
              }
            }
          },
+          "audit-command": {
+            "$ref": "#/properties/audit-command"
+          },
+          "audit-requires": {
+            "$ref": "#/properties/audit-requires"
+          },
          "before-all": {
            "$ref": "#/properties/before-all"
          },
@@ -725,6 +838,9 @@
          "xbuild-tools": {
            "$ref": "#/properties/xbuild-tools"
          },
+          "xbuild-files": {
+            "$ref": "#/properties/xbuild-files"
+          },
          "pyodide-version": {
            "$ref": "#/properties/pyodide-version"
          },
@@ -748,6 +864,9 @@
          },
          "test-environment": {
            "$ref": "#/properties/test-environment"
+          },
+          "test-runtime": {
+            "$ref": "#/properties/test-runtime"
          }
        }
      }
@@ -756,6 +875,12 @@
      "type": "object",
      "additionalProperties": false,
      "properties": {
+        "audit-command": {
+          "$ref": "#/properties/audit-command"
+        },
+        "audit-requires": {
+          "$ref": "#/properties/audit-requires"
+        },
        "archs": {
          "$ref": "#/properties/archs"
        },
@@ -840,6 +965,9 @@
        "xbuild-tools": {
          "$ref": "#/properties/xbuild-tools"
        },
+        "xbuild-files": {
+          "$ref": "#/properties/xbuild-files"
+        },
        "pyodide-version": {
          "$ref": "#/properties/pyodide-version"
        },
@@ -876,6 +1004,9 @@
        },
        "test-environment": {
          "$ref": "#/properties/test-environment"
+        },
+        "test-runtime": {
+          "$ref": "#/properties/test-runtime"
        }
      }
    },
@@ -883,6 +1014,12 @@
      "type": "object",
      "additionalProperties": false,
      "properties": {
+        "audit-command": {
+          "$ref": "#/properties/audit-command"
+        },
+        "audit-requires": {
+          "$ref": "#/properties/audit-requires"
+        },
        "archs": {
          "$ref": "#/properties/archs"
        },
@@ -913,11 +1050,27 @@
        "xbuild-tools": {
          "$ref": "#/properties/xbuild-tools"
        },
+        "xbuild-files": {
+          "$ref": "#/properties/xbuild-files"
+        },
        "pyodide-version": {
          "$ref": "#/properties/pyodide-version"
        },
        "repair-wheel-command": {
-          "$ref": "#/properties/repair-wheel-command"
+          "description": "Execute a shell command to repair each built wheel.",
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "title": "CIBW_REPAIR_WHEEL_COMMAND",
+          "default": "delvewheel repair -w {dest_dir} -v {wheel}"
        },
        "test-command": {
          "$ref": "#/properties/test-command"
@@ -936,6 +1089,9 @@
        },
        "test-environment": {
          "$ref": "#/properties/test-environment"
+        },
+        "test-runtime": {
+          "$ref": "#/properties/test-runtime"
        }
      }
    },
@@ -943,6 +1099,12 @@
      "type": "object",
      "additionalProperties": false,
      "properties": {
+        "audit-command": {
+          "$ref": "#/properties/audit-command"
+        },
+        "audit-requires": {
+          "$ref": "#/properties/audit-requires"
+        },
        "archs": {
          "$ref": "#/properties/archs"
        },
@@ -973,6 +1135,9 @@
        "xbuild-tools": {
          "$ref": "#/properties/xbuild-tools"
        },
+        "xbuild-files": {
+          "$ref": "#/properties/xbuild-files"
+        },
        "pyodide-version": {
          "$ref": "#/properties/pyodide-version"
        },
@@ -1009,6 +1174,9 @@
        },
        "test-environment": {
          "$ref": "#/properties/test-environment"
+        },
+        "test-runtime": {
+          "$ref": "#/properties/test-runtime"
        }
      }
    },
@@ -1016,6 +1184,12 @@
      "type": "object",
      "additionalProperties": false,
      "properties": {
+        "audit-command": {
+          "$ref": "#/properties/audit-command"
+        },
+        "audit-requires": {
+          "$ref": "#/properties/audit-requires"
+        },
        "archs": {
          "$ref": "#/properties/archs"
        },
@@ -1046,6 +1220,9 @@
        "xbuild-tools": {
          "$ref": "#/properties/xbuild-tools"
        },
+        "xbuild-files": {
+          "$ref": "#/properties/xbuild-files"
+        },
        "pyodide-version": {
          "$ref": "#/properties/pyodide-version"
        },
@@ -1069,6 +1246,9 @@
        },
        "test-environment": {
          "$ref": "#/properties/test-environment"
+        },
+        "test-runtime": {
+          "$ref": "#/properties/test-runtime"
        }
      }
    },
@@ -1076,6 +1256,12 @@
      "type": "object",
      "additionalProperties": false,
      "properties": {
+        "audit-command": {
+          "$ref": "#/properties/audit-command"
+        },
+        "audit-requires": {
+          "$ref": "#/properties/audit-requires"
+        },
        "archs": {
          "$ref": "#/properties/archs"
        },
@@ -1106,11 +1292,27 @@
        "xbuild-tools": {
          "$ref": "#/properties/xbuild-tools"
        },
+        "xbuild-files": {
+          "$ref": "#/properties/xbuild-files"
+        },
        "pyodide-version": {
          "$ref": "#/properties/pyodide-version"
        },
        "repair-wheel-command": {
-          "$ref": "#/properties/repair-wheel-command"
+          "description": "Execute a shell command to repair each built wheel.",
+          "oneOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "title": "CIBW_REPAIR_WHEEL_COMMAND",
+          "default": "auditwheel repair --ldpaths {ldpaths} -w {dest_dir} {wheel}"
        },
        "test-command": {
          "$ref": "#/properties/test-command"
@@ -1129,6 +1331,9 @@
        },
        "test-environment": {
          "$ref": "#/properties/test-environment"
+        },
+        "test-runtime": {
+          "$ref": "#/properties/test-runtime"
        }
      }
    },
@@ -1136,6 +1341,12 @@
      "type": "object",
      "additionalProperties": false,
      "properties": {
+        "audit-command": {
+          "$ref": "#/properties/audit-command"
+        },
+        "audit-requires": {
+          "$ref": "#/properties/audit-requires"
+        },
        "archs": {
          "$ref": "#/properties/archs"
        },
@@ -1166,6 +1377,9 @@
        "xbuild-tools": {
          "$ref": "#/properties/xbuild-tools"
        },
+        "xbuild-files": {
+          "$ref": "#/properties/xbuild-files"
+        },
        "pyodide-version": {
          "$ref": "#/properties/pyodide-version"
        },
@@ -1189,6 +1403,9 @@
        },
        "test-environment": {
          "$ref": "#/properties/test-environment"
+        },
+        "test-runtime": {
+          "$ref": "#/properties/test-runtime"
        }
      }
    }
@@ -2,116 +2,90 @@
 #    nox -s update_constraints
 annotated-types==0.7.0
    # via pydantic
-anyio==4.10.0
-    # via httpx
-auditwheel-emscripten==0.2.0
+auditwheel-emscripten==0.2.5
    # via pyodide-build
-build==1.2.2.post1
+build==1.5.0
    # via
    #   -r .nox/update_constraints/tmp/constraints-pyodide.in
    #   pyodide-build
-certifi==2025.8.3
-    # via
-    #   httpcore
-    #   httpx
-    #   requests
-charset-normalizer==3.4.3
+certifi==2026.5.20
+    # via requests
+charset-normalizer==3.4.7
    # via requests
 click==8.1.8
    # via
    #   -r .nox/update_constraints/tmp/constraints-pyodide.in
-    #   typer
-distlib==0.4.0
+    #   pyodide-build
+    #   pyodide-cli
+distlib==0.4.1
    # via virtualenv
-filelock==3.19.1
-    # via virtualenv
-h11==0.16.0
-    # via httpcore
-httpcore==1.0.9
-    # via httpx
-httpx==0.28.1
-    # via unearth
-idna==3.10
+filelock==3.29.1
    # via
-    #   anyio
-    #   httpx
-    #   requests
-leb128==1.0.8
+    #   python-discovery
+    #   virtualenv
+idna==3.18
+    # via requests
+leb128==1.0.9
    # via auditwheel-emscripten
-markdown-it-py==4.0.0
+markdown-it-py==4.2.0
    # via rich
 mdurl==0.1.2
    # via markdown-it-py
-packaging==25.0
+packaging==26.2
    # via
    #   auditwheel-emscripten
    #   build
    #   pyodide-build
-    #   unearth
-pip==25.2
+    #   wheel
+pip==26.1.2
    # via -r .nox/update_constraints/tmp/constraints-pyodide.in
-platformdirs==4.3.8
+platformdirs==4.10.0
    # via
    #   pyodide-build
+    #   python-discovery
    #   virtualenv
-pydantic==2.11.7
+pydantic==2.13.4
    # via
    #   pyodide-build
    #   pyodide-lock
-pydantic-core==2.33.2
+pydantic-core==2.46.4
    # via pydantic
-pygments==2.19.2
+pygments==2.20.0
    # via rich
-pyodide-build==0.30.7
+pyodide-build==0.34.4
    # via -r .nox/update_constraints/tmp/constraints-pyodide.in
-pyodide-cli==0.3.0
+pyodide-cli==0.5.0
    # via
    #   auditwheel-emscripten
    #   pyodide-build
-pyodide-lock==0.1.0
+pyodide-lock==0.1.3
    # via pyodide-build
 pyproject-hooks==1.2.0
    # via build
-requests==2.32.4
+python-discovery==1.4.0
+    # via virtualenv
+requests==2.34.2
    # via pyodide-build
-resolvelib==1.2.0
-    # via pyodide-build
-rich==14.1.0
+rich==15.0.0
    # via
    #   pyodide-build
    #   pyodide-cli
-    #   typer
-ruamel-yaml==0.18.14
+ruamel-yaml==0.19.1
    # via pyodide-build
-ruamel-yaml-clib==0.2.12
-    # via ruamel-yaml
-shellingham==1.5.4
-    # via typer
-sniffio==1.3.1
-    # via anyio
-typer==0.16.0
+typing-extensions==4.15.0
    # via
-    #   auditwheel-emscripten
-    #   pyodide-build
-    #   pyodide-cli
-typing-extensions==4.14.1
-    # via
-    #   anyio
    #   pydantic
    #   pydantic-core
-    #   typer
    #   typing-inspection
-typing-inspection==0.4.1
+typing-inspection==0.4.2
    # via pydantic
-unearth==0.17.5
-    # via pyodide-build
-urllib3==2.5.0
+urllib3==2.7.0
    # via requests
-virtualenv==20.34.0
+virtualenv==21.4.2
    # via
    #   build
    #   pyodide-build
-wheel==0.45.1
+wheel==0.47.0
    # via
    #   auditwheel-emscripten
    #   pyodide-build
@@ -2,115 +2,90 @@
 #    nox -s update_constraints
 annotated-types==0.7.0
    # via pydantic
-anyio==4.10.0
-    # via httpx
-auditwheel-emscripten==0.2.0
+auditwheel-emscripten==0.2.5
    # via pyodide-build
-build==1.2.2.post1
+build==1.5.0
    # via
    #   -r .nox/update_constraints/tmp/constraints-pyodide.in
    #   pyodide-build
-certifi==2025.8.3
-    # via
-    #   httpcore
-    #   httpx
-    #   requests
-charset-normalizer==3.4.3
+certifi==2026.5.20
+    # via requests
+charset-normalizer==3.4.7
    # via requests
 click==8.1.8
    # via
    #   -r .nox/update_constraints/tmp/constraints-pyodide.in
-    #   typer
-distlib==0.4.0
+    #   pyodide-build
+    #   pyodide-cli
+distlib==0.4.1
    # via virtualenv
-filelock==3.19.1
-    # via virtualenv
-h11==0.16.0
-    # via httpcore
-httpcore==1.0.9
-    # via httpx
-httpx==0.28.1
-    # via unearth
-idna==3.10
+filelock==3.29.1
    # via
-    #   anyio
-    #   httpx
-    #   requests
-leb128==1.0.8
+    #   python-discovery
+    #   virtualenv
+idna==3.18
+    # via requests
+leb128==1.0.9
    # via auditwheel-emscripten
-markdown-it-py==4.0.0
+markdown-it-py==4.2.0
    # via rich
 mdurl==0.1.2
    # via markdown-it-py
-packaging==25.0
+packaging==26.2
    # via
    #   auditwheel-emscripten
    #   build
    #   pyodide-build
-    #   unearth
-pip==25.2
+    #   wheel
+pip==26.1.2
    # via -r .nox/update_constraints/tmp/constraints-pyodide.in
-platformdirs==4.3.8
+platformdirs==4.10.0
    # via
    #   pyodide-build
+    #   python-discovery
    #   virtualenv
-pydantic==2.11.7
+pydantic==2.13.4
    # via
    #   pyodide-build
    #   pyodide-lock
-pydantic-core==2.33.2
+pydantic-core==2.46.4
    # via pydantic
-pygments==2.19.2
+pygments==2.20.0
    # via rich
-pyodide-build==0.30.7
+pyodide-build==0.34.4
    # via -r .nox/update_constraints/tmp/constraints-pyodide.in
-pyodide-cli==0.3.0
+pyodide-cli==0.5.0
    # via
    #   auditwheel-emscripten
    #   pyodide-build
-pyodide-lock==0.1.0
+pyodide-lock==0.1.3
    # via pyodide-build
 pyproject-hooks==1.2.0
    # via build
-requests==2.32.4
+python-discovery==1.4.0
+    # via virtualenv
+requests==2.34.2
    # via pyodide-build
-resolvelib==1.2.0
-    # via pyodide-build
-rich==14.1.0
+rich==15.0.0
    # via
    #   pyodide-build
    #   pyodide-cli
-    #   typer
-ruamel-yaml==0.18.14
+ruamel-yaml==0.19.1
    # via pyodide-build
-ruamel-yaml-clib==0.2.12
-    # via ruamel-yaml
-shellingham==1.5.4
-    # via typer
-sniffio==1.3.1
-    # via anyio
-typer==0.16.0
-    # via
-    #   auditwheel-emscripten
-    #   pyodide-build
-    #   pyodide-cli
-typing-extensions==4.14.1
+typing-extensions==4.15.0
    # via
    #   pydantic
    #   pydantic-core
-    #   typer
    #   typing-inspection
-typing-inspection==0.4.1
+typing-inspection==0.4.2
    # via pydantic
-unearth==0.17.5
-    # via pyodide-build
-urllib3==2.5.0
+urllib3==2.7.0
    # via requests
-virtualenv==20.34.0
+virtualenv==21.4.2
    # via
    #   build
    #   pyodide-build
-wheel==0.45.1
+wheel==0.47.0
    # via
    #   auditwheel-emscripten
    #   pyodide-build
@@ -0,0 +1,91 @@
+# This file was autogenerated by uv via the following command:
+#    nox -s update_constraints
+annotated-types==0.7.0
+    # via pydantic
+auditwheel-emscripten==0.2.5
+    # via pyodide-build
+build==1.5.0
+    # via
+    #   -r .nox/update_constraints/tmp/constraints-pyodide.in
+    #   pyodide-build
+certifi==2026.5.20
+    # via requests
+charset-normalizer==3.4.7
+    # via requests
+click==8.1.8
+    # via
+    #   -r .nox/update_constraints/tmp/constraints-pyodide.in
+    #   pyodide-build
+    #   pyodide-cli
+distlib==0.4.1
+    # via virtualenv
+filelock==3.29.1
+    # via
+    #   python-discovery
+    #   virtualenv
+idna==3.18
+    # via requests
+leb128==1.0.9
+    # via auditwheel-emscripten
+markdown-it-py==4.2.0
+    # via rich
+mdurl==0.1.2
+    # via markdown-it-py
+packaging==26.2
+    # via
+    #   auditwheel-emscripten
+    #   build
+    #   pyodide-build
+    #   wheel
+pip==26.1.2
+    # via -r .nox/update_constraints/tmp/constraints-pyodide.in
+platformdirs==4.10.0
+    # via
+    #   pyodide-build
+    #   python-discovery
+    #   virtualenv
+pydantic==2.13.4
+    # via
+    #   pyodide-build
+    #   pyodide-lock
+pydantic-core==2.46.4
+    # via pydantic
+pygments==2.20.0
+    # via rich
+pyodide-build==0.34.4
+    # via -r .nox/update_constraints/tmp/constraints-pyodide.in
+pyodide-cli==0.5.0
+    # via
+    #   auditwheel-emscripten
+    #   pyodide-build
+pyodide-lock==0.1.3
+    # via pyodide-build
+pyproject-hooks==1.2.0
+    # via build
+python-discovery==1.4.0
+    # via virtualenv
+requests==2.34.2
+    # via pyodide-build
+rich==15.0.0
+    # via
+    #   pyodide-build
+    #   pyodide-cli
+ruamel-yaml==0.19.1
+    # via pyodide-build
+typing-extensions==4.15.0
+    # via
+    #   pydantic
+    #   pydantic-core
+    #   typing-inspection
+typing-inspection==0.4.2
+    # via pydantic
+urllib3==2.7.0
+    # via requests
+virtualenv==21.4.2
+    # via
+    #   build
+    #   pyodide-build
+wheel==0.47.0
+    # via
+    #   auditwheel-emscripten
+    #   pyodide-build
@@ -1,36 +1,105 @@
 # This file was autogenerated by uv via the following command:
 #    nox -s update_constraints
-altgraph==0.17.4
-    # via macholib
-build==1.3.0
+abi3audit==0.0.26
    # via -r cibuildwheel/resources/constraints.in
+abi3info==2025.11.29
+    # via abi3audit
+altgraph==0.17.5
+    # via macholib
+attrs==26.1.0
+    # via
+    #   cattrs
+    #   requests-cache
+auditwheel==6.7.0
+    # via -r cibuildwheel/resources/constraints.in
+build==1.5.0
+    # via -r cibuildwheel/resources/constraints.in
+cattrs==26.1.0
+    # via requests-cache
+certifi==2026.5.20
+    # via requests
+charset-normalizer==3.4.7
+    # via requests
 delocate==0.13.0
    # via -r cibuildwheel/resources/constraints.in
-distlib==0.4.0
+delvewheel==1.13.0
+    # via -r cibuildwheel/resources/constraints.in
+distlib==0.4.1
    # via virtualenv
-filelock==3.19.1
-    # via virtualenv
-importlib-metadata==8.7.0
-    # via build
-macholib==1.16.3
-    # via delocate
-packaging==25.0
+exceptiongroup==1.3.1
+    # via cattrs
+filelock==3.29.1
    # via
+    #   python-discovery
+    #   virtualenv
+idna==3.18
+    # via
+    #   requests
+    #   url-normalize
+importlib-metadata==9.0.0
+    # via build
+kaitaistruct==0.11
+    # via abi3audit
+macholib==1.16.4
+    # via delocate
+markdown-it-py==4.2.0
+    # via rich
+mdurl==0.1.2
+    # via markdown-it-py
+packaging==26.2
+    # via
+    #   abi3audit
+    #   auditwheel
    #   build
    #   delocate
-pip==25.2
+patchelf==0.17.2.4
    # via -r cibuildwheel/resources/constraints.in
-platformdirs==4.3.8
-    # via virtualenv
+pefile==2024.8.26
+    # via
+    #   abi3audit
+    #   delvewheel
+pip==26.1.2
+    # via -r cibuildwheel/resources/constraints.in
+pkgconf==2.5.1.post2
+    # via -r cibuildwheel/resources/constraints.in
+platformdirs==4.10.0
+    # via
+    #   python-discovery
+    #   requests-cache
+    #   virtualenv
+pyelftools==0.33
+    # via
+    #   abi3audit
+    #   auditwheel
+pygments==2.20.0
+    # via rich
 pyproject-hooks==1.2.0
    # via build
-tomli==2.2.1
-    # via build
-typing-extensions==4.14.1
+python-discovery==1.4.0
+    # via virtualenv
+requests==2.34.2
    # via
+    #   abi3audit
+    #   requests-cache
+requests-cache==1.3.2
+    # via abi3audit
+rich==15.0.0
+    # via abi3audit
+tomli==2.4.1
+    # via build
+typing-extensions==4.15.0
+    # via
+    #   cattrs
    #   delocate
+    #   exceptiongroup
    #   virtualenv
-virtualenv==20.34.0
+url-normalize==3.0.0
+    # via requests-cache
+urllib3==2.7.0
+    # via
+    #   requests
+    #   requests-cache
+virtualenv==21.4.2
    # via -r cibuildwheel/resources/constraints.in
-zipp==3.23.0
+zipp==4.1.0
    # via importlib-metadata
@@ -1,28 +1,96 @@
 # This file was autogenerated by uv via the following command:
 #    nox -s update_constraints
-altgraph==0.17.4
-    # via macholib
-build==1.3.0
+abi3audit==0.0.26
    # via -r cibuildwheel/resources/constraints.in
+abi3info==2025.11.29
+    # via abi3audit
+altgraph==0.17.5
+    # via macholib
+attrs==26.1.0
+    # via
+    #   cattrs
+    #   requests-cache
+auditwheel==6.7.0
+    # via -r cibuildwheel/resources/constraints.in
+build==1.5.0
+    # via -r cibuildwheel/resources/constraints.in
+cattrs==26.1.0
+    # via requests-cache
+certifi==2026.5.20
+    # via requests
+charset-normalizer==3.4.7
+    # via requests
 delocate==0.13.0
    # via -r cibuildwheel/resources/constraints.in
-distlib==0.4.0
+delvewheel==1.13.0
+    # via -r cibuildwheel/resources/constraints.in
+distlib==0.4.1
    # via virtualenv
-filelock==3.19.1
-    # via virtualenv
-macholib==1.16.3
-    # via delocate
-packaging==25.0
+filelock==3.29.1
    # via
+    #   python-discovery
+    #   virtualenv
+idna==3.18
+    # via
+    #   requests
+    #   url-normalize
+kaitaistruct==0.11
+    # via abi3audit
+macholib==1.16.4
+    # via delocate
+markdown-it-py==4.2.0
+    # via rich
+mdurl==0.1.2
+    # via markdown-it-py
+packaging==26.2
+    # via
+    #   abi3audit
+    #   auditwheel
    #   build
    #   delocate
-pip==25.2
+patchelf==0.17.2.4
    # via -r cibuildwheel/resources/constraints.in
-platformdirs==4.3.8
-    # via virtualenv
+pefile==2024.8.26
+    # via
+    #   abi3audit
+    #   delvewheel
+pip==26.1.2; implementation_name != "graalpy" or platform_system != "Windows"
+pip==26.0.1; implementation_name == "graalpy" and platform_system == "Windows"
+    # via -r cibuildwheel/resources/constraints.in
+pkgconf==2.5.1.post2
+    # via -r cibuildwheel/resources/constraints.in
+platformdirs==4.10.0
+    # via
+    #   python-discovery
+    #   requests-cache
+    #   virtualenv
+pyelftools==0.33
+    # via
+    #   abi3audit
+    #   auditwheel
+pygments==2.20.0
+    # via rich
 pyproject-hooks==1.2.0
    # via build
-typing-extensions==4.14.1
-    # via delocate
-virtualenv==20.34.0
+python-discovery==1.4.0
+    # via virtualenv
+requests==2.34.2
+    # via
+    #   abi3audit
+    #   requests-cache
+requests-cache==1.3.2
+    # via abi3audit
+rich==15.0.0
+    # via abi3audit
+typing-extensions==4.15.0
+    # via
+    #   cattrs
+    #   delocate
+url-normalize==3.0.0
+    # via requests-cache
+urllib3==2.7.0
+    # via
+    #   requests
+    #   requests-cache
+virtualenv==21.4.2
    # via -r cibuildwheel/resources/constraints.in
@@ -1,28 +1,96 @@
 # This file was autogenerated by uv via the following command:
 #    nox -s update_constraints
-altgraph==0.17.4
-    # via macholib
-build==1.3.0
+abi3audit==0.0.26
    # via -r cibuildwheel/resources/constraints.in
+abi3info==2025.11.29
+    # via abi3audit
+altgraph==0.17.5
+    # via macholib
+attrs==26.1.0
+    # via
+    #   cattrs
+    #   requests-cache
+auditwheel==6.7.0
+    # via -r cibuildwheel/resources/constraints.in
+build==1.5.0
+    # via -r cibuildwheel/resources/constraints.in
+cattrs==26.1.0
+    # via requests-cache
+certifi==2026.5.20
+    # via requests
+charset-normalizer==3.4.7
+    # via requests
 delocate==0.13.0
    # via -r cibuildwheel/resources/constraints.in
-distlib==0.4.0
+delvewheel==1.13.0
+    # via -r cibuildwheel/resources/constraints.in
+distlib==0.4.1
    # via virtualenv
-filelock==3.19.1
-    # via virtualenv
-macholib==1.16.3
-    # via delocate
-packaging==25.0
+filelock==3.29.1
    # via
+    #   python-discovery
+    #   virtualenv
+idna==3.18
+    # via
+    #   requests
+    #   url-normalize
+kaitaistruct==0.11
+    # via abi3audit
+macholib==1.16.4
+    # via delocate
+markdown-it-py==4.2.0
+    # via rich
+mdurl==0.1.2
+    # via markdown-it-py
+packaging==26.2
+    # via
+    #   abi3audit
+    #   auditwheel
    #   build
    #   delocate
-pip==25.2
+patchelf==0.17.2.4
    # via -r cibuildwheel/resources/constraints.in
-platformdirs==4.3.8
-    # via virtualenv
+pefile==2024.8.26
+    # via
+    #   abi3audit
+    #   delvewheel
+pip==26.1.2; implementation_name != "graalpy" or platform_system != "Windows"
+pip==26.0.1; implementation_name == "graalpy" and platform_system == "Windows"
+    # via -r cibuildwheel/resources/constraints.in
+pkgconf==2.5.1.post2
+    # via -r cibuildwheel/resources/constraints.in
+platformdirs==4.10.0
+    # via
+    #   python-discovery
+    #   requests-cache
+    #   virtualenv
+pyelftools==0.33
+    # via
+    #   abi3audit
+    #   auditwheel
+pygments==2.20.0
+    # via rich
 pyproject-hooks==1.2.0
    # via build
-typing-extensions==4.14.1
-    # via delocate
-virtualenv==20.34.0
+python-discovery==1.4.0
+    # via virtualenv
+requests==2.34.2
+    # via
+    #   abi3audit
+    #   requests-cache
+requests-cache==1.3.2
+    # via abi3audit
+rich==15.0.0
+    # via abi3audit
+typing-extensions==4.15.0
+    # via
+    #   cattrs
+    #   delocate
+url-normalize==3.0.0
+    # via requests-cache
+urllib3==2.7.0
+    # via
+    #   requests
+    #   requests-cache
+virtualenv==21.4.2
    # via -r cibuildwheel/resources/constraints.in
@@ -1,28 +1,95 @@
 # This file was autogenerated by uv via the following command:
 #    nox -s update_constraints
-altgraph==0.17.4
-    # via macholib
-build==1.3.0
+abi3audit==0.0.26
    # via -r cibuildwheel/resources/constraints.in
+abi3info==2025.11.29
+    # via abi3audit
+altgraph==0.17.5
+    # via macholib
+attrs==26.1.0
+    # via
+    #   cattrs
+    #   requests-cache
+auditwheel==6.7.0
+    # via -r cibuildwheel/resources/constraints.in
+build==1.5.0
+    # via -r cibuildwheel/resources/constraints.in
+cattrs==26.1.0
+    # via requests-cache
+certifi==2026.5.20
+    # via requests
+charset-normalizer==3.4.7
+    # via requests
 delocate==0.13.0
    # via -r cibuildwheel/resources/constraints.in
-distlib==0.4.0
+delvewheel==1.13.0
+    # via -r cibuildwheel/resources/constraints.in
+distlib==0.4.1
    # via virtualenv
-filelock==3.19.1
-    # via virtualenv
-macholib==1.16.3
-    # via delocate
-packaging==25.0
+filelock==3.29.1
    # via
+    #   python-discovery
+    #   virtualenv
+idna==3.18
+    # via
+    #   requests
+    #   url-normalize
+kaitaistruct==0.11
+    # via abi3audit
+macholib==1.16.4
+    # via delocate
+markdown-it-py==4.2.0
+    # via rich
+mdurl==0.1.2
+    # via markdown-it-py
+packaging==26.2
+    # via
+    #   abi3audit
+    #   auditwheel
    #   build
    #   delocate
-pip==25.2
+patchelf==0.17.2.4
    # via -r cibuildwheel/resources/constraints.in
-platformdirs==4.3.8
-    # via virtualenv
+pefile==2024.8.26
+    # via
+    #   abi3audit
+    #   delvewheel
+pip==26.1.2
+    # via -r cibuildwheel/resources/constraints.in
+pkgconf==2.5.1.post2
+    # via -r cibuildwheel/resources/constraints.in
+platformdirs==4.10.0
+    # via
+    #   python-discovery
+    #   requests-cache
+    #   virtualenv
+pyelftools==0.33
+    # via
+    #   abi3audit
+    #   auditwheel
+pygments==2.20.0
+    # via rich
 pyproject-hooks==1.2.0
    # via build
-typing-extensions==4.14.1
-    # via delocate
-virtualenv==20.34.0
+python-discovery==1.4.0
+    # via virtualenv
+requests==2.34.2
+    # via
+    #   abi3audit
+    #   requests-cache
+requests-cache==1.3.2
+    # via abi3audit
+rich==15.0.0
+    # via abi3audit
+typing-extensions==4.15.0
+    # via
+    #   cattrs
+    #   delocate
+url-normalize==3.0.0
+    # via requests-cache
+urllib3==2.7.0
+    # via
+    #   requests
+    #   requests-cache
+virtualenv==21.4.2
    # via -r cibuildwheel/resources/constraints.in
@@ -1,28 +1,95 @@
 # This file was autogenerated by uv via the following command:
 #    nox -s update_constraints
-altgraph==0.17.4
-    # via macholib
-build==1.3.0
+abi3audit==0.0.26
    # via -r cibuildwheel/resources/constraints.in
+abi3info==2025.11.29
+    # via abi3audit
+altgraph==0.17.5
+    # via macholib
+attrs==26.1.0
+    # via
+    #   cattrs
+    #   requests-cache
+auditwheel==6.7.0
+    # via -r cibuildwheel/resources/constraints.in
+build==1.5.0
+    # via -r cibuildwheel/resources/constraints.in
+cattrs==26.1.0
+    # via requests-cache
+certifi==2026.5.20
+    # via requests
+charset-normalizer==3.4.7
+    # via requests
 delocate==0.13.0
    # via -r cibuildwheel/resources/constraints.in
-distlib==0.4.0
+delvewheel==1.13.0
+    # via -r cibuildwheel/resources/constraints.in
+distlib==0.4.1
    # via virtualenv
-filelock==3.19.1
-    # via virtualenv
-macholib==1.16.3
-    # via delocate
-packaging==25.0
+filelock==3.29.1
    # via
+    #   python-discovery
+    #   virtualenv
+idna==3.18
+    # via
+    #   requests
+    #   url-normalize
+kaitaistruct==0.11
+    # via abi3audit
+macholib==1.16.4
+    # via delocate
+markdown-it-py==4.2.0
+    # via rich
+mdurl==0.1.2
+    # via markdown-it-py
+packaging==26.2
+    # via
+    #   abi3audit
+    #   auditwheel
    #   build
    #   delocate
-pip==25.2
+patchelf==0.17.2.4
    # via -r cibuildwheel/resources/constraints.in
-platformdirs==4.3.8
-    # via virtualenv
+pefile==2024.8.26
+    # via
+    #   abi3audit
+    #   delvewheel
+pip==26.1.2
+    # via -r cibuildwheel/resources/constraints.in
+pkgconf==2.5.1.post2
+    # via -r cibuildwheel/resources/constraints.in
+platformdirs==4.10.0
+    # via
+    #   python-discovery
+    #   requests-cache
+    #   virtualenv
+pyelftools==0.33
+    # via
+    #   abi3audit
+    #   auditwheel
+pygments==2.20.0
+    # via rich
 pyproject-hooks==1.2.0
    # via build
-typing-extensions==4.14.1
-    # via delocate
-virtualenv==20.34.0
+python-discovery==1.4.0
+    # via virtualenv
+requests==2.34.2
+    # via
+    #   abi3audit
+    #   requests-cache
+requests-cache==1.3.2
+    # via abi3audit
+rich==15.0.0
+    # via abi3audit
+typing-extensions==4.15.0
+    # via
+    #   cattrs
+    #   delocate
+url-normalize==3.0.0
+    # via requests-cache
+urllib3==2.7.0
+    # via
+    #   requests
+    #   requests-cache
+virtualenv==21.4.2
    # via -r cibuildwheel/resources/constraints.in
@@ -0,0 +1,95 @@
+# This file was autogenerated by uv via the following command:
+#    nox -s update_constraints
+abi3audit==0.0.26
+    # via -r cibuildwheel/resources/constraints.in
+abi3info==2025.11.29
+    # via abi3audit
+altgraph==0.17.5
+    # via macholib
+attrs==26.1.0
+    # via
+    #   cattrs
+    #   requests-cache
+auditwheel==6.7.0
+    # via -r cibuildwheel/resources/constraints.in
+build==1.5.0
+    # via -r cibuildwheel/resources/constraints.in
+cattrs==26.1.0
+    # via requests-cache
+certifi==2026.5.20
+    # via requests
+charset-normalizer==3.4.7
+    # via requests
+delocate==0.13.0
+    # via -r cibuildwheel/resources/constraints.in
+delvewheel==1.13.0
+    # via -r cibuildwheel/resources/constraints.in
+distlib==0.4.1
+    # via virtualenv
+filelock==3.29.1
+    # via
+    #   python-discovery
+    #   virtualenv
+idna==3.18
+    # via
+    #   requests
+    #   url-normalize
+kaitaistruct==0.11
+    # via abi3audit
+macholib==1.16.4
+    # via delocate
+markdown-it-py==4.2.0
+    # via rich
+mdurl==0.1.2
+    # via markdown-it-py
+packaging==26.2
+    # via
+    #   abi3audit
+    #   auditwheel
+    #   build
+    #   delocate
+patchelf==0.17.2.4
+    # via -r cibuildwheel/resources/constraints.in
+pefile==2024.8.26
+    # via
+    #   abi3audit
+    #   delvewheel
+pip==26.1.2
+    # via -r cibuildwheel/resources/constraints.in
+pkgconf==2.5.1.post2
+    # via -r cibuildwheel/resources/constraints.in
+platformdirs==4.10.0
+    # via
+    #   python-discovery
+    #   requests-cache
+    #   virtualenv
+pyelftools==0.33
+    # via
+    #   abi3audit
+    #   auditwheel
+pygments==2.20.0
+    # via rich
+pyproject-hooks==1.2.0
+    # via build
+python-discovery==1.4.0
+    # via virtualenv
+requests==2.34.2
+    # via
+    #   abi3audit
+    #   requests-cache
+requests-cache==1.3.2
+    # via abi3audit
+rich==15.0.0
+    # via abi3audit
+typing-extensions==4.15.0
+    # via
+    #   cattrs
+    #   delocate
+url-normalize==3.0.0
+    # via requests-cache
+urllib3==2.7.0
+    # via
+    #   requests
+    #   requests-cache
+virtualenv==21.4.2
+    # via -r cibuildwheel/resources/constraints.in
@@ -1,36 +0,0 @@
-# This file was autogenerated by uv via the following command:
-#    nox -s update_constraints
-altgraph==0.17.4
-    # via macholib
-build==1.2.2.post1
-    # via -r cibuildwheel/resources/constraints.in
-delocate==0.12.0
-    # via -r cibuildwheel/resources/constraints.in
-distlib==0.4.0
-    # via virtualenv
-filelock==3.16.1
-    # via virtualenv
-importlib-metadata==8.5.0
-    # via build
-macholib==1.16.3
-    # via delocate
-packaging==25.0
-    # via
-    #   build
-    #   delocate
-pip==25.0.1
-    # via -r cibuildwheel/resources/constraints.in
-platformdirs==4.3.6
-    # via virtualenv
-pyproject-hooks==1.2.0
-    # via build
-tomli==2.2.1
-    # via build
-typing-extensions==4.13.2
-    # via
-    #   delocate
-    #   virtualenv
-virtualenv==20.34.0
-    # via -r cibuildwheel/resources/constraints.in
-zipp==3.20.2
-    # via importlib-metadata
@@ -1,36 +1,107 @@
 # This file was autogenerated by uv via the following command:
 #    nox -s update_constraints
-altgraph==0.17.4
-    # via macholib
-build==1.3.0
+abi3audit==0.0.25
    # via -r cibuildwheel/resources/constraints.in
+abi3info==2025.4.29
+    # via abi3audit
+altgraph==0.17.5
+    # via macholib
+attrs==26.1.0
+    # via
+    #   cattrs
+    #   requests-cache
+auditwheel==6.4.2
+    # via -r cibuildwheel/resources/constraints.in
+build==1.4.4
+    # via -r cibuildwheel/resources/constraints.in
+cattrs==25.3.0
+    # via requests-cache
+certifi==2026.5.20
+    # via requests
+charset-normalizer==3.4.7
+    # via requests
 delocate==0.13.0
    # via -r cibuildwheel/resources/constraints.in
-distlib==0.4.0
+delvewheel==1.13.0
+    # via -r cibuildwheel/resources/constraints.in
+distlib==0.4.1
    # via virtualenv
+exceptiongroup==1.3.1
+    # via cattrs
 filelock==3.19.1
-    # via virtualenv
-importlib-metadata==8.7.0
-    # via build
-macholib==1.16.3
-    # via delocate
-packaging==25.0
+    # via
+    #   python-discovery
+    #   virtualenv
+idna==3.18
+    # via
+    #   requests
+    #   url-normalize
+importlib-metadata==8.7.1
    # via
    #   build
+    #   pkgconf
+kaitaistruct==0.11
+    # via abi3audit
+macholib==1.16.4
+    # via delocate
+markdown-it-py==3.0.0
+    # via rich
+mdurl==0.1.2
+    # via markdown-it-py
+packaging==25.0
+    # via
+    #   abi3audit
+    #   auditwheel
+    #   build
    #   delocate
-pip==25.2
+patchelf==0.17.2.4
    # via -r cibuildwheel/resources/constraints.in
-platformdirs==4.3.8
-    # via virtualenv
+pefile==2024.8.26
+    # via
+    #   abi3audit
+    #   delvewheel
+pip==26.0.1
+    # via -r cibuildwheel/resources/constraints.in
+pkgconf==2.4.3.post2
+    # via -r cibuildwheel/resources/constraints.in
+platformdirs==4.4.0
+    # via
+    #   python-discovery
+    #   requests-cache
+    #   virtualenv
+pyelftools==0.32
+    # via
+    #   abi3audit
+    #   auditwheel
+pygments==2.20.0
+    # via rich
 pyproject-hooks==1.2.0
    # via build
-tomli==2.2.1
-    # via build
-typing-extensions==4.14.1
+python-discovery==1.4.0
+    # via virtualenv
+requests==2.32.5
    # via
+    #   abi3audit
+    #   requests-cache
+requests-cache==1.2.1
+    # via abi3audit
+rich==14.2.0
+    # via abi3audit
+tomli==2.4.1
+    # via build
+typing-extensions==4.15.0
+    # via
+    #   cattrs
    #   delocate
+    #   exceptiongroup
    #   virtualenv
-virtualenv==20.34.0
+url-normalize==2.2.1
+    # via requests-cache
+urllib3==2.6.3
+    # via
+    #   requests
+    #   requests-cache
+virtualenv==21.4.2
    # via -r cibuildwheel/resources/constraints.in
-zipp==3.23.0
+zipp==3.23.1
    # via importlib-metadata
@@ -1,4 +1,11 @@
 pip
 build
 delocate
+delvewheel
 virtualenv
+abi3audit
+
+# Android
+auditwheel
+patchelf
+pkgconf
@@ -1,28 +1,95 @@
 # This file was autogenerated by uv via the following command:
 #    nox -s update_constraints
-altgraph==0.17.4
-    # via macholib
-build==1.3.0
+abi3audit==0.0.26
    # via -r cibuildwheel/resources/constraints.in
+abi3info==2025.11.29
+    # via abi3audit
+altgraph==0.17.5
+    # via macholib
+attrs==26.1.0
+    # via
+    #   cattrs
+    #   requests-cache
+auditwheel==6.7.0
+    # via -r cibuildwheel/resources/constraints.in
+build==1.5.0
+    # via -r cibuildwheel/resources/constraints.in
+cattrs==26.1.0
+    # via requests-cache
+certifi==2026.5.20
+    # via requests
+charset-normalizer==3.4.7
+    # via requests
 delocate==0.13.0
    # via -r cibuildwheel/resources/constraints.in
-distlib==0.4.0
+delvewheel==1.13.0
+    # via -r cibuildwheel/resources/constraints.in
+distlib==0.4.1
    # via virtualenv
-filelock==3.19.1
-    # via virtualenv
-macholib==1.16.3
-    # via delocate
-packaging==25.0
+filelock==3.29.1
    # via
+    #   python-discovery
+    #   virtualenv
+idna==3.18
+    # via
+    #   requests
+    #   url-normalize
+kaitaistruct==0.11
+    # via abi3audit
+macholib==1.16.4
+    # via delocate
+markdown-it-py==4.2.0
+    # via rich
+mdurl==0.1.2
+    # via markdown-it-py
+packaging==26.2
+    # via
+    #   abi3audit
+    #   auditwheel
    #   build
    #   delocate
-pip==25.2
+patchelf==0.17.2.4
    # via -r cibuildwheel/resources/constraints.in
-platformdirs==4.3.8
-    # via virtualenv
+pefile==2024.8.26
+    # via
+    #   abi3audit
+    #   delvewheel
+pip==26.1.2
+    # via -r cibuildwheel/resources/constraints.in
+pkgconf==2.5.1.post2
+    # via -r cibuildwheel/resources/constraints.in
+platformdirs==4.10.0
+    # via
+    #   python-discovery
+    #   requests-cache
+    #   virtualenv
+pyelftools==0.33
+    # via
+    #   abi3audit
+    #   auditwheel
+pygments==2.20.0
+    # via rich
 pyproject-hooks==1.2.0
    # via build
-typing-extensions==4.14.1
-    # via delocate
-virtualenv==20.34.0
+python-discovery==1.4.0
+    # via virtualenv
+requests==2.34.2
+    # via
+    #   abi3audit
+    #   requests-cache
+requests-cache==1.3.2
+    # via abi3audit
+rich==15.0.0
+    # via abi3audit
+typing-extensions==4.15.0
+    # via
+    #   cattrs
+    #   delocate
+url-normalize==3.0.0
+    # via requests-cache
+urllib3==2.7.0
+    # via
+    #   requests
+    #   requests-cache
+virtualenv==21.4.2
    # via -r cibuildwheel/resources/constraints.in
@@ -1,3 +1,6 @@
+# These are the defaults used by cibuildwheel itself. They should match the values in
+# generate_schema.py, which are used by external tools for validation and IDE support.
+
 [tool.cibuildwheel]
 build = "*"
 skip = ""
@@ -5,6 +8,8 @@ test-skip = ""
 enable = []

 archs = ["auto"]
+audit-requires = ["abi3audit"]
+audit-command = "abi3audit --strict --report {abi3_wheel}"
 build-frontend = "default"
 config-settings = {}
 dependency-versions = "pinned"
@@ -25,6 +30,7 @@ test-requires = []
 test-extras = []
 test-groups = []
 test-environment = {}
+test-runtime = {}

 container-engine = "docker"

@@ -49,6 +55,13 @@ musllinux-s390x-image = "musllinux_1_2"
 musllinux-armv7l-image = "musllinux_1_2"
 musllinux-riscv64-image = "musllinux_1_2"

+[tool.cibuildwheel.xbuild-files]
+numpy = [
+    "numpy/_core/include/numpy/_numpyconfig.h",
+    "numpy/_core/include/numpy/numpyconfig.h",
+    "numpy/_core/lib/libnpymath.a",
+    "numpy/random/lib/libnpyrandom.a",
+]

 [tool.cibuildwheel.linux]
 repair-wheel-command = "auditwheel repair -w {dest_dir} {wheel}"
@@ -57,9 +70,12 @@ repair-wheel-command = "auditwheel repair -w {dest_dir} {wheel}"
 repair-wheel-command = "delocate-wheel --require-archs {delocate_archs} -w {dest_dir} -v {wheel}"

 [tool.cibuildwheel.windows]
+repair-wheel-command = "delvewheel repair -w {dest_dir} -v {wheel}"

 [tool.cibuildwheel.android]
+repair-wheel-command = "auditwheel repair --ldpaths {ldpaths} -w {dest_dir} {wheel}"

 [tool.cibuildwheel.ios]

 [tool.cibuildwheel.pyodide]
+audit-command = ""
@@ -8,7 +8,7 @@
                <key>choiceAttribute</key>
                <string>selected</string>
                <key>choiceIdentifier</key>
-                <string>org.python.Python.PythonTFramework-3.13</string>
+                <string>org.python.Python.PythonTFramework-3.15</string>
        </dict>
 </array>
 </plist>
@@ -0,0 +1,103 @@
+import shutil
+import sys
+import sysconfig
+from pathlib import Path
+
+SITE_PACKAGE_PATH = Path(__file__).parent
+
+###########################################################################
+# importlib module patches
+###########################################################################
+
+
+def patch_env_create(env):
+    """
+    Patch the process of creating virtual environments to ensure that the cross
+    environment modification files are also copied as part of environment
+    creation.
+    """
+    old_pip_env_create = env._PipBackend.create
+
+    def pip_env_create(self, path, *args, **kwargs):
+        result = old_pip_env_create(self, path, *args, **kwargs)
+        # Copy any _cross_*.pth or _cross_*.py file, plus the cross-platform
+        # sysconfigdata module and sysconfig_vars JSON to the new environment.
+        data_name = sysconfig._get_sysconfigdata_name()
+        json_name = data_name.replace("_sysconfigdata", "_sysconfig_vars")
+        for filename in [
+            "_cross_venv.pth",
+            "_cross_venv.py",
+            f"_cross_{sys.implementation._multiarch.replace('-', '_')}.py",
+            f"{data_name}.py",
+            f"{json_name}.json",
+        ]:
+            src = SITE_PACKAGE_PATH / filename
+            target = Path(path) / src.relative_to(SITE_PACKAGE_PATH.parent.parent.parent)
+            if not target.exists():
+                shutil.copy(src, target)
+        return result
+
+    env._PipBackend.create = pip_env_create
+
+
+# Import hook that patches the creation of virtual environments by `build`
+#
+# The approach used here is the same as the one used by virtualenv to patch
+# distutils (but without support for the older load_module API).
+# https://docs.python.org/3/library/importlib.html#setting-up-an-importer
+_BUILD_PATCH = ("build.env",)
+
+
+class _Finder:
+    """A meta path finder that allows patching the imported build modules."""
+
+    fullname = None
+
+    # lock[0] is threading.Lock(), but initialized lazily to avoid importing
+    # threading very early at startup, because there are gevent-based
+    # applications that need to be first to import threading by themselves.
+    # See https://github.com/pypa/virtualenv/issues/1895 for details.
+    lock = []  # noqa: RUF012
+
+    def find_spec(self, fullname, path, target=None):
+        if fullname in _BUILD_PATCH and self.fullname is None:
+            # initialize lock[0] lazily
+            if len(self.lock) == 0:
+                import threading
+
+                lock = threading.Lock()
+                # there is possibility that two threads T1 and T2 are
+                # simultaneously running into find_spec, observing .lock as
+                # empty, and further going into hereby initialization. However
+                # due to the GIL, list.append() operation is atomic and this
+                # way only one of the threads will "win" to put the lock
+                # - that every thread will use - into .lock[0].
+                # https://docs.python.org/3/faq/library.html#what-kinds-of-global-value-mutation-are-thread-safe
+                self.lock.append(lock)
+
+            from functools import partial
+            from importlib.util import find_spec
+
+            with self.lock[0]:
+                self.fullname = fullname
+                try:
+                    spec = find_spec(fullname, path)
+                    if spec is not None:
+                        # https://www.python.org/dev/peps/pep-0451/#how-loading-will-work
+                        old = spec.loader.exec_module
+                        func = self.exec_module
+                        if old is not func:
+                            spec.loader.exec_module = partial(func, old)
+                        return spec
+                finally:
+                    self.fullname = None
+        return None
+
+    @staticmethod
+    def exec_module(old, module):
+        old(module)
+        if module.__name__ in _BUILD_PATCH:
+            patch_env_create(module)
+
+
+sys.meta_path.insert(0, _Finder())
@@ -0,0 +1,79 @@
+# A site package that turns a macOS virtual environment
+# into an arm64 iphoneos cross-platform virtual environment
+import platform
+import subprocess
+import sys
+import sysconfig
+
+###########################################################################
+# sys module patches
+###########################################################################
+sys.cross_compiling = True
+sys.platform = "ios"
+sys.implementation._multiarch = "arm64-iphoneos"
+sys.base_prefix = sysconfig._get_sysconfigdata()["prefix"]
+sys.base_exec_prefix = sysconfig._get_sysconfigdata()["prefix"]
+
+###########################################################################
+# subprocess module patches
+###########################################################################
+subprocess._can_fork_exec = True
+
+
+###########################################################################
+# platform module patches
+###########################################################################
+
+
+def cross_system():
+    return "iOS"
+
+
+def cross_uname():
+    return platform.uname_result(
+        system="iOS",
+        node="build",
+        release="13.0",
+        version="",
+        machine="arm64",
+    )
+
+
+def cross_ios_ver(system="", release="", model="", is_simulator=False):
+    if system == "":
+        system = "iOS"
+    if release == "":
+        release = "13.0"
+    if model == "":
+        model = "iphoneos"
+
+    return platform.IOSVersionInfo(system, release, model, False)
+
+
+platform.system = cross_system
+platform.uname = cross_uname
+platform.ios_ver = cross_ios_ver
+
+
+###########################################################################
+# sysconfig module patches
+###########################################################################
+
+
+def cross_get_platform():
+    return "ios-13.0-arm64-iphoneos"
+
+
+def cross_get_sysconfigdata_name():
+    return "_sysconfigdata__ios_arm64-iphoneos"
+
+
+sysconfig.get_platform = cross_get_platform
+sysconfig._get_sysconfigdata_name = cross_get_sysconfigdata_name
+
+# Ensure module-level values cached at time of import are updated.
+sysconfig._BASE_PREFIX = sys.base_prefix
+sysconfig._BASE_EXEC_PREFIX = sys.base_exec_prefix
+
+# Force sysconfig data to be loaded (and cached).
+sysconfig._init_config_vars()
@@ -0,0 +1,22 @@
+# A site customization that can be used to trick pip into installing packages
+# cross-platform. If the folder containing this file is on your PYTHONPATH when
+# you invoke python, the interpreter will behave as if it were running on
+# arm64 iphoneos.
+import sys
+import os
+
+# Apply the cross-platform patch
+import _cross_arm64_iphoneos
+import _cross_venv
+
+
+# Call the next sitecustomize script if there is one
+# (https://nedbatchelder.com/blog/201001/running_code_at_python_startup.html).
+del sys.modules["sitecustomize"]
+this_dir = os.path.dirname(__file__)
+path_index = sys.path.index(this_dir)
+del sys.path[path_index]
+try:
+    import sitecustomize  # noqa: F401
+finally:
+    sys.path.insert(path_index, this_dir)
@@ -0,0 +1,79 @@
+# A site package that turns a macOS virtual environment
+# into an arm64 iphonesimulator cross-platform virtual environment
+import platform
+import subprocess
+import sys
+import sysconfig
+
+###########################################################################
+# sys module patches
+###########################################################################
+sys.cross_compiling = True
+sys.platform = "ios"
+sys.implementation._multiarch = "arm64-iphonesimulator"
+sys.base_prefix = sysconfig._get_sysconfigdata()["prefix"]
+sys.base_exec_prefix = sysconfig._get_sysconfigdata()["prefix"]
+
+###########################################################################
+# subprocess module patches
+###########################################################################
+subprocess._can_fork_exec = True
+
+
+###########################################################################
+# platform module patches
+###########################################################################
+
+
+def cross_system():
+    return "iOS"
+
+
+def cross_uname():
+    return platform.uname_result(
+        system="iOS",
+        node="build",
+        release="13.0",
+        version="",
+        machine="arm64",
+    )
+
+
+def cross_ios_ver(system="", release="", model="", is_simulator=False):
+    if system == "":
+        system = "iOS"
+    if release == "":
+        release = "13.0"
+    if model == "":
+        model = "iphonesimulator"
+
+    return platform.IOSVersionInfo(system, release, model, True)
+
+
+platform.system = cross_system
+platform.uname = cross_uname
+platform.ios_ver = cross_ios_ver
+
+
+###########################################################################
+# sysconfig module patches
+###########################################################################
+
+
+def cross_get_platform():
+    return "ios-13.0-arm64-iphonesimulator"
+
+
+def cross_get_sysconfigdata_name():
+    return "_sysconfigdata__ios_arm64-iphonesimulator"
+
+
+sysconfig.get_platform = cross_get_platform
+sysconfig._get_sysconfigdata_name = cross_get_sysconfigdata_name
+
+# Ensure module-level values cached at time of import are updated.
+sysconfig._BASE_PREFIX = sys.base_prefix
+sysconfig._BASE_EXEC_PREFIX = sys.base_exec_prefix
+
+# Force sysconfig data to be loaded (and cached).
+sysconfig._init_config_vars()
@@ -0,0 +1,22 @@
+# A site customization that can be used to trick pip into installing packages
+# cross-platform. If the folder containing this file is on your PYTHONPATH when
+# you invoke python, the interpreter will behave as if it were running on
+# arm64 iphonesimulator.
+import sys
+import os
+
+# Apply the cross-platform patch
+import _cross_arm64_iphonesimulator
+import _cross_venv
+
+
+# Call the next sitecustomize script if there is one
+# (https://nedbatchelder.com/blog/201001/running_code_at_python_startup.html).
+del sys.modules["sitecustomize"]
+this_dir = os.path.dirname(__file__)
+path_index = sys.path.index(this_dir)
+del sys.path[path_index]
+try:
+    import sitecustomize  # noqa: F401
+finally:
+    sys.path.insert(path_index, this_dir)
@@ -0,0 +1,175 @@
+from __future__ import annotations
+
+import json
+import pprint
+import shutil
+import sys
+from importlib import util as importlib_util
+from pathlib import Path
+from typing import Any
+
+
+def localized_vars(orig_vars: dict[str, Any], slice_path: Path) -> dict[str, Any]:
+    """Update (where possible) any references to build-time variables with the
+    best guess of the installed location.
+    """
+    # The host's sysconfigdata will include references to build-time variables.
+    # Update these to refer to the current known install location.
+    orig_prefix = orig_vars["prefix"]
+    localized_vars = {}
+    for key, value in orig_vars.items():
+        final = value
+        if isinstance(value, str):
+            # Replace any reference to the build installation prefix
+            final = final.replace(orig_prefix, str(slice_path))
+            # Replace any reference to the build-time Framework location
+            final = final.replace("-F .", f"-F {slice_path}")
+        localized_vars[key] = final
+
+    return localized_vars
+
+
+def localize_sysconfigdata(sysconfig_path: Path, venv_site_packages: Path) -> None:
+    """Localize a sysconfigdata python module.
+
+    :param sysconfig_path: The platform config that contains the
+        sysconfigdata module to localize.
+    :param venv_site_packages: The site packages folder where the localized
+        sysconfigdata module should be output.
+    """
+    # Find the "_sysconfigdata_*.py" file in the platform config
+    sysconfigdata_path = next(sysconfig_path.glob("_sysconfigdata_*.py"))
+
+    # Import the sysconfigdata module
+    spec = importlib_util.spec_from_file_location(sysconfigdata_path.stem, sysconfigdata_path)
+    if spec is None:
+        msg = f"Unable to load spec for {sysconfigdata_path}"
+        raise ValueError(msg)
+    if spec.loader is None:
+        msg = f"Spec for {sysconfigdata_path} does not define a loader"
+        raise ValueError(msg)
+    sysconfigdata = importlib_util.module_from_spec(spec)
+    spec.loader.exec_module(sysconfigdata)
+
+    # Write the updated sysconfigdata module into the cross-platform site.
+    slice_path = sysconfigdata_path.parent.parent.parent
+    with (venv_site_packages / sysconfigdata_path.name).open("w") as f:
+        f.write(f"# Generated from {sysconfigdata_path}\n")
+        f.write("build_time_vars = ")
+        pprint.pprint(
+            localized_vars(sysconfigdata.build_time_vars, slice_path), stream=f, compact=True
+        )
+
+
+def localize_sysconfig_vars(sysconfig_path: Path, venv_site_packages: Path) -> None:
+    """Localize a sysconfig_vars.json file.
+
+    :param sysconfig_path: The platform config that contains the
+        sysconfigdata module to localize.
+    :param venv_site_packages: The site-packages folder where the localized
+        sysconfig_vars.json file should be output.
+    """
+    # Find the "_sysconfig_vars_*.json" file in the platform config
+    sysconfig_vars_path = next(sysconfig_path.glob("_sysconfig_vars_*.json"))
+
+    with sysconfig_vars_path.open("rb") as f:
+        build_time_vars = json.load(f)
+
+    slice_path = sysconfig_vars_path.parent.parent.parent
+    with (venv_site_packages / sysconfig_vars_path.name).open("w") as f:
+        json.dump(localized_vars(build_time_vars, slice_path), f, indent=2)
+
+
+def make_cross_venv(
+    venv_path: Path,
+    sysconfig_path: Path,
+    platform_config_path: Path,
+) -> None:
+    """Convert a virtual environment into a cross-platform environment.
+
+    :param venv_path: The path to the root of the venv.
+    :param sysconfig_path: The path containing sysconfigdata files for the
+        target platform.
+    :param platform_config_path: The path containing the cross-venv support
+        scripts (_cross_venv.py and the multiarch-specific _cross_*.py).
+    """
+    if not venv_path.exists():
+        msg = f"Virtual environment {venv_path} does not exist."
+        raise ValueError(msg)
+    if not (venv_path / "bin/python3").exists():
+        msg = f"{venv_path} does not appear to be a virtual environment."
+        raise ValueError(msg)
+
+    LIB_PATH = f"lib/python{sys.version_info[0]}.{sys.version_info[1]}"
+
+    # Derive the multiarch tag from the sysconfigdata filename if available;
+    # otherwise fall back to the directory name (BeeWare convention).
+    sysconfigdata_files = list(sysconfig_path.glob("_sysconfigdata_*.py"))
+    if sysconfigdata_files:
+        multiarch_tag = sysconfigdata_files[0].stem.split("_ios_")[1]
+        cross_multiarch = f"_cross_{multiarch_tag.replace('-', '_')}"
+    else:
+        multiarch_tag = sysconfig_path.name
+        cross_multiarch = f"_cross_{multiarch_tag.replace('-', '_')}"
+
+    print(
+        f"Converting {venv_path} into a {multiarch_tag} environment... ",
+        end="",
+    )
+
+    # Update path references in the sysconfigdata to reflect local conditions.
+    venv_site_packages = venv_path / LIB_PATH / "site-packages"
+    localize_sysconfigdata(sysconfig_path, venv_site_packages)
+    localize_sysconfig_vars(sysconfig_path, venv_site_packages)
+    # The multiarch-specific script may be directly in platform_config_path (BeeWare
+    # convention, where all files are co-located) or in a named subdirectory
+    # (cibuildwheel resource layout, where each multiarch has its own subdir).
+    multiarch_script = platform_config_path / f"{cross_multiarch}.py"
+    if not multiarch_script.exists():
+        multiarch_script = platform_config_path / multiarch_tag / f"{cross_multiarch}.py"
+    shutil.copy(
+        multiarch_script,
+        venv_site_packages / f"{cross_multiarch}.py",
+    )
+    shutil.copy(
+        platform_config_path / "_cross_venv.py",
+        venv_site_packages / "_cross_venv.py",
+    )
+    # Write the .pth file that will enable the cross-env modifications
+    (venv_site_packages / "_cross_venv.pth").write_text(
+        f"import {cross_multiarch}; import _cross_venv\n"
+    )
+
+    print("done.")
+
+
+if __name__ == "__main__":
+    try:
+        sysconfig_path = Path(sys.argv[2]).resolve()
+    except IndexError:
+        sysconfig_path = Path(__file__).parent
+
+    try:
+        platform_config_path = Path(sys.argv[3]).resolve()
+    except IndexError:
+        platform_config_path = sysconfig_path
+
+    try:
+        venv_path = Path(sys.argv[1]).resolve()
+        make_cross_venv(venv_path, sysconfig_path, platform_config_path)
+    except IndexError:
+        print("""
+Convert a virtual environment into a cross-platform environment.
+
+Usage:
+    make_cross_venv <venv> (<sysconfig path>) (<platform config path>)
+
+The sysconfig path is the path that contains the `_sysconfigdata-*.py` file
+for the platform being targeted. If an explicit sysconfig path isn't
+provided, it is assumed the directory containing the make_cross_venv script
+also contains the sysconfig data for the interpreter.
+
+The platform config path is the path that contains the cross-venv support
+scripts. If an explicit platform config path isn't provided, it is assumed
+that the sysconfig path also contains the platform configuration files.
+""")
@@ -0,0 +1,79 @@
+# A site package that turns a macOS virtual environment
+# into an x86_64 iphonesimulator cross-platform virtual environment
+import platform
+import subprocess
+import sys
+import sysconfig
+
+###########################################################################
+# sys module patches
+###########################################################################
+sys.cross_compiling = True
+sys.platform = "ios"
+sys.implementation._multiarch = "x86_64-iphonesimulator"
+sys.base_prefix = sysconfig._get_sysconfigdata()["prefix"]
+sys.base_exec_prefix = sysconfig._get_sysconfigdata()["prefix"]
+
+###########################################################################
+# subprocess module patches
+###########################################################################
+subprocess._can_fork_exec = True
+
+
+###########################################################################
+# platform module patches
+###########################################################################
+
+
+def cross_system():
+    return "iOS"
+
+
+def cross_uname():
+    return platform.uname_result(
+        system="iOS",
+        node="build",
+        release="13.0",
+        version="",
+        machine="x86_64",
+    )
+
+
+def cross_ios_ver(system="", release="", model="", is_simulator=False):
+    if system == "":
+        system = "iOS"
+    if release == "":
+        release = "13.0"
+    if model == "":
+        model = "iphonesimulator"
+
+    return platform.IOSVersionInfo(system, release, model, True)
+
+
+platform.system = cross_system
+platform.uname = cross_uname
+platform.ios_ver = cross_ios_ver
+
+
+###########################################################################
+# sysconfig module patches
+###########################################################################
+
+
+def cross_get_platform():
+    return "ios-13.0-x86_64-iphonesimulator"
+
+
+def cross_get_sysconfigdata_name():
+    return "_sysconfigdata__ios_x86_64-iphonesimulator"
+
+
+sysconfig.get_platform = cross_get_platform
+sysconfig._get_sysconfigdata_name = cross_get_sysconfigdata_name
+
+# Ensure module-level values cached at time of import are updated.
+sysconfig._BASE_PREFIX = sys.base_prefix
+sysconfig._BASE_EXEC_PREFIX = sys.base_exec_prefix
+
+# Force sysconfig data to be loaded (and cached).
+sysconfig._init_config_vars()
@@ -0,0 +1,22 @@
+# A site customization that can be used to trick pip into installing packages
+# cross-platform. If the folder containing this file is on your PYTHONPATH when
+# you invoke python, the interpreter will behave as if it were running on
+# x86_64 iphonesimulator.
+import sys
+import os
+
+# Apply the cross-platform patch
+import _cross_x86_64_iphonesimulator
+import _cross_venv
+
+
+# Call the next sitecustomize script if there is one
+# (https://nedbatchelder.com/blog/201001/running_code_at_python_startup.html).
+del sys.modules["sitecustomize"]
+this_dir = os.path.dirname(__file__)
+path_index = sys.path.index(this_dir)
+del sys.path[path_index]
+try:
+    import sitecustomize  # noqa: F401
+finally:
+    sys.path.insert(path_index, this_dir)
@@ -1,3 +1,4 @@
 url = "https://nodejs.org/dist/"
-v22 = "v22.18.0"
-v20 = "v20.19.4"
+v24 = "v24.16.0"
+v22 = "v22.22.3"
+v20 = "v20.20.2"
@@ -1,53 +1,54 @@
 [x86_64]
-manylinux2014 = quay.io/pypa/manylinux2014_x86_64:2025.08.15-1
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_x86_64:2025.08.15-1
-manylinux_2_34 = quay.io/pypa/manylinux_2_34_x86_64:2025.08.15-1
-musllinux_1_2 = quay.io/pypa/musllinux_1_2_x86_64:2025.08.15-1
+manylinux2014 = quay.io/pypa/manylinux2014_x86_64:2026.06.04-1
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_x86_64:2026.06.04-1
+manylinux_2_34 = quay.io/pypa/manylinux_2_34_x86_64:2026.06.04-1
+musllinux_1_2 = quay.io/pypa/musllinux_1_2_x86_64:2026.06.04-1

 [i686]
-manylinux2014 = quay.io/pypa/manylinux2014_i686:2025.08.15-1
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_i686:2025.08.15-1
-manylinux_2_34 = quay.io/pypa/manylinux_2_34_i686:2025.08.15-1
-musllinux_1_2 = quay.io/pypa/musllinux_1_2_i686:2025.08.15-1
+manylinux2014 = quay.io/pypa/manylinux2014_i686:2026.06.04-1
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_i686:2026.06.04-1
+manylinux_2_34 = quay.io/pypa/manylinux_2_34_i686:2026.06.04-1
+musllinux_1_2 = quay.io/pypa/musllinux_1_2_i686:2026.06.04-1

 [aarch64]
-manylinux2014 = quay.io/pypa/manylinux2014_aarch64:2025.08.15-1
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_aarch64:2025.08.15-1
-manylinux_2_34 = quay.io/pypa/manylinux_2_34_aarch64:2025.08.15-1
-musllinux_1_2 = quay.io/pypa/musllinux_1_2_aarch64:2025.08.15-1
+manylinux2014 = quay.io/pypa/manylinux2014_aarch64:2026.06.04-1
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_aarch64:2026.06.04-1
+manylinux_2_34 = quay.io/pypa/manylinux_2_34_aarch64:2026.06.04-1
+musllinux_1_2 = quay.io/pypa/musllinux_1_2_aarch64:2026.06.04-1

 [ppc64le]
-manylinux2014 = quay.io/pypa/manylinux2014_ppc64le:2025.08.15-1
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_ppc64le:2025.08.15-1
-manylinux_2_34 = quay.io/pypa/manylinux_2_34_ppc64le:2025.08.15-1
-musllinux_1_2 = quay.io/pypa/musllinux_1_2_ppc64le:2025.08.15-1
+manylinux2014 = quay.io/pypa/manylinux2014_ppc64le:2026.06.04-1
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_ppc64le:2026.06.04-1
+manylinux_2_34 = quay.io/pypa/manylinux_2_34_ppc64le:2026.06.04-1
+musllinux_1_2 = quay.io/pypa/musllinux_1_2_ppc64le:2026.06.04-1

 [s390x]
-manylinux2014 = quay.io/pypa/manylinux2014_s390x:2025.08.15-1
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_s390x:2025.08.15-1
-manylinux_2_34 = quay.io/pypa/manylinux_2_34_s390x:2025.08.15-1
-musllinux_1_2 = quay.io/pypa/musllinux_1_2_s390x:2025.08.15-1
+manylinux2014 = quay.io/pypa/manylinux2014_s390x:2026.06.04-1
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_s390x:2026.06.04-1
+manylinux_2_34 = quay.io/pypa/manylinux_2_34_s390x:2026.06.04-1
+musllinux_1_2 = quay.io/pypa/musllinux_1_2_s390x:2026.06.04-1

 [pypy_x86_64]
-manylinux2014 = quay.io/pypa/manylinux2014_x86_64:2025.08.15-1
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_x86_64:2025.08.15-1
-manylinux_2_34 = quay.io/pypa/manylinux_2_34_x86_64:2025.08.15-1
+manylinux2014 = quay.io/pypa/manylinux2014_x86_64:2026.06.04-1
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_x86_64:2026.06.04-1
+manylinux_2_34 = quay.io/pypa/manylinux_2_34_x86_64:2026.06.04-1

 [pypy_i686]
-manylinux2014 = quay.io/pypa/manylinux2014_i686:2025.08.15-1
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_i686:2025.08.15-1
-manylinux_2_34 = quay.io/pypa/manylinux_2_34_i686:2025.08.15-1
+manylinux2014 = quay.io/pypa/manylinux2014_i686:2026.06.04-1
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_i686:2026.06.04-1
+manylinux_2_34 = quay.io/pypa/manylinux_2_34_i686:2026.06.04-1

 [pypy_aarch64]
-manylinux2014 = quay.io/pypa/manylinux2014_aarch64:2025.08.15-1
-manylinux_2_28 = quay.io/pypa/manylinux_2_28_aarch64:2025.08.15-1
-manylinux_2_34 = quay.io/pypa/manylinux_2_34_aarch64:2025.08.15-1
+manylinux2014 = quay.io/pypa/manylinux2014_aarch64:2026.06.04-1
+manylinux_2_28 = quay.io/pypa/manylinux_2_28_aarch64:2026.06.04-1
+manylinux_2_34 = quay.io/pypa/manylinux_2_34_aarch64:2026.06.04-1

 [armv7l]
-manylinux_2_31 = quay.io/pypa/manylinux_2_31_armv7l:2025.08.15-1
-musllinux_1_2 = quay.io/pypa/musllinux_1_2_armv7l:2025.08.15-1
+manylinux_2_31 = quay.io/pypa/manylinux_2_31_armv7l:2026.06.04-1
+manylinux_2_35 = quay.io/pypa/manylinux_2_35_armv7l:2026.06.04-1
+musllinux_1_2 = quay.io/pypa/musllinux_1_2_armv7l:2026.06.04-1

 [riscv64]
-manylinux_2_39 = quay.io/pypa/manylinux_2_39_riscv64:2025.08.15-1
-musllinux_1_2 = quay.io/pypa/musllinux_1_2_riscv64:2025.08.15-1
+manylinux_2_39 = quay.io/pypa/manylinux_2_39_riscv64:2026.06.04-1
+musllinux_1_2 = quay.io/pypa/musllinux_1_2_riscv64:2026.06.04-1

@@ -1 +1 @@
-default = { version = "20.34.0", url = "https://github.com/pypa/get-virtualenv/releases/download/20.34.0/virtualenv.pyz" }
+default = { version = "21.4.2", url = "https://github.com/pypa/get-virtualenv/releases/download/21.4.2/virtualenv.pyz", sha256 = "b54c48b9c81468403626762747c5ee5939616f18f46c3c4bbebdbe0aa3a8ba1d" }
@@ -1,7 +1,12 @@
-import json
-from typing import Any
+from __future__ import annotations

-from .util import resources
+import json
+
+from cibuildwheel.util import resources
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Any


 def get_schema(tool_name: str = "cibuildwheel") -> dict[str, Any]:
@@ -1,13 +1,19 @@
+from __future__ import annotations
+
 import dataclasses
 import itertools
 from enum import StrEnum
 from fnmatch import fnmatch
-from typing import Any

 import bracex
-from packaging.specifiers import SpecifierSet
 from packaging.version import Version

+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from typing import Self
+
+    from packaging.specifiers import SpecifierSet
+

 def selector_matches(patterns: str, string: str) -> bool:
    """
@@ -29,20 +35,19 @@ class EnableGroup(StrEnum):
    Groups of build selectors that are not enabled by default.
    """

-    CPythonExperimentalRiscV64 = "cpython-experimental-riscv64"
-    CPythonFreeThreading = "cpython-freethreading"
    CPythonPrerelease = "cpython-prerelease"
    GraalPy = "graalpy"
    PyPy = "pypy"
    PyPyEoL = "pypy-eol"
+    PyodideEoL = "pyodide-eol"
    PyodidePrerelease = "pyodide-prerelease"

    @classmethod
-    def all_groups(cls) -> frozenset["EnableGroup"]:
-        return frozenset(set(cls) - {cls.CPythonExperimentalRiscV64})
+    def all_groups(cls) -> frozenset[Self]:
+        return frozenset(cls)

    @classmethod
-    def parse_option_value(cls, value: str) -> frozenset["EnableGroup"]:
+    def parse_option_value(cls, value: str) -> frozenset[Self]:
        """
        Parses a string of space-separated values into a set of EnableGroup
        members. The string may contain group names or "all".
@@ -76,7 +81,7 @@ class BuildSelector:
    def __call__(self, build_id: str) -> bool:
        # Filter build selectors by python_requires if set
        if self.requires_python is not None:
-            py_ver_str = build_id.split("-")[0].split("_")[0]
+            py_ver_str = build_id.split("-", maxsplit=1)[0].split("_", maxsplit=1)[0]
            py_ver_str = py_ver_str.removesuffix("t")
            major = int(py_ver_str[2])
            minor = int(py_ver_str[3:])
@@ -85,34 +90,38 @@ class BuildSelector:
                return False

        # filter out groups that are not enabled
-        if EnableGroup.CPythonFreeThreading not in self.enable and fnmatch(build_id, "cp313t-*"):
-            return False
        if EnableGroup.CPythonPrerelease not in self.enable and fnmatch(build_id, "cp315*"):
            return False
-        if EnableGroup.PyPy not in self.enable and fnmatch(build_id, "pp31*"):
+        is_pypy_eol = fnmatch(build_id, "pp3?-*") or fnmatch(build_id, "pp310-*")
+        is_pypy = fnmatch(build_id, "pp*") and not is_pypy_eol
+        if EnableGroup.PyPy not in self.enable and is_pypy:
            return False
-        if EnableGroup.PyPyEoL not in self.enable and fnmatch(build_id, "pp3?-*"):
+        if EnableGroup.PyPyEoL not in self.enable and is_pypy_eol:
            return False
        if EnableGroup.GraalPy not in self.enable and fnmatch(build_id, "gp*"):
            return False
-        # TODO: Re-enable this when we have Pyodide prereleases again (e.g., 0.29.0a1+)
-        # Python 3.13 support became stable in Pyodide 0.28.0, so it no longer needs a prerelease
-        # flag.
-        # Also update Pyodide tests in unit_test/build_selector_test.py accordingly.
-        # When re-enabling, update the pattern to match the experimental Python version in case
-        # it is bumped to Python 3.14 (likely cp314-pyodide_* but could remain as 3.13 as well).
+        if EnableGroup.PyodideEoL not in self.enable and fnmatch(build_id, "cp312-pyodide_*"):
+            return False
+        # NOTE: Disable this when we don't have any Pyodide prereleases (e.g., 314.0.0a1+)
+        # When doing this, also:
+        #   1. update Pyodide tests in unit_test/build_selector_test.py and unit_test/options_test.py accordingly.
+        #   2. update Python versions for Pyodide identifiers in cibuildwheel/selector.py.
+        #   3. update constraints as necessary via bin/generate_pyodide_constraints.py and add/delete
+        #      Pyodide constraints files in cibuildwheel/resources/constraints/ as necessary.
+        # When disabling, update the pattern to match the experimental Python version in case
+        # it is bumped to Python 3.15 (likely cp315-pyodide_* but could remain as 3.14 as well).
        # This depends on the CPython version being used in the Pyodide runtime at the time.
-        # if EnableGroup.PyodidePrerelease not in self.enable and fnmatch(
-        #     build_id, "cp313-pyodide_*"
-        # ):
-        #     return False
+        if EnableGroup.PyodidePrerelease not in self.enable and fnmatch(
+            build_id, "cp314-pyodide_*"
+        ):
+            return False

        should_build = selector_matches(self.build_config, build_id)
        should_skip = selector_matches(self.skip_config, build_id)

        return should_build and not should_skip

-    def options_summary(self) -> Any:
+    def options_summary(self) -> dict[str, str | list[str]]:
        return {
            "build_config": self.build_config,
            "skip_config": self.skip_config,
@@ -133,5 +142,5 @@ class TestSelector:
        should_skip = selector_matches(self.skip_config, build_id)
        return not should_skip

-    def options_summary(self) -> Any:
+    def options_summary(self) -> dict[str, str]:
        return {"skip_config": self.skip_config}
@@ -1,14 +1,20 @@
+from __future__ import annotations
+
 import os
 import shlex
 import shutil
 import subprocess
 import sys
 import typing
-from collections.abc import Iterator, Mapping
-from typing import Final, Literal

-from ..errors import FatalError
-from ..typing import PathOrStr
+from cibuildwheel.errors import FatalError
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Iterator, Mapping
+    from typing import Final, Literal
+
+    from cibuildwheel.typing import PathOrStr

 _IS_WIN: Final[bool] = sys.platform.startswith("win")

@@ -72,7 +78,7 @@ def call(
    if not capture_stdout:
        return None
    sys.stderr.write(result.stderr)
-    return typing.cast(str, result.stdout)
+    return typing.cast("str", result.stdout)


 def shell(
@@ -1,10 +1,13 @@
+from __future__ import annotations
+
+import hashlib
 import os
 import shutil
 import ssl
 import tarfile
 import time
 import urllib.request
-from collections.abc import Callable
+from contextlib import contextmanager
 from pathlib import Path, PurePath
 from typing import Final
 from zipfile import ZipFile
@@ -12,7 +15,11 @@ from zipfile import ZipFile
 import certifi
 from platformdirs import user_cache_path

-from ..errors import FatalError
+from cibuildwheel.errors import FatalError
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable, Generator

 DEFAULT_CIBW_CACHE_PATH: Final[Path] = user_cache_path(appname="cibuildwheel", appauthor="pypa")
 CIBW_CACHE_PATH: Final[Path] = Path(
@@ -20,6 +27,22 @@ CIBW_CACHE_PATH: Final[Path] = Path(
 ).resolve()


+@contextmanager
+def remove_on_error(path: Path) -> Generator[None, None, None]:
+    try:
+        yield
+    except BaseException as original_exception:
+        try:
+            if path.is_dir() and not path.is_symlink():
+                shutil.rmtree(path)
+            elif path.exists() or path.is_symlink():
+                path.unlink()
+        except BaseException as cleanup_exception:
+            msg = f"Failed to remove {path}. Please remove it manually."
+            raise BaseExceptionGroup(msg, [original_exception, cleanup_exception]) from None
+        raise
+
+
 def ensure_cache_sentinel(cache_path: Path) -> None:
    """Create a sentinel file to mark a cibuildwheel cache directory.

@@ -40,7 +63,7 @@ def ensure_cache_sentinel(cache_path: Path) -> None:
            )


-def download(url: str, dest: Path) -> None:
+def download(url: str, dest: Path, *, sha256: str | None = None) -> None:
    print(f"+ Download {url} to {dest}")
    dest_dir = dest.parent
    dest_dir.mkdir(parents=True, exist_ok=True)
@@ -54,13 +77,20 @@ def download(url: str, dest: Path) -> None:
        try:
            with urllib.request.urlopen(url, context=context) as response:
                dest.write_bytes(response.read())
-                return
+                break

        except OSError:
            if i == repeat_num - 1:
                raise
            time.sleep(3)

+    if sha256:
+        computed = hashlib.sha256(dest.read_bytes()).hexdigest()
+        if computed != sha256:
+            dest.unlink(missing_ok=True)
+            msg = f"SHA256 mismatch for {url}: expected {sha256!r}, got {computed!r}"
+            raise FatalError(msg)
+

 def extract_zip(zip_src: Path, dest: Path) -> None:
    """Extracts a zip and correctly sets permissions on extracted files.
@@ -1,13 +1,18 @@
+from __future__ import annotations
+
 import dataclasses
 import itertools
-import os
 import re
 import shlex
 import textwrap
 from collections import defaultdict
-from collections.abc import Sequence

-from ..typing import PathOrStr
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    import os
+    from collections.abc import Sequence
+
+    from cibuildwheel.typing import PathOrStr


 def format_safe(template: str, **kwargs: str | os.PathLike[str]) -> str:
@@ -104,7 +109,7 @@ def parse_key_value_string(
    if kw_arg_names is None:
        kw_arg_names = []

-    all_field_names = [*positional_arg_names, *kw_arg_names]
+    all_field_names = None if ("*" in kw_arg_names) else [*positional_arg_names, *kw_arg_names]

    shlexer = shlex.shlex(key_value_string, posix=True, punctuation_chars=";")
    shlexer.commenters = ""
@@ -121,7 +126,7 @@ def parse_key_value_string(
        # check to see if the option name is specified
        field_name, sep, first_value = field[0].partition(":")
        if sep:
-            if field_name not in all_field_names:
+            if (all_field_names is not None) and (field_name not in all_field_names):
                msg = f"Failed to parse {key_value_string!r}. Unknown field name {field_name!r}"
                raise ValueError(msg)

@@ -1,14 +1,20 @@
+from __future__ import annotations
+
 import shlex
-from collections.abc import Mapping, MutableMapping, Sequence
 from dataclasses import dataclass, field
 from pathlib import Path, PurePath
-from typing import Any, Literal, Self, TypeVar
+from typing import TypeVar

 from packaging.utils import parse_wheel_filename

-from . import resources
-from .cmd import call
-from .helpers import parse_key_value_string, unwrap
+from cibuildwheel.util import resources
+from cibuildwheel.util.cmd import call
+from cibuildwheel.util.helpers import parse_key_value_string, unwrap
+
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Mapping, Sequence
+    from typing import Literal, Self


@dataclass(kw_only=True)
@@ -102,7 +108,7 @@ class DependencyConstraints:

        return None

-    def options_summary(self) -> Any:
+    def options_summary(self) -> str | dict[str, str]:
        if self == DependencyConstraints.pinned():
            return "pinned"
        elif self.packages:
@@ -169,10 +175,9 @@ def find_compatible_wheel(wheels: Sequence[T], identifier: str) -> T | None:
            elif platform.startswith("pyodide"):
                # each Pyodide version has its own platform tag
                continue
-            else:
-                # Windows should exactly match
-                if tag.platform != platform:
-                    continue
+            # Windows should exactly match
+            elif tag.platform != platform:
+                continue

            # If all the filters above pass, then the wheel is a previously built compatible wheel.
            return wheel
@@ -180,28 +185,7 @@ def find_compatible_wheel(wheels: Sequence[T], identifier: str) -> T | None:
    return None


-def combine_constraints(
-    env: MutableMapping[str, str], /, constraints_path: Path, tmp_dir: Path | None
-) -> None:
-    """
-    This will workaround a bug in pip<=21.1.1 or uv<=0.2.0 if a tmp_dir is given.
-    If set to None, this will use the modern URI method.
-    """
-
-    if tmp_dir:
-        if " " in str(constraints_path):
-            assert " " not in str(tmp_dir)
-            tmp_file = tmp_dir / "constraints.txt"
-            tmp_file.write_bytes(constraints_path.read_bytes())
-            constraints_path = tmp_file
-        our_constraints = str(constraints_path)
-    else:
-        our_constraints = (
-            constraints_path.as_uri() if " " in str(constraints_path) else str(constraints_path)
-        )
-
-    user_constraints = env.get("PIP_CONSTRAINT")
-
-    env["UV_CONSTRAINT"] = env["PIP_CONSTRAINT"] = " ".join(
-        c for c in [our_constraints, user_constraints] if c
-    )
+def is_abi3_wheel(wheel_name: str) -> bool:
+    """Check if a wheel uses the abi3 stable ABI based on its filename."""
+    _, _, _, tags = parse_wheel_filename(wheel_name)
+    return any(tag.abi == "abi3" for tag in tags)
@@ -1,19 +1,27 @@
+from __future__ import annotations
+
 import fnmatch
 import functools
+import hashlib
 import json
 import platform
+import subprocess
 import typing
-from pathlib import Path

 from filelock import FileLock

-from cibuildwheel.util.file import download, extract_tar
+from cibuildwheel.util.file import download, extract_tar, remove_on_error
 from cibuildwheel.util.resources import PYTHON_BUILD_STANDALONE_RELEASES

+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from pathlib import Path
+

 class PythonBuildStandaloneAsset(typing.TypedDict):
    name: str
    url: str
+    sha256: str


 class PythonBuildStandaloneRelease(typing.TypedDict):
@@ -28,13 +36,33 @@ class PythonBuildStandaloneReleaseData(typing.TypedDict):
@functools.cache
 def get_python_build_standalone_release_data() -> PythonBuildStandaloneReleaseData:
    with open(PYTHON_BUILD_STANDALONE_RELEASES, "rb") as f:
-        return typing.cast(PythonBuildStandaloneReleaseData, json.load(f))
+        return typing.cast("PythonBuildStandaloneReleaseData", json.load(f))


 class PythonBuildStandaloneError(Exception):
    """Errors related to python-build-standalone."""


+def _is_musl_libc() -> bool:
+    """
+    Detect whether the host uses musl libc (e.g. Alpine Linux).
+
+    ``platform.libc_ver()`` only ever reports glibc, so we shell out to ``ldd``,
+    which prints "musl libc" on musl-based systems (and "GNU libc"/"GLIBC" on
+    glibc systems). If ``ldd`` is unavailable, we fall back to assuming glibc.
+    """
+    try:
+        ldd = subprocess.run(
+            ["ldd", "--version"],
+            capture_output=True,
+            text=True,
+            check=False,
+        )
+    except OSError:
+        return False
+    return "musl" in (ldd.stdout + ldd.stderr).lower()
+
+
 def _get_platform_identifiers() -> tuple[str, str, str | None]:
    """
    Detects the current platform and returns architecture, platform, and libc
@@ -60,7 +88,7 @@ def _get_platform_identifiers() -> tuple[str, str, str | None]:
    # Map OS + Libc
    if system == "Linux":
        platform_identifier = "unknown-linux"
-        libc_identifier = "musl" if "musl" in (platform.libc_ver() or ("", "")) else "gnu"
+        libc_identifier = "musl" if _is_musl_libc() else "gnu"
    elif system == "Darwin":
        platform_identifier = "apple-darwin"
    elif system == "Windows":
@@ -81,8 +109,8 @@ def _get_pbs_asset(
    arch_identifier: str,
    platform_identifier: str,
    libc_identifier: str | None,
-) -> tuple[str, str, str]:
-    """Finds the asset, returning (tag, filename, url)."""
+) -> tuple[str, str, str, str]:
+    """Finds the asset, returning (tag, url, filename, sha256)."""
    release_data = get_python_build_standalone_release_data()

    expected_suffix = f"{arch_identifier}-{platform_identifier}"
@@ -100,22 +128,37 @@ def _get_pbs_asset(
                continue

            asset_url = asset["url"]
-            return release["tag"], asset_url, asset_name
+            asset_sha256 = asset.get("sha256", "")
+            return release["tag"], asset_url, asset_name, asset_sha256

    # If loop completes without finding a match
    msg = f"Could not find python-build-standalone release asset matching {asset_pattern!r}."
    raise PythonBuildStandaloneError(msg)


-def _download_or_get_from_cache(asset_url: str, asset_filename: str, cache_dir: Path) -> Path:
+def _download_or_get_from_cache(
+    asset_url: str, asset_filename: str, cache_dir: Path, sha256: str = ""
+) -> Path:
    with FileLock(cache_dir / (asset_filename + ".lock")):
        asset_cache_path = cache_dir / asset_filename
        if asset_cache_path.is_file():
-            print(f"Using cached python_build_standalone: {asset_cache_path}")
-            return asset_cache_path
+            if sha256:
+                computed = hashlib.sha256(asset_cache_path.read_bytes()).hexdigest()
+                if computed != sha256:
+                    print(
+                        f"Cached python_build_standalone SHA256 mismatch for {asset_cache_path}; redownloading."
+                    )
+                    asset_cache_path.unlink(missing_ok=True)
+                else:
+                    print(f"Using cached python_build_standalone: {asset_cache_path}")
+                    return asset_cache_path
+            else:
+                print(f"Using cached python_build_standalone: {asset_cache_path}")
+                return asset_cache_path

        print(f"Downloading python_build_standalone: {asset_url} to {asset_cache_path}")
-        download(asset_url, asset_cache_path)
+        with remove_on_error(asset_cache_path):
+            download(asset_url, asset_cache_path, sha256=sha256 or None)
        return asset_cache_path


@@ -161,7 +204,7 @@ def create_python_build_standalone_environment(

    arch_id, platform_id, libc_id = _get_platform_identifiers()

-    pbs_tag, asset_url, asset_filename = _get_pbs_asset(
+    pbs_tag, asset_url, asset_filename, asset_sha256 = _get_pbs_asset(
        python_version=python_version,
        arch_identifier=arch_id,
        platform_identifier=platform_id,
@@ -171,11 +214,13 @@ def create_python_build_standalone_environment(
    print(f"Using python-build-standalone release: {pbs_tag}")

    archive_path = _download_or_get_from_cache(
-        asset_url=asset_url, asset_filename=asset_filename, cache_dir=cache_dir
+        asset_url=asset_url, asset_filename=asset_filename, cache_dir=cache_dir, sha256=asset_sha256
    )

    python_base_dir = temp_dir / "pbs"
-    assert not python_base_dir.exists()
+    if python_base_dir.exists():
+        msg = f"python-build-standalone directory already exists: {python_base_dir}"
+        raise PythonBuildStandaloneError(msg)
    extract_tar(archive_path, python_base_dir)

    return _find_python_executable(python_base_dir)
--- a/Show More
+++ b/Show More