build-rigour.yml

# SPDX-FileCopyrightText: 2026 The RISE Project
# SPDX-License-Identifier: MIT
---
# This workflow is based on the `linux`/`sdist` jobs of
# https://github.com/opensanctions/rigour/blob/v2.4.1/.github/workflows/build.yml
name: Build rigour wheels (riscv64)

on:
  workflow_dispatch:
    inputs:
      version:
        description: 'Version glob to (re)build; empty builds every version of docs/packages/rigour.yaml not released yet'
        required: false
        default: ''
  pull_request:
    branches: [main]
    paths:
      - '.github/workflows/build-rigour.yml'
      - 'docs/packages/rigour.yaml'
  push:
    branches: [main]
    paths:
      - '.github/workflows/build-rigour.yml'
      - 'docs/packages/rigour.yaml'

concurrency:
  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
  cancel-in-progress: true

permissions:
  contents: read  # to fetch code (actions/checkout)

env:
  MANYLINUX_RISCV64_IMAGE: quay.io/pypa/manylinux_2_39_riscv64

jobs:
  setup:
    uses: $/.github/workflows/_setup.yml
    with:
      package: rigour
      version: ${{ inputs.version }}

  build_wheels:
    needs: [setup]
    if: needs.setup.outputs.versions != '[]'
    name: Build rigour ${{ matrix.version }} ${{ matrix.python }}-manylinux_riscv64
    runs-on: ubuntu-24.04-riscv
    # Siblings on the same dependency graph finish in ~35-40 minutes; cp312
    # was cancelled at 90 minutes stuck mid-compile on a small crate
    # (thiserror) while every other interpreter passed well under that
    # budget, so it reads as runner contention, not a genuinely slower
    # build. Bumped for headroom.
    timeout-minutes: 120
    strategy:
      fail-fast: false
      matrix:
        version: ${{ fromJSON(needs.setup.outputs.versions) }}
        # rigour's pyo3 dependency has a plain `pyo3/extension-module` feature
        # (no abi3-pyNN in [tool.maturin] features), so every interpreter needs
        # its own build. Upstream builds cp310-cp314 only (no cp314t), so the
        # matrix mirrors that.
        include:
          - python: cp310
            # rigour/dates.py calls datetime.fromisoformat() directly on
            # values with a "Z" suffix or a colonless UTC offset; that only
            # parses starting with the relaxed ISO 8601 support Python 3.11
            # added (bpo-41412) - Python 3.10's fromisoformat rejects both,
            # so these two tests fail identically on any OS, not just
            # riscv64. Upstream's own lint-test job never notices because it
            # runs pytest on 3.14 only. Everything else in the suite passes.
            pytest_k: "not test_utc_suffixes and not test_non_utc_offsets_are_converted"
          - python: cp311
            pytest_k: ""
          - python: cp312
            pytest_k: ""
          - python: cp313
            pytest_k: ""
          - python: cp314
            pytest_k: ""

    env:
      RIGOUR_VERSION: ${{ matrix.version }}

    steps:
      - name: Checkout rigour v${{ env.RIGOUR_VERSION }}
        uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
        with:
          repository: opensanctions/rigour
          ref: v${{ env.RIGOUR_VERSION }}
          persist-credentials: false

      - name: Build and test wheel
        uses: pypa/cibuildwheel@1828c10ab37f080699c7b81cea34097c684a7074  # v4.2.0
        env:
          CIBW_ARCHS: riscv64
          # musllinux can't build: rustup.rs ships no riscv64 musl toolchain.
          CIBW_BUILD: ${{ matrix.python }}-manylinux_riscv64
          CIBW_MANYLINUX_RISCV64_IMAGE: ${{ env.MANYLINUX_RISCV64_IMAGE }}
          # rigour ships no [tool.cibuildwheel], so the Rust toolchain its
          # maturin backend needs is installed in-container here. libicu-devel
          # is also needed at test-install time: rigour's runtime dependency
          # normality hard-requires pyicu, which has no riscv64 wheel on
          # public PyPI or our registry, so pip builds it from sdist; Rocky
          # 10's libicu-devel lives in appstream (not EPEL, which is empty on
          # riscv64 per gotcha 51), so it installs without enabling any extra
          # repo.
          CIBW_BEFORE_ALL_LINUX: >-
            curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y &&
            dnf install -y libicu-devel
          CIBW_ENVIRONMENT_LINUX: >-
            PATH="$PATH:$HOME/.cargo/bin"
            PIP_EXTRA_INDEX_URL=https://pypi.riseproject.dev/simple/
          # typing_extensions isn't in pyproject.toml's [project] dependencies,
          # but rigour/ids/__init__.py imports it unconditionally; upstream's
          # own lint-test job never notices because mypy (a [dev] extra) pulls
          # it in transitively.
          CIBW_TEST_REQUIRES: pytest typing_extensions
          # Build-from-checkout: rigour/ sits at the repo root next to tests/,
          # and tests/__init__.py makes it a package, so pytest's default
          # rootdir-prepend import mode would shadow the installed wheel with
          # the checkout's own source (testing-and-shadowing gotcha 25).
          # test-sources copies just tests/ into an empty cwd to avoid that.
          CIBW_TEST_SOURCES: tests
          # tests/test_genscripts.py imports the repo-root genscripts/ dev-tooling
          # package (data-table generators for maintainers), which test-sources
          # deliberately doesn't stage; it's not part of the installed wheel, so
          # ignore it rather than staging more to satisfy an unrelated import.
          CIBW_TEST_COMMAND: >-
            python -c "import rigour._core as m; assert m.__file__.endswith('.so'), m.__file__" &&
            python -m pytest -v tests --ignore=tests/test_genscripts.py -k "${{ matrix.pytest_k }}"

      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
        with:
          name: rigour-${{ env.RIGOUR_VERSION }}-${{ matrix.python }}-manylinux_riscv64
          path: ./wheelhouse/*.whl
          if-no-files-found: error

  publish:
    name: Publish rigour ${{ matrix.version }}
    needs: [setup, build_wheels]
    if: needs.setup.outputs.versions != '[]'
    strategy:
      fail-fast: false
      matrix:
        version: ${{ fromJSON(needs.setup.outputs.versions) }}
    permissions:
      contents: write
      pull-requests: write
    uses: $/.github/workflows/_publish-wheel.yml
    secrets:
      app-private-key: ${{ secrets.RISEPROJECT_APP_PRIVATE_KEY }}
    with:
      artifact-pattern: rigour-${{ matrix.version }}-*-manylinux_riscv64