feat: Optimize CI by conditionally running schema generation tests

.github/workflows/test.yml

@@ -12,6 +12,23 @@ permissions:
   contents: read
 
 jobs:
+  # Determine which tests to run based on changed files
+  changes:
+    runs-on: ubuntu-latest
+    outputs:
+      schema-generation: ${{ steps.filter.outputs.schema-generation }}
+    steps:
+    - uses: actions/checkout@v4
+    - uses: dorny/paths-filter@v3
+      id: filter
+      with:
+        filters: |
+          schema-generation:
+            - 'src/allotropy/allotrope/schemas/**'
+            - 'src/allotropy/allotrope/schema_parser/**'
+            - 'src/allotropy/allotrope/models/**'
+            - 'tests/allotrope/schema_parser/generate_schemas_test.py'
+            - 'pyproject.toml'
   test_py_310:
     runs-on: ubuntu-latest
     name: Tests (python 3.10)
@@ -27,9 +44,9 @@ jobs:
       run: pip install "hatch>=1.13.0"
     - name: Install click
       run: pip install click!=8.3.0
-    - name: Run Tests
-      run: hatch run test_all.py3.10:pytest -n 2 tests
-      timeout-minutes: 15
+    - name: Run Tests (excluding schema generation)
+      run: hatch run test_all.py3.10:pytest -n 2 tests --ignore=tests/allotrope/schema_parser/generate_schemas_test.py
+      timeout-minutes: 10
 
   test_py_311:
     runs-on: ubuntu-latest
@@ -47,9 +64,9 @@ jobs:
     # NOTE: due to bug: https://github.com/pallets/click/issues/3066
     - name: Install click
       run: pip install click!=8.3.0
-    - name: Run Tests
-      run: hatch run test_all.py3.11:pytest -n 2 tests
-      timeout-minutes: 15
+    - name: Run Tests (excluding schema generation)
+      run: hatch run test_all.py3.11:pytest -n 2 tests --ignore=tests/allotrope/schema_parser/generate_schemas_test.py
+      timeout-minutes: 10
 
   test_py_312:
     runs-on: ubuntu-latest
@@ -66,9 +83,35 @@ jobs:
       run: pip install "hatch>=1.13.0"
     - name: Install click
       run: pip install click!=8.3.0
-    - name: Run Tests
-      run: hatch run test_all.py3.12:pytest -n 2 tests
-      timeout-minutes: 15
+    - name: Run Tests (excluding schema generation)
+      run: hatch run test_all.py3.12:pytest -n 2 tests --ignore=tests/allotrope/schema_parser/generate_schemas_test.py
+      timeout-minutes: 10
+
+  # Schema generation test - only runs when relevant files change or on main branch
+  schema_generation_test:
+    needs: changes
+    # Always run on main branch, otherwise only when schema files change
+    if: ${{ github.ref == 'refs/heads/main' || needs.changes.outputs.schema-generation == 'true' }}
+    runs-on: ubuntu-latest
+    name: Schema Generation Test
+    strategy:
+      matrix:
+        python-version: ["3.10"]  # Only run on one Python version since output is the same
+
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        lfs: true
+    - uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install hatch
+      run: pip install "hatch>=1.13.0"
+    - name: Install click
+      run: pip install click!=8.3.0
+    - name: Run Schema Generation Test
+      run: hatch run test_all.py${{ matrix.python-version }}:pytest tests/allotrope/schema_parser/generate_schemas_test.py -v
+      timeout-minutes: 5
 
   lint:
     runs-on: ubuntu-latest