build.yaml.jinja

name: Build Status

on:
  push:
    branches:
      - main
    tags:
      - v*
    paths-ignore:
      - LICENSE
      - README.md
  pull_request:
    branches:
      - main
  workflow_dispatch:

concurrency:
  group: {% raw %}${{ github.workflow }}-${{ github.ref }}{% endraw %}
  cancel-in-progress: true

permissions:
  contents: read
  checks: write
  pull-requests: write

jobs:
  build:
    name: build ({% raw %}${{ matrix.platform.name }}-${{ matrix.python.version }}{% endraw %})
    runs-on: {% raw %}${{ matrix.platform.os }}{% endraw %}

    strategy:
      matrix:
        platform:
          - name: ubuntu-24.04
            os: ubuntu-24.04
          - name: ubuntu-24.04-arm
            os: ubuntu-24.04-arm
          - name: macos-26
            os: macos-26
          - name: windows-2025
            os: windows-2025
        python:
          {% if python_version_primary == "3.10" -%}
          - version: "3.10"
            cibuildwheel: "cp310"
            primary: true
          {% endif -%}
          {% if python_version_primary in ["3.10", "3.11"] -%}
          - version: "3.11"
            cibuildwheel: "cp311"
            primary: {{ (python_version_primary == "3.11") | lower }}
          {% endif -%}
          {% if python_version_primary in ["3.10", "3.11", "3.12"] -%}
          - version: "3.12"
            cibuildwheel: "cp312"
            primary: {{ (python_version_primary == "3.12") | lower }}
          {% endif -%}
          - version: "3.13"
            cibuildwheel: "cp313"
            primary: {{ (python_version_primary == "3.13") | lower }}
        include:
          - target: native
            dist_path: dist
          {% if add_pyodide -%}
          - platform:
              name: pyodide
              os: ubuntu-24.04
            python:
              version: "3.14"
              cibuildwheel: "cp314"
              primary: false
            target: pyodide
            dist_path: dist/pyodide
          {% endif %}

    steps:
      - name: Checkout
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
        with:
          persist-credentials: false

      - name: Setup Python
        uses: actions-ext/python/setup@c8228d827a81b9f8c808825328af361c45461ba3
        with:
          version: {% raw %}${{ matrix.python.version }}{% endraw %}

      - name: Setup C++
        uses: actions-ext/cpp/setup@7de57593fbcba72d513072bfb4b30b5a344aa547

      {% if add_vcpkg -%}
      - name: Setup vcpkg cache
        uses: actions-ext/cpp/setup-vcpkg-cache@7de57593fbcba72d513072bfb4b30b5a344aa547

      {% endif -%}
      - name: Install dependencies
        run: make develop
        if: matrix.target == 'native'

      - name: Lint
        run: make lint
        if: matrix.platform.name == 'ubuntu-24.04' && matrix.python.primary

      - name: Checks
        run: make checks
        if: matrix.platform.name == 'ubuntu-24.04' && matrix.python.primary

      - name: Test
        run: make coverage
        if: matrix.target == 'native'

      - name: Build and test Pyodide wheel
        run: make test-pyodide
        if: matrix.target == 'pyodide'

      - name: Upload test results (Python)
        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9  # v7.0.2
        with:
          name: {% raw %}test-results-${{ matrix.platform.name }}-${{ matrix.python.version }}{% endraw %}
          path: junit.xml
        if: matrix.platform.name == 'ubuntu-24.04' && matrix.python.primary

      - name: Publish test results
        uses: EnricoMi/publish-unit-test-result-action@d0a4676d0e0b938bc201470d88276b7c74c712b3  # v2.24.0
        with:
          files: '**/junit.xml'
        if: matrix.platform.name == 'ubuntu-24.04' && matrix.python.primary

      - name: Upload coverage
        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5  # v7.1.1
        with:
          token: {% raw %}${{ secrets.CODECOV_TOKEN }}{% endraw %}
        if: matrix.target == 'native'

      - name: Install build dependencies
        run: pip install cibuildwheel
        if: matrix.target == 'native'

      - name: Build distributions (Linux x86_64)
        run: |
          rm -rf dist
          make dist-py-sdist
          make dist-py-wheel
          make dist-check
        env:
          CIBW_BUILD: {% raw %}"${{ matrix.python.cibuildwheel }}-manylinux*"{% endraw %}
          CIBW_ARCHS_LINUX: native
          CIBW_BUILD_VERBOSITY: 3
        if: matrix.platform.name == 'ubuntu-24.04'

      - name: Build distributions (Linux ARM64)
        run: |
          rm -rf dist
          make dist-py-wheel
          make dist-check
        env:
          CIBW_BUILD: {% raw %}"${{ matrix.python.cibuildwheel }}-manylinux*"{% endraw %}
          CIBW_ARCHS_LINUX: native
          CIBW_BUILD_VERBOSITY: 3
        if: matrix.platform.name == 'ubuntu-24.04-arm'

      - name: Build distributions (macOS)
        run: |
          rm -rf dist
          make dist-py-wheel
        env:
          CIBW_BUILD: {% raw %}"${{ matrix.python.cibuildwheel }}-macos*"{% endraw %}
          CIBW_BUILD_VERBOSITY: 3
        if: matrix.platform.name == 'macos-26'

      - name: Build distributions (Windows)
        run: |
          if (Test-Path dist) { Remove-Item dist -Recurse -Force }
          make dist-py-wheel
        env:
          CIBW_BUILD: {% raw %}"${{ matrix.python.cibuildwheel }}-win_amd64"{% endraw %}
        if: matrix.platform.name == 'windows-2025'

      - name: Test wheel
        uses: actions-ext/python/test-wheel@c8228d827a81b9f8c808825328af361c45461ba3
        with:
          module: {{module}}
        if: matrix.target == 'native' && runner.os == 'Linux'

      - name: Test source distribution
        uses: actions-ext/python/test-sdist@c8228d827a81b9f8c808825328af361c45461ba3
        with:
          module: {{module}}
        if: matrix.platform.name == 'ubuntu-24.04'

      - name: Upload distributions
        uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9  # v7.0.2
        with:
          name: {% raw %}dist-${{ matrix.platform.name }}-${{ matrix.python.version }}{% endraw %}
          path: {% raw %}${{ matrix.dist_path }}{% endraw %}