workflows: build the versions declared in docs/packages/<pkg>.yaml

Every build-<pkg>.yml and test-<pkg>.yml now calls _setup.yml with its
package name, iterates every job over matrix.version, keys artifacts and
the publish pattern on it, and triggers on pull_request, push to main and
a workflow_dispatch version glob instead of a version literal.

Jobs cannot pass per-leg values through outputs, so the sdist->bdist
workflows name the sdist artifact after the version instead. Workflows
whose git tag differs from the wheel version (v-prefixed tags, rtoml,
fabio, dprint-py, point-cloud-utils, torch's +cpu) derive the tag from the
version; their patch directories follow the wheel version.

Signed-off-by: Ludovic Henry <git@ludovic.dev>

Author: luhenry

.github/workflows/build-adbc-driver-manager.yml

@@ -9,43 +9,56 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: 'adbc-driver-manager version to build (PyPI version, e.g. 1.12.0)'
-        required: true
-        default: '1.12.0'
+        description: 'Version glob to (re)build; empty builds every version of docs/packages/adbc-driver-manager.yaml not released yet'
+        required: false
+        default: ''
   pull_request:
+    branches: [main]
     paths:
       - '.github/workflows/build-adbc-driver-manager.yml'
+      - 'docs/packages/adbc-driver-manager.yaml'
+  push:
+    branches: [main]
+    paths:
+      - '.github/workflows/build-adbc-driver-manager.yml'
+      - 'docs/packages/adbc-driver-manager.yaml'
 
 concurrency:
-  group: ${{ github.workflow }}-${{ inputs.version || '1.12.0' }}-${{ github.head_ref || github.run_id }}
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
   cancel-in-progress: true
 
 permissions:
   contents: read  # to fetch code (actions/checkout)
 
 env:
-  # `inputs.version` is empty on pull_request events; default to 1.12.0 there.
-  ADBC_VERSION: ${{ inputs.version || '1.12.0' }}
   MANYLINUX_RISCV64_IMAGE: quay.io/pypa/manylinux_2_39_riscv64
 
 jobs:
   setup:
     uses: $/.github/workflows/_setup.yml
+    with:
+      package: adbc-driver-manager
+      version: ${{ inputs.version }}
 
   build_wheels:
     needs: [setup]
-    name: Build adbc-driver-manager ${{ inputs.version || '1.12.0' }} ${{ matrix.python }}-manylinux_riscv64
+    if: needs.setup.outputs.versions != '[]'
+    name: Build adbc-driver-manager ${{ matrix.version }} ${{ matrix.python }}-manylinux_riscv64
     runs-on: ubuntu-24.04-riscv
     timeout-minutes: 60
     strategy:
       fail-fast: false
       matrix:
+        version: ${{ fromJSON(needs.setup.outputs.versions) }}
         python:
           - "cp312"
           - "cp313"
           - "cp314"
           - "cp314t"
 
+    env:
+      ADBC_VERSION: ${{ matrix.version }}
+
     steps:
       # The monorepo has no tag that literally embeds the PyPI version (releases are
       # tagged with a sequential counter, e.g. this version is "apache-arrow-adbc-24"),
@@ -86,11 +99,16 @@ jobs:
           if-no-files-found: error
 
   publish:
-    name: Publish adbc-driver-manager ${{ inputs.version || '1.12.0' }}
+    name: Publish adbc-driver-manager ${{ 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
     with:
-      artifact-pattern: adbc-driver-manager-${{ inputs.version || '1.12.0' }}-*-manylinux_riscv64
+      artifact-pattern: adbc-driver-manager-${{ matrix.version }}-*-manylinux_riscv64

.github/workflows/build-adbc-driver-postgresql.yml

@@ -18,38 +18,54 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: 'adbc-driver-postgresql version to build (PyPI version, e.g. 1.12.0)'
-        required: true
-        default: '1.12.0'
+        description: 'Version glob to (re)build; empty builds every version of docs/packages/adbc-driver-postgresql.yaml not released yet'
+        required: false
+        default: ''
   pull_request:
+    branches: [main]
     paths:
       - '.github/workflows/build-adbc-driver-postgresql.yml'
+      - 'docs/packages/adbc-driver-postgresql.yaml'
+  push:
+    branches: [main]
+    paths:
+      - '.github/workflows/build-adbc-driver-postgresql.yml'
+      - 'docs/packages/adbc-driver-postgresql.yaml'
 
 concurrency:
-  group: ${{ github.workflow }}-${{ inputs.version || '1.12.0' }}-${{ github.head_ref || github.run_id }}
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
   cancel-in-progress: true
 
 permissions:
   contents: read  # to fetch code (actions/checkout)
 
 env:
-  # `inputs.version` is empty on pull_request events; default to 1.12.0 there.
-  ADBC_VERSION: ${{ inputs.version || '1.12.0' }}
   MANYLINUX_RISCV64_IMAGE: quay.io/pypa/manylinux_2_39_riscv64
 
 jobs:
   setup:
     uses: $/.github/workflows/_setup.yml
+    with:
+      package: adbc-driver-postgresql
+      version: ${{ inputs.version }}
 
   build_wheels:
     needs: [setup]
-    name: Build adbc-driver-postgresql ${{ inputs.version || '1.12.0' }} py3-none-manylinux_riscv64
+    if: needs.setup.outputs.versions != '[]'
+    strategy:
+      fail-fast: false
+      matrix:
+        version: ${{ fromJSON(needs.setup.outputs.versions) }}
+    name: Build adbc-driver-postgresql ${{ matrix.version }} py3-none-manylinux_riscv64
     runs-on: ubuntu-24.04-riscv
     # vcpkg builds libpq and its dependencies from source (no riscv64 binary
     # cache exists), which alone was exceeding the previous 60-minute budget
     # and getting cancelled at exactly the timeout boundary twice in a row.
     timeout-minutes: 120
 
+    env:
+      ADBC_VERSION: ${{ matrix.version }}
+
     steps:
       - name: Checkout apache/arrow-adbc v${{ env.ADBC_VERSION }}
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
@@ -147,11 +163,16 @@ jobs:
           if-no-files-found: error
 
   publish:
-    name: Publish adbc-driver-postgresql ${{ inputs.version || '1.12.0' }}
+    name: Publish adbc-driver-postgresql ${{ 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
     with:
-      artifact-pattern: adbc-driver-postgresql-${{ inputs.version || '1.12.0' }}-*-manylinux_riscv64
+      artifact-pattern: adbc-driver-postgresql-${{ matrix.version }}-*-manylinux_riscv64

.github/workflows/build-adbc-driver-sqlite.yml

@@ -18,38 +18,54 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: 'adbc-driver-sqlite version to build (PyPI version, e.g. 1.12.0)'
-        required: true
-        default: '1.12.0'
+        description: 'Version glob to (re)build; empty builds every version of docs/packages/adbc-driver-sqlite.yaml not released yet'
+        required: false
+        default: ''
   pull_request:
+    branches: [main]
     paths:
       - '.github/workflows/build-adbc-driver-sqlite.yml'
+      - 'docs/packages/adbc-driver-sqlite.yaml'
+  push:
+    branches: [main]
+    paths:
+      - '.github/workflows/build-adbc-driver-sqlite.yml'
+      - 'docs/packages/adbc-driver-sqlite.yaml'
 
 concurrency:
-  group: ${{ github.workflow }}-${{ inputs.version || '1.12.0' }}-${{ github.head_ref || github.run_id }}
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
   cancel-in-progress: true
 
 permissions:
   contents: read  # to fetch code (actions/checkout)
 
 env:
-  # `inputs.version` is empty on pull_request events; default to 1.12.0 there.
-  ADBC_VERSION: ${{ inputs.version || '1.12.0' }}
   MANYLINUX_RISCV64_IMAGE: quay.io/pypa/manylinux_2_39_riscv64
 
 jobs:
   setup:
     uses: $/.github/workflows/_setup.yml
+    with:
+      package: adbc-driver-sqlite
+      version: ${{ inputs.version }}
 
   build_wheels:
     needs: [setup]
-    name: Build adbc-driver-sqlite ${{ inputs.version || '1.12.0' }} py3-none-manylinux_riscv64
+    if: needs.setup.outputs.versions != '[]'
+    strategy:
+      fail-fast: false
+      matrix:
+        version: ${{ fromJSON(needs.setup.outputs.versions) }}
+    name: Build adbc-driver-sqlite ${{ matrix.version }} py3-none-manylinux_riscv64
     runs-on: ubuntu-24.04-riscv
     # numpy/pandas/pyarrow/adbc-driver-manager download for the test step alone takes
     # ~an hour on this runner (same as adbc-driver-postgresql's identical install line),
     # even though the driver build itself is fast with no vcpkg compile involved.
     timeout-minutes: 90
 
+    env:
+      ADBC_VERSION: ${{ matrix.version }}
+
     steps:
       - name: Checkout apache/arrow-adbc v${{ env.ADBC_VERSION }}
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
@@ -138,11 +154,16 @@ jobs:
           if-no-files-found: error
 
   publish:
-    name: Publish adbc-driver-sqlite ${{ inputs.version || '1.12.0' }}
+    name: Publish adbc-driver-sqlite ${{ 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
     with:
-      artifact-pattern: adbc-driver-sqlite-${{ inputs.version || '1.12.0' }}-*-manylinux_riscv64
+      artifact-pattern: adbc-driver-sqlite-${{ matrix.version }}-*-manylinux_riscv64

.github/workflows/build-aggdraw.yml

@@ -9,38 +9,52 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: 'aggdraw version to build (git tag without leading v, e.g. 1.4.1)'
-        required: true
-        default: '1.4.1'
+        description: 'Version glob to (re)build; empty builds every version of docs/packages/aggdraw.yaml not released yet'
+        required: false
+        default: ''
   pull_request:
+    branches: [main]
     paths:
       - '.github/workflows/build-aggdraw.yml'
+      - 'docs/packages/aggdraw.yaml'
+  push:
+    branches: [main]
+    paths:
+      - '.github/workflows/build-aggdraw.yml'
+      - 'docs/packages/aggdraw.yaml'
 
 concurrency:
-  group: ${{ github.workflow }}-${{ inputs.version || '1.4.1' }}-${{ github.head_ref || github.run_id }}
+  group: ${{ github.workflow }}-${{ github.head_ref || github.run_id }}
   cancel-in-progress: true
 
 permissions:
   contents: read  # to fetch code (actions/checkout)
 
 env:
-  AGGDRAW_VERSION: ${{ inputs.version || '1.4.1' }}
   MANYLINUX_RISCV64_IMAGE: quay.io/pypa/manylinux_2_39_riscv64
 
 jobs:
   setup:
     uses: $/.github/workflows/_setup.yml
+    with:
+      package: aggdraw
+      version: ${{ inputs.version }}
 
   build_wheels:
     needs: [setup]
-    name: Build aggdraw ${{ inputs.version || '1.4.1' }} ${{ matrix.python }}-manylinux_riscv64
+    if: needs.setup.outputs.versions != '[]'
+    name: Build aggdraw ${{ matrix.version }} ${{ matrix.python }}-manylinux_riscv64
     runs-on: ubuntu-24.04-riscv
     timeout-minutes: 90
     strategy:
       fail-fast: false
       matrix:
+        version: ${{ fromJSON(needs.setup.outputs.versions) }}
         python: ["cp312", "cp313", "cp314", "cp314t"]
 
+    env:
+      AGGDRAW_VERSION: ${{ matrix.version }}
+
     steps:
       - name: Checkout aggdraw v${{ env.AGGDRAW_VERSION }}
         uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
@@ -74,11 +88,16 @@ jobs:
           if-no-files-found: error
 
   publish:
-    name: Publish aggdraw ${{ inputs.version || '1.4.1' }}
+    name: Publish aggdraw ${{ 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
     with:
-      artifact-pattern: aggdraw-${{ inputs.version || '1.4.1' }}-*-manylinux_riscv64
+      artifact-pattern: aggdraw-${{ matrix.version }}-*-manylinux_riscv64