PECOS-packages · ciaranra · Feb 23, 2026 · Jan 7, 2026 · Jan 7, 2026 · Jan 7, 2026
@@ -0,0 +1,120 @@
+# CUDA Build Check - Verifies CUDA-related crates compile correctly
+# Note: Full runtime testing requires cuQuantum SDK which is not available in CI
+# For actual GPU testing, use a self-hosted runner with CUDA and cuQuantum installed
+
+name: CUDA Build Check
+
+env:
+  RUSTFLAGS: -C debuginfo=0
+  RUST_BACKTRACE: 1
+
+on:
+  push:
+    branches: [ "main", "master", "development", "dev" ]
+    paths:
+      - 'crates/pecos-cuquantum/**'
+      - 'crates/pecos-cuquantum-sys/**'
+      - 'python/pecos-rslib-cuda/**'
+      - '.github/workflows/cuda-build-check.yml'
+  pull_request:
+    branches: [ "main", "master", "development", "dev" ]
+    paths:
+      - 'crates/pecos-cuquantum/**'
+      - 'crates/pecos-cuquantum-sys/**'
+      - 'python/pecos-rslib-cuda/**'
+      - '.github/workflows/cuda-build-check.yml'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  cuda-build-check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Free disk space
+        run: |
+          sudo rm -rf /usr/share/dotnet /usr/local/lib/android /opt/ghc
+          sudo apt-get clean
+          df -h
+
+      - name: Install Rust
+        run: |
+          curl https://sh.rustup.rs -sSf | sh -s -- -y
+          echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+          export PATH="$HOME/.cargo/bin:$PATH"
+
+      - name: Set up Rust
+        run: rustup override set stable && rustup update
+
+      - name: Cache Rust
+        uses: Swatinem/rust-cache@v2
+        with:
+          save-if: ${{ github.ref_name == 'main' || github.ref_name == 'master' || github.ref_name == 'development' || github.ref_name == 'dev' }}
+
+      - name: Install CUDA Toolkit
+        uses: Jimver/[email protected]
+        id: cuda-toolkit
+        with:
+          cuda: '12.6.3'
+          method: 'network'
+          sub-packages: '["nvcc", "cudart-dev"]'
+          non-cuda-sub-packages: '["libcublas", "libcublas-dev"]'
+
+      - name: Check pecos-cuquantum-sys compiles (stub mode)
+        run: |
+          echo "Building pecos-cuquantum-sys (will use stubs since cuQuantum SDK is not installed)..."
+          cargo check -p pecos-cuquantum-sys
+
+      - name: Check pecos-cuquantum compiles (stub mode)
+        run: |
+          echo "Building pecos-cuquantum (will use stubs since cuQuantum SDK is not installed)..."
+          cargo check -p pecos-cuquantum
+
+      - name: Check pecos-rslib-cuda compiles (stub mode)
+        run: |
+          echo "Building pecos-rslib-cuda Python bindings..."
+          cargo check -p pecos-rslib-cuda
+
+      - name: Run clippy on CUDA crates
+        run: |
+          echo "Running clippy on CUDA crates..."
+          cargo clippy -p pecos-cuquantum-sys -p pecos-cuquantum -p pecos-rslib-cuda -- -D warnings
+
+      - name: Verify stub mode detection
+        run: |
+          echo "Verifying that build correctly detects stub mode..."
+          # The crates should compile but is_cuquantum_available() should return false
+          cargo build -p pecos-cuquantum --release
+          # Note: We can't actually run the binary to test is_cuquantum_available()
+          # because it requires the cuQuantum runtime, but the build succeeding
+          # in stub mode means the detection is working
+
+  # Documentation for setting up GPU testing
+  cuda-testing-info:
+    runs-on: ubuntu-latest
+    steps:
+      - name: CUDA Testing Requirements
+        run: |
+          echo "=============================================="
+          echo "CUDA GPU Testing Requirements"
+          echo "=============================================="
+          echo ""
+          echo "Full runtime tests for pecos-rslib-cuda require:"
+          echo "  1. NVIDIA GPU with CUDA support"
+          echo "  2. CUDA Toolkit 12.x installed"
+          echo "  3. cuQuantum SDK installed"
+          echo ""
+          echo "To run GPU tests locally:"
+          echo "  1. Install CUDA Toolkit: https://developer.nvidia.com/cuda-downloads"
+          echo "  2. Install cuQuantum SDK: https://developer.nvidia.com/cuquantum-sdk"
+          echo "  3. Run: cargo test -p pecos-cuquantum --features cuda"
+          echo "  4. Build Python package: maturin develop -m python/pecos-rslib-cuda/Cargo.toml"
+          echo ""
+          echo "For self-hosted CI runners with GPU support:"
+          echo "  - Use runners labeled with 'cuda' or 'gpu'"
+          echo "  - Ensure cuQuantum SDK is pre-installed"
+          echo "  - Run: cargo test -p pecos-cuquantum"
+          echo "=============================================="
@@ -41,10 +41,10 @@ jobs:
         go-version: ["stable"]  # Latest stable (experimental bindings)
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
 
     - name: Set up Go ${{ matrix.go-version }}
-      uses: actions/setup-go@v5
+      uses: actions/setup-go@v6
       with:
         go-version: ${{ matrix.go-version }}
 

@@ -22,7 +22,7 @@ jobs:
   check-go-versions:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
 
     - name: Check Go package consistency
       run: |

@@ -96,7 +96,7 @@ jobs:
             architecture: x86_64
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           ref: ${{ inputs.sha || github.sha }}
 
@@ -107,7 +107,7 @@ jobs:
         if: runner.os != 'Windows'
         run: |
           echo "Installing LLVM using pecos..."
-          cargo run -p pecos --features cli --release -- llvm install
+          cargo run -p pecos --features cli --release -- install llvm
 
           echo "Setting LLVM environment variables..."
           export PECOS_LLVM=$(cargo run -p pecos --features cli --release -- llvm find 2>/dev/null)
@@ -124,7 +124,7 @@ jobs:
         shell: pwsh
         run: |
           Write-Host "Installing LLVM using pecos..."
-          cargo run -p pecos --features cli --release -- llvm install
+          cargo run -p pecos --features cli --release -- install llvm
 
           Write-Host "Setting LLVM environment variables..."
           $env:PECOS_LLVM = (cargo run -p pecos --features cli --release -- llvm find 2>$null)
@@ -259,7 +259,7 @@ jobs:
             os: macos-latest
             architecture: aarch64
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           ref: ${{ inputs.sha || github.sha }}
 
@@ -337,7 +337,7 @@ jobs:
       needs.test_binaries.result == 'success'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           ref: ${{ inputs.sha || github.sha }}
 
@@ -465,7 +465,7 @@ jobs:
       needs.test_binaries.result == 'success'
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
         with:
           ref: ${{ inputs.sha || github.sha }}
 
@@ -627,7 +627,7 @@ jobs:
 
       - name: Create GitHub Release and Upload Binaries
         if: startsWith(github.ref, 'refs/tags/jl-')
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         with:
           files: release-bundle/binaries/*.tar.gz
           body: |

@@ -41,7 +41,7 @@ jobs:
         julia-version: ["1"]  # Latest stable (experimental bindings)
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
 
     - name: Set up Julia ${{ matrix.julia-version }}
       uses: julia-actions/setup-julia@v2
@@ -58,7 +58,7 @@ jobs:
     #   if: runner.os != 'Windows'
     #   run: |
     #     echo "Installing LLVM using pecos..."
-    #     cargo run -p pecos --features cli --release -- llvm install
+    #     cargo run -p pecos --features cli --release -- install llvm
     #
     #     echo "Setting LLVM environment variables..."
     #     export PECOS_LLVM=$(cargo run -p pecos --features cli --release -- llvm find 2>/dev/null)
@@ -75,7 +75,7 @@ jobs:
     #   shell: pwsh
     #   run: |
     #     Write-Host "Installing LLVM using pecos..."
-    #     cargo run -p pecos --features cli --release -- llvm install
+    #     cargo run -p pecos --features cli --release -- install llvm
     #
     #     Write-Host "Setting LLVM environment variables..."
     #     $env:PECOS_LLVM = (cargo run -p pecos --features cli --release -- llvm find 2>$null)

@@ -24,7 +24,7 @@ jobs:
       pull-requests: write
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
       with:
         fetch-depth: 0
         token: ${{ secrets.GITHUB_TOKEN }}
@@ -48,7 +48,7 @@ jobs:
         grep -n "GitSource" julia/PECOS.jl/deps/build_tarballs.jl
 
     - name: Create Pull Request
-      uses: peter-evans/create-pull-request@v5
+      uses: peter-evans/create-pull-request@v8
       with:
         token: ${{ secrets.GITHUB_TOKEN }}
         commit-message: "Update Julia build hash for ${{ github.ref_name }}"

@@ -22,7 +22,7 @@ jobs:
   check-julia-versions:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
 
     - name: Check Julia version consistency
       run: |