ci: expand full matrix triggers

Signed-off-by: Georg Heiler <georg.kf.heiler@gmail.com>

Author: geoHeil

.github/workflows/cd.yml

@@ -11,6 +11,9 @@ jobs:
     uses: ./.github/workflows/checks.yml
     with:
       push_coverage: false
+      force_all_checks: true
+      run_package_compat: true
+      python_versions: '["3.10", "3.11", "3.12", "3.13", "3.14"]'
   pre-release-check:
     runs-on: ubuntu-latest
     outputs:

.github/workflows/checks.yml

@@ -9,6 +9,18 @@ on:
         type: boolean
         description: "If true, run the full lint job in this workflow."
         default: true
+      force_all_checks:
+        type: boolean
+        description: "If true, run all test/example/package lanes regardless of changed-path filters."
+        default: false
+      run_package_compat:
+        type: boolean
+        description: "If true, run the cross-version package compatibility lanes."
+        default: false
+      python_versions:
+        type: string
+        description: 'JSON array of Python versions to use for multi-version jobs, e.g. ["3.10", "3.12"].'
+        default: '["3.10", "3.11", "3.12", "3.13", "3.14"]'
     secrets:
       CODECOV_TOKEN:
         required: false
@@ -33,15 +45,25 @@ jobs:
       contents: read
       pull-requests: read
     outputs:
-      run_tests: ${{ steps.filter.outputs.run_tests }}
-      run_examples: ${{ steps.filter.outputs.run_examples }}
-      run_package: ${{ steps.filter.outputs.run_package }}
+      run_tests: ${{ steps.force.outputs.run_tests || steps.filter.outputs.run_tests }}
+      run_examples: ${{ steps.force.outputs.run_examples || steps.filter.outputs.run_examples }}
+      run_package: ${{ steps.force.outputs.run_package || steps.filter.outputs.run_package }}
     steps:
+      - name: Force all lanes
+        if: ${{ inputs.force_all_checks }}
+        id: force
+        run: |
+          echo "run_tests=true" >> "$GITHUB_OUTPUT"
+          echo "run_examples=true" >> "$GITHUB_OUTPUT"
+          echo "run_package=true" >> "$GITHUB_OUTPUT"
+
       - uses: actions/checkout@v6
+        if: ${{ !inputs.force_all_checks }}
         with:
           fetch-depth: 0
 
       - name: Detect changed paths
+        if: ${{ !inputs.force_all_checks }}
         id: filter
         uses: dorny/paths-filter@v3
         with:
@@ -113,7 +135,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        python-version: ${{ fromJSON(inputs.python_versions) }}
     steps:
       - uses: actions/checkout@v6
 
@@ -182,7 +204,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        python-version: ${{ fromJSON(inputs.python_versions) }}
     steps:
       - uses: actions/checkout@v6
 
@@ -256,7 +278,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        python-version: ${{ fromJSON(inputs.python_versions) }}
     steps:
       - uses: actions/checkout@v6
 
@@ -344,17 +366,19 @@ jobs:
 
   test-pip-install-no-lock:
     needs: changes
-    if: ${{ needs.changes.outputs.run_package == 'true' }}
+    if: ${{ inputs.run_package_compat && needs.changes.outputs.run_package == 'true' }}
     runs-on: ubuntu-latest
+    env:
+      SELECTED_PYTHON_VERSIONS: ${{ join(fromJSON(inputs.python_versions), ' ') }}
     steps:
       - uses: actions/checkout@v5
 
       - name: Install uv
         uses: astral-sh/setup-uv@v6
 
-      - name: Test pip install across Python versions
+      - name: Test pip install across selected Python versions
         run: |
-          for py_version in 3.10 3.11 3.12 3.13 3.14; do
+          for py_version in $SELECTED_PYTHON_VERSIONS; do
             echo "=========================================="
             echo "Testing Python $py_version"
             echo "=========================================="
@@ -379,17 +403,19 @@ jobs:
 
   test-pip-install-no-dev-headers:
     needs: changes
-    if: ${{ needs.changes.outputs.run_package == 'true' }}
+    if: ${{ inputs.run_package_compat && needs.changes.outputs.run_package == 'true' }}
     runs-on: ubuntu-latest
+    env:
+      SELECTED_PYTHON_VERSIONS: ${{ join(fromJSON(inputs.python_versions), ' ') }}
     steps:
       - uses: actions/checkout@v5
 
       - name: Install uv
         uses: astral-sh/setup-uv@v6
 
-      - name: Test pip install without dev headers across Python versions
+      - name: Test pip install without dev headers across selected Python versions
         run: |
-          for py_version in 3.10 3.11 3.12 3.13 3.14; do
+          for py_version in $SELECTED_PYTHON_VERSIONS; do
             echo "=========================================="
             echo "Testing Python $py_version (no dev headers)"
             echo "=========================================="

.github/workflows/ci-main.yml

@@ -0,0 +1,23 @@
+name: "Run CI Main"
+
+on:
+  push:
+    branches:
+      - "main"
+  schedule:
+    - cron: "17 3 * * *"
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  code-checks:
+    uses: ./.github/workflows/checks.yml
+    with:
+      run_lint: true
+      force_all_checks: true
+      run_package_compat: true
+      python_versions: '["3.10", "3.11", "3.12", "3.13", "3.14"]'
+    secrets:
+      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/ci.yml

@@ -2,12 +2,19 @@ name: "Run CI"
 
 on:
   pull_request:
-    types: [opened, reopened, synchronize]
+    types: [opened, reopened, synchronize, labeled, unlabeled]
   push:
     branches:
       - "**"
       - "!main"
       - "!gh-pages"
+  workflow_dispatch:
+    inputs:
+      python_versions:
+        description: 'JSON array of Python versions to run, e.g. ["3.10"] or ["3.10", "3.12", "3.14"].'
+        required: true
+        default: '["3.10", "3.11", "3.12", "3.13", "3.14"]'
+        type: string
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
@@ -20,13 +27,21 @@ jobs:
       contents: read
       pull-requests: read
     outputs:
-      run_ci: ${{ steps.filter.outputs.run_ci }}
+      run_ci: ${{ steps.manual.outputs.run_ci || steps.filter.outputs.run_ci }}
+      full_matrix_override: ${{ steps.filter.outputs.full_matrix_override }}
     steps:
+      - name: Mark manual runs to execute CI
+        if: ${{ github.event_name == 'workflow_dispatch' }}
+        id: manual
+        run: echo "run_ci=true" >> "$GITHUB_OUTPUT"
+
       - uses: actions/checkout@v6
+        if: ${{ github.event_name != 'workflow_dispatch' }}
         with:
           fetch-depth: 0
 
       - name: Detect changed paths
+        if: ${{ github.event_name != 'workflow_dispatch' }}
         id: filter
         uses: dorny/paths-filter@v3
         with:
@@ -45,12 +60,60 @@ jobs:
               - "docling/**"
               - "tests/**"
               - "docs/examples/**"
+            full_matrix_override:
+              - ".github/workflows/ci.yml"
+              - ".github/workflows/checks.yml"
+              - "pyproject.toml"
+              - "uv.lock"
+              - "README.md"
+              - "LICENSE"
 
   code-checks:
     needs: changes
-    if: ${{ needs.changes.outputs.run_ci == 'true' && (github.event_name == 'push' || (github.event.pull_request.head.repo.full_name != 'docling-project/docling' && github.event.pull_request.head.repo.full_name != 'docling-project/docling')) }}
+    if: >-
+      ${{
+        needs.changes.outputs.run_ci == 'true' &&
+        (
+          github.event_name == 'workflow_dispatch' ||
+          github.event_name == 'push' ||
+          (
+            github.event_name == 'pull_request' &&
+            (
+              github.event.pull_request.head.repo.full_name != github.repository ||
+              contains(github.event.pull_request.labels.*.name, 'tests:full')
+            )
+          )
+        )
+      }}
     uses: ./.github/workflows/checks.yml
     with:
-      run_lint: ${{ github.event_name == 'push' }}
+      run_lint: ${{ github.event_name != 'pull_request' }}
+      force_all_checks: ${{ github.event_name == 'workflow_dispatch' }}
+      run_package_compat: >-
+        ${{
+          github.event_name == 'workflow_dispatch' ||
+          needs.changes.outputs.full_matrix_override == 'true' ||
+          (
+            github.event_name == 'pull_request' &&
+            contains(github.event.pull_request.labels.*.name, 'tests:full')
+          )
+        }}
+      python_versions: >-
+        ${{
+          (
+            github.event_name == 'workflow_dispatch' &&
+            inputs.python_versions
+          ) ||
+          (
+            needs.changes.outputs.full_matrix_override == 'true' &&
+            '["3.10", "3.11", "3.12", "3.13", "3.14"]'
+          ) ||
+          (
+            github.event_name == 'pull_request' &&
+            contains(github.event.pull_request.labels.*.name, 'tests:full') &&
+            '["3.10", "3.11", "3.12", "3.13", "3.14"]'
+          ) ||
+          '["3.10"]'
+        }}
     secrets:
       CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}