github/workflows: Add examples job

- Introduced a new `examples` job targeting Python versions 3.10 to 3.14.
  - Runs example sessions using `nox` and caches dependencies for efficiency.
- Updated the `publish` job to depend on the newly added `examples` workflow.

Author: datalogics-kam

.github/workflows/test-and-publish.yml

@@ -39,9 +39,38 @@ jobs:
         env:
           PDFREST_API_KEY: ${{ secrets.PDFREST_API_KEY }}
 
+  examples:
+    name: Examples (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    permissions:
+      id-token: write
+      contents: read
+      packages: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          version: 0.8.22
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+          cache-suffix: test-and-publish
+          cache-dependency-glob: uv.lock
+      - name: Run examples with nox
+        run: uvx nox --python ${{ matrix.python-version }} --session examples
+        env:
+          PDFREST_API_KEY: ${{ secrets.PDFREST_API_KEY }}
+
   publish:
     name: Publish to CodeArtifact
-    needs: tests
+    needs:
+      - tests
+      - examples
     if: github.event_name == 'release'
     runs-on: ubuntu-latest
     permissions: