From 60ac1dcea692bd391085120af3d5934ac2a9e5a6 Mon Sep 17 00:00:00 2001
From: Saqib Khan <11544614+saqibkh@users.noreply.github.com>
Date: Sun, 27 Sep 2026 22:37:23 -0500
Subject: [PATCH] CI: unit and regression tests on a simulated GPU

ccpp.yml builds GPUJPEG on runners with no GPU, so nothing that encodes
or decodes runs in CI. A new workflow runs the unit tests and the
regression suite on a simulated NVIDIA T4 (PantheonSim, via
setup-pantheonsim), on pushes and pull requests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .github/workflows/simulated-gpu.yml | 44 +++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 .github/workflows/simulated-gpu.yml

diff --git a/.github/workflows/simulated-gpu.yml b/.github/workflows/simulated-gpu.yml
new file mode 100644
index 00000000..405f947f
--- /dev/null
+++ b/.github/workflows/simulated-gpu.yml
@@ -0,0 +1,44 @@
+name: Tests on a simulated GPU
+
+# GitHub's runners have no GPU, so ccpp.yml builds GPUJPEG but cannot run
+# anything that encodes or decodes. PantheonSim simulates an NVIDIA T4 on the
+# runner's CPU, so the unit tests and the regression suite run here, on every
+# push and pull request. It checks results, not speed; a real GPU is still the
+# final word.
+on:
+  push:
+    branches:
+      - devel
+      - master
+  pull_request:
+
+# The simulated-GPU job reads the repository and nothing else. The
+# simulator's action uses no token or secrets, and installs packages only from
+# Ubuntu and NVIDIA.
+permissions:
+  contents: read
+
+jobs:
+  tests:
+    runs-on: ubuntu-24.04
+    steps:
+    - uses: actions/checkout@main
+    - name: Simulated GPU (NVIDIA T4) and Ubuntu's CUDA toolkit
+      uses: pantheongpu/setup-pantheonsim@052a0ac31bf6ec72a471d51aae29b7cbd090c6bf # v0.1.1
+      with:
+        gpu: nvidia/t4
+        # Link against the toolkit's own libcudart: libgpujpeg references its
+        # OpenGL interop calls even when OpenGL is off. Only `vgpu run` below
+        # reaches the simulated GPU.
+        library-path: false
+    - name: Tools the regression suite compares images with
+      run: sudo apt-get install -y imagemagick ffmpeg
+    # The simulator stands in for the CUDA runtime at run time, so the library
+    # links the shared one; 75 carries PTX for the simulated T4.
+    - name: Build
+      run: |
+        cmake -Bbuild -DCMAKE_BUILD_TYPE=Release -DCMAKE_CUDA_ARCHITECTURES=75 \
+          -DCMAKE_CUDA_RUNTIME_LIBRARY=Shared -DENABLE_FPNGE=ON
+        cmake --build build --parallel
+    - name: Unit and regression tests on the simulated GPU
+      run: vgpu run ctest --test-dir build -R 'unittests|regression' --output-on-failure