Check CAPI ext binary compatibility

Author: nobu

.github/actions/capiext/action.yml

@@ -0,0 +1,44 @@
+name: rubyspec C-API extensions
+
+inputs:
+  builddir:
+    required: false
+    default: '.'
+
+outputs:
+  key:
+    value: >-
+      ${{
+      !steps.restore.outputs.cache-hit &&
+      github.ref == 'refs/heads/master' &&
+      steps.config.outputs.key
+      }}
+
+runs:
+  using: composite
+
+  steps:
+    - id: config
+      shell: bash
+      run: |
+        eval $(grep -e '^arch *=' -e '^ruby_version *=' -e '^DLEXT *=' Makefile |
+            sed 's/ *= */=/')
+        key=capiexts-${arch}-${ruby_version}
+        echo key=$key >> $GITHUB_OUTPUT
+        echo DLEXT=$DLEXT >> $GITHUB_OUTPUT
+      working-directory: ${{ inputs.builddir }}
+
+    - name: CAPI extensions cache
+      uses: actions/cache@0400d5f644dc74513175e3cd8d07132dd4860809 # v4.2.4
+      id: cache
+      with:
+        path: ${{ inputs.builddir }}/spec/ruby/optional/capi/ext/
+        key: ${{ steps.config.outputs.key }}
+
+    - name: Force rubyspec CAPI extension binaries up to date
+      shell: bash
+      run: |
+        touch ${{ inputs.builddir }}/spec/ruby/optional/capi/ext/*.$DLEXT
+      env:
+        DLEXT: ${{ steps.config.outputs.DLEXT }}
+      if: ${{ steps.cache.outputs.cache-hit }}

.github/workflows/macos.yml

@@ -45,6 +45,7 @@ jobs:
             os: macos-14
           - test_task: check
             os: macos-15
+            capi_check: true
           - test_task: check
             os: macos-13
       fail-fast: false
@@ -159,6 +160,19 @@ jobs:
         if: ${{ matrix.test_task == 'check' && matrix.skipped_tests }}
         continue-on-error: ${{ matrix.continue-on-skipped_tests || false }}
 
+      - name: CAPI extensions
+        uses: ./.github/actions/capiext
+        with:
+          builddir: build
+        if: ${{ matrix.capi_check }}
+
+      - name: Check with previous CAPI extensions
+        run: |
+          make -s test-spec
+        env:
+          RUBY_TESTOPTS: '-v --tty=no'
+        if: ${{ matrix.capi_check }}
+
       - uses: ./.github/actions/slack
         with:
           label: ${{ matrix.os }} / ${{ matrix.test_task }}

.github/workflows/ubuntu.yml

@@ -39,6 +39,7 @@ jobs:
           - test_task: test-bundled-gems
           - test_task: check
             os: ubuntu-24.04
+            capi_check: true
           # ubuntu-24.04-arm jobs don't start on ruby/ruby as of 2025-09-04
           #- test_task: check
           #  os: ubuntu-24.04-arm
@@ -152,6 +153,19 @@ jobs:
           DESTDIR=${RUNNER_TEMP-${TMPDIR-/tmp}}/installed
           $SETARCH make test-pc "DESTDIR=$DESTDIR"
 
+      - name: CAPI extensions
+        uses: ./.github/actions/capiext
+        with:
+          builddir: build
+        if: ${{ matrix.capi_check }}
+
+      - name: Check with previous CAPI extensions
+        run: |
+          $SETARCH make -s test-spec
+        env:
+          RUBY_TESTOPTS: '-v --tty=no'
+        if: ${{ matrix.capi_check }}
+
       - uses: ./.github/actions/slack
         with:
           label: ${{ matrix.test_task }} ${{ matrix.configure }}${{ matrix.arch }}