Github Actions

.github/workflows/build.yml

@@ -0,0 +1,90 @@
+name: Build C++ Library
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  build-cpp:
+    name: Build C++ Library
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-24.04, windows-2025-vs2026, macos-26-intel, macos-26]
+        build-shared-libs: ['ON', 'OFF']
+        include:
+          - os: ubuntu-24.04
+            cmake-flags: "-DCMAKE_BUILD_TYPE=Release"
+          - os: windows-2025-vs2026
+            cmake-flags: "-DCMAKE_BUILD_TYPE=Release"
+          - os: macos-26-intel
+            cmake-flags: "-DCMAKE_BUILD_TYPE=Release"
+          - os: macos-26
+            cmake-flags: "-DCMAKE_BUILD_TYPE=Release"
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install dependencies (Ubuntu)
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y cmake build-essential libomp-dev
+
+      - name: Install dependencies (macOS)
+        if: runner.os == 'macOS'
+        run: |
+          brew install cmake libomp
+
+      - name: Install dependencies (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          choco install cmake --installargs 'ADD_CMAKE_TO_PATH=System'
+        shell: powershell
+
+      - name: Create build directory
+        run: mkdir -p build
+
+      - name: Configure CMake (Unix)
+        if: runner.os != 'Windows'
+        run: cmake -B build ${{ matrix.cmake-flags }} -DBUILD_SHARED_LIBS=${{ matrix.build-shared-libs }} -DBUILD_BENCHMARK=OFF
+
+      - name: Configure CMake (Windows)
+        if: runner.os == 'Windows'
+        run: cmake -B build -A x64 ${{ matrix.cmake-flags }} -DBUILD_SHARED_LIBS=${{ matrix.build-shared-libs }} -DBUILD_BENCHMARK=OFF
+        shell: cmd
+
+      - name: Build C++ Library
+        run: cmake --build build --config Release
+
+      - name: Upload C++ build artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: cpp-build-${{ matrix.os }}-shared-${{ matrix.build-shared-libs }}
+          path: build/
+          retention-days: 3
+
+      - name: Check example executable exists
+        if: runner.os != 'Windows'
+        run: |
+          if [ -f build/fCWT_example ]; then
+            echo "C++ example built successfully"
+            ./build/fCWT_example
+          else
+            echo "Warning: fCWT_example not found"
+            exit 1
+          fi
+        shell: bash
+
+      - name: Check example executable exists (Windows)
+        if: runner.os == 'Windows'
+        run: |
+          if (Test-Path "build\Release\fCWT_example.exe") {
+            Write-Host "C++ example built successfully"
+            & "build\Release\fCWT_example.exe"
+          } else {
+            Write-Warning "fCWT_example.exe not found"
+            exit 1
+          }
+        shell: powershell

.github/workflows/build_python_library.yml

@@ -0,0 +1,76 @@
+name: Build Python Libraries
+
+on:
+  push:
+    paths:
+      - 'src/**'
+      - 'libs/**'
+      - 'tests/**'
+      - 'setup.py'
+      - 'pyproject.toml'
+      - '.github/workflows/build_python_library.yml'
+  pull_request:
+    paths:
+      - 'src/**'
+      - 'libs/**'
+      - 'tests/**'
+      - 'setup.py'
+      - 'pyproject.toml'
+      - '.github/workflows/build_python_library.yml'
+
+jobs:
+  build-python:
+    name: Build Python Library
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-24.04, windows-2025-vs2026, macos-26-intel, macos-26]
+        python-version: ['3.11', '3.14']
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies (Ubuntu)
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y build-essential libomp-dev
+
+      - name: Install dependencies (macOS)
+        if: runner.os == 'macOS'
+        run: |
+          brew install libomp
+
+      - name: Set macOS architecture flags
+        if: runner.os == 'macOS'
+        run: |
+          echo "ARCHFLAGS=-arch $(uname -m)" >> "$GITHUB_ENV"
+
+      - name: Install Python build dependencies
+        run: |
+          python -m pip install --upgrade pip setuptools wheel numpy
+
+      - name: Install package
+        run: pip install -e .
+
+      - name: Install test dependencies
+        run: pip install pytest
+
+      - name: Run tests
+        run: pytest tests/test_fcwt.py -v
+
+      - name: Upload Python build artifacts
+        uses: actions/upload-artifact@v7
+        if: always()
+        with:
+          name: python-build-${{ matrix.os }}-py${{ matrix.python-version }}
+          path: |
+            build/
+            src/
+          retention-days: 3

.github/workflows/run_benchmark.yml

@@ -0,0 +1,137 @@
+name: Benchmark C++ Library
+
+on:
+  workflow_dispatch:
+    inputs:
+      samples:
+        description: "Number of samples"
+        required: true
+        default: "100000"
+      threads:
+        description: "Number of threads"
+        required: true
+        default: "8"
+      optimization:
+        description: "FFTW optimization mode"
+        required: true
+        default: "estimate"
+        type: choice
+        options:
+          - estimate
+          - measure
+          - patient
+          - exhaustive
+      install-wavelib:
+        description: "Build and install Wavelib before running optional comparison"
+        required: true
+        default: false
+        type: boolean
+      run-rwave:
+        description: "Run RWave comparison benchmark"
+        required: true
+        default: false
+        type: boolean
+      smoke:
+        description: "Use one run and no sleep for a quick benchmark smoke test"
+        required: true
+        default: false
+        type: boolean
+
+jobs:
+  benchmark:
+    name: Benchmark C++ Library
+    runs-on: ubuntu-24.04
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y cmake build-essential libomp-dev
+
+      - name: Build and install Wavelib
+        if: inputs.install-wavelib
+        run: |
+          git clone https://github.com/rafat/wavelib.git /tmp/wavelib
+          cmake -S /tmp/wavelib -B /tmp/wavelib/build -DCMAKE_BUILD_TYPE=Release
+          cmake --build /tmp/wavelib/build --config Release
+          sudo cmake --install /tmp/wavelib/build --prefix /usr/local
+
+      - name: Configure benchmark build
+        run: cmake -B build -DCMAKE_BUILD_TYPE=Release -DBUILD_BENCHMARK=ON
+
+      - name: Build benchmark
+        run: cmake --build build --config Release --target fCWT_benchmark
+
+      - name: Capture benchmark system specs
+        run: |
+          {
+            echo "Benchmark system specs"
+            echo "======================"
+            echo "Date: $(date -u +'%Y-%m-%dT%H:%M:%SZ')"
+            echo "Runner: $RUNNER_NAME"
+            echo "Runner OS: $RUNNER_OS"
+            echo "Runner arch: $RUNNER_ARCH"
+            echo
+            echo "OS release"
+            echo "----------"
+            cat /etc/os-release
+            echo
+            echo "Kernel"
+            echo "------"
+            uname -a
+            echo
+            echo "CPU"
+            echo "---"
+            lscpu
+            echo
+            echo "Memory"
+            echo "------"
+            free -h
+            echo
+            echo "Compiler"
+            echo "--------"
+            c++ --version
+            echo
+            echo "CMake"
+            echo "-----"
+            cmake --version
+          } > benchmark-spec.txt
+
+      - name: Run FFTW optimization
+        if: ${{ !inputs.smoke }}
+        run: ./build/fCWT_benchmark -fcwtoptimize "${{ inputs.samples }}" "${{ inputs.threads }}" "-${{ inputs.optimization }}"
+
+      - name: Run fCWT benchmark
+        run: |
+          if [ "${{ inputs.smoke }}" = "true" ]; then
+            export FCWT_BENCHMARK_RUNS=1
+            export FCWT_BENCHMARK_SLEEP_US=0
+          fi
+          ./build/fCWT_benchmark -fcwt "${{ inputs.samples }}" "${{ inputs.threads }}" | tee benchmark-fcwt.txt
+
+      - name: Run RWave benchmark
+        if: inputs.run-rwave
+        run: |
+          if [ "${{ inputs.smoke }}" = "true" ]; then
+            export FCWT_BENCHMARK_RUNS=1
+            export FCWT_BENCHMARK_SLEEP_US=0
+          fi
+          ./build/fCWT_benchmark -rwave "${{ inputs.samples }}" "${{ inputs.threads }}" | tee benchmark-rwave.txt
+
+      - name: Run Wavelib benchmark
+        if: inputs.install-wavelib
+        run: |
+          if [ "${{ inputs.smoke }}" = "true" ]; then
+            export FCWT_BENCHMARK_RUNS=1
+            export FCWT_BENCHMARK_SLEEP_US=0
+          fi
+          ./build/fCWT_benchmark -wavelib "${{ inputs.samples }}" "${{ inputs.threads }}" | tee benchmark-wavelib.txt
+
+      - name: Upload benchmark output
+        uses: actions/upload-artifact@v7
+        with:
+          name: benchmark-results
+          path: benchmark-*.txt
+          retention-days: 3