Use reusable workflow to eliminate setup duplication between test and collateral (#199)

* Initial plan

* Add reusable workflow to share test/collateral setup steps

Agent-Logs-Url: https://github.com/jaraco/skeleton/sessions/ae6f447e-da11-4a46-a8d7-23cdbbffe148

Co-authored-by: jaraco <308610+jaraco@users.noreply.github.com>

* Remove duplicated env block from main.yml

Agent-Logs-Url: https://github.com/jaraco/skeleton/sessions/35bde516-10a9-4b0d-8c1f-6daa390f7011

Co-authored-by: jaraco <308610+jaraco@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: jaraco <308610+jaraco@users.noreply.github.com>

Author: Copilot

.github/workflows/main.yml

@@ -15,19 +15,6 @@ on:
 permissions:
   contents: read
 
-env:
-  # Environment variable to support color support (jaraco/skeleton#66)
-  FORCE_COLOR: 1
-
-  # Suppress noisy pip warnings
-  PIP_DISABLE_PIP_VERSION_CHECK: 'true'
-  PIP_NO_WARN_SCRIPT_LOCATION: 'true'
-
-  # Ensure tests can sense settings about the environment
-  TOX_OVERRIDE: >-
-    testenv.pass_env+=GITHUB_*,FORCE_COLOR
-
-
 jobs:
   test:
     strategy:
@@ -52,26 +39,12 @@ jobs:
           platform: ubuntu-latest
         - python: pypy3.11
           platform: ubuntu-latest
-    runs-on: ${{ matrix.platform }}
+    uses: ./.github/workflows/test-suite.yml
+    with:
+      python: ${{ matrix.python }}
+      platform: ${{ matrix.platform }}
+    # https://docs.github.com/en/actions/writing-workflows/workflow-syntax-for-github-actions#jobsjob_idcontinue-on-error
     continue-on-error: ${{ matrix.python == '3.15' }}
-    steps:
-      - uses: actions/checkout@v4
-      - name: Install build dependencies
-        # Install dependencies for building packages on pre-release Pythons
-        # jaraco/skeleton#161
-        if: matrix.python == '3.15' && matrix.platform == 'ubuntu-latest'
-        run: |
-          sudo apt update
-          sudo apt install -y libxml2-dev libxslt-dev
-      - name: Setup Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python }}
-          allow-prereleases: true
-      - name: Install tox
-        run: python -m pip install tox
-      - name: Run
-        run: tox
 
   collateral:
     strategy:
@@ -80,19 +53,10 @@ jobs:
         job:
         - diffcov
         - docs
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - name: Setup Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: 3.x
-      - name: Install tox
-        run: python -m pip install tox
-      - name: Eval ${{ matrix.job }}
-        run: tox -e ${{ matrix.job }}
+    uses: ./.github/workflows/test-suite.yml
+    with:
+      platform: ubuntu-latest
+      tox-env: ${{ matrix.job }}
 
   check:  # This job does nothing and is only used for the branch protection
     if: always()

.github/workflows/test-suite.yml

@@ -0,0 +1,60 @@
+name: Test Suite
+
+on:
+  workflow_call:
+    inputs:
+      python:
+        description: Python version
+        type: string
+        default: "3.x"
+      platform:
+        description: Runner platform
+        type: string
+        default: ubuntu-latest
+      tox-env:
+        description: >-
+          Tox environment to run; if empty, runs default tox
+        type: string
+        default: ""
+
+env:
+  # Environment variable to support color support (jaraco/skeleton#66)
+  FORCE_COLOR: 1
+
+  # Suppress noisy pip warnings
+  PIP_DISABLE_PIP_VERSION_CHECK: 'true'
+  PIP_NO_WARN_SCRIPT_LOCATION: 'true'
+
+  # Ensure tests can sense settings about the environment
+  TOX_OVERRIDE: >-
+    testenv.pass_env+=GITHUB_*,FORCE_COLOR
+
+jobs:
+  run:
+    runs-on: ${{ inputs.platform }}
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install build dependencies
+        # Install dependencies for building packages on pre-release Pythons
+        # jaraco/skeleton#161
+        if: inputs.python == '3.15' && inputs.platform == 'ubuntu-latest'
+        run: |
+          sudo apt update
+          sudo apt install -y libxml2-dev libxslt-dev
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ inputs.python }}
+          allow-prereleases: true
+      - name: Install tox
+        run: python -m pip install tox
+      - name: Run
+        if: ${{ !inputs.tox-env }}
+        run: tox
+      - name: Run ${{ inputs.tox-env }}
+        if: ${{ inputs.tox-env }}
+        run: tox -e ${{ inputs.tox-env }}