linux.yml

name: Linux

on:
  workflow_call:

env:
  CI: true
  DOTNET_SKIP_FIRST_TIME_EXPERIENCE: true
  DOTNET_CLI_TELEMETRY_OPTOUT: true
  DOTNET_NOLOGO: true
  NODE_OPTIONS: "--no-deprecation" 

jobs:
  build-linux:
    name: build (ubuntu-latest, ${{ matrix.build_type }}, ${{ matrix.toolchain.compiler }})
    runs-on: ubuntu-latest
    defaults:
      run:
        shell: bash
    strategy:
      fail-fast: false
      matrix:
        build_type: [Debug, Release]
        toolchain:
          - { preset: linux-clang, compiler: clang }
          - { preset: linux-gcc, compiler: gcc }

    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          submodules: false
          fetch-depth: 1

      - name: Write submodule SHA manifest
        run: git submodule status | tee submodule-shas.txt

      - name: Cache submodules
        uses: actions/cache@v4
        with:
          path: |
            .git/modules
            thirdparty
          key: submodules-${{ runner.os }}-${{ hashFiles('submodule-shas.txt') }}
          restore-keys: |
            submodules-${{ runner.os }}-

      - name: Init submodules
        run: git submodule update --init --recursive --depth 1

      - name: Get CMake and Ninja
        uses: lukka/get-cmake@latest

      - name: Setup Compiler Cache
        uses: hendrikmuhs/ccache-action@v1.2
        with:
          variant: ccache
          key: Linux-${{ matrix.toolchain.preset }}-${{ matrix.build_type }}
          max-size: 5G

      - name: Setup Mold Linker
        uses: rui314/setup-mold@v1

      - name: Install Python dependencies
        run: |
          python3 -m pip install --upgrade pip
          python3 -m pip install jinja2

      - name: Install Linux Dependencies
        run: |
          set -euo pipefail
          sudo apt-get update
          # xorg-dev is the GLFW-recommended meta-package: it pulls the full set of
          # X11 development headers/libs (libx11, xrandr, xinerama, xcursor, xi, xext,
          # and the X protocol headers) that find_package(X11) needs. Installing it
          # directly (rather than via a cache-apt action) avoids cache-restore gaps
          # where a package is "installed" per the manifest but its files are absent.
          sudo apt-get install -y --no-install-recommends \
            build-essential \
            xorg-dev \
            libgl1-mesa-dev libglu1-mesa-dev \
            libasound2-dev \
            pkg-config libgtk-3-dev libdrm-dev libgbm-dev \
            xvfb libxkbcommon-x11-0 libgl1-mesa-dri mesa-utils

      - name: Setup Linux Compilers
        run: |
          set -euo pipefail
          if [[ "${{ matrix.toolchain.compiler }}" == "clang" ]]; then
            sudo apt-get install -y clang-18 clang++-18 libc++-18-dev libc++abi-18-dev lld-18 llvm-18
            echo "CC=clang-18" >> $GITHUB_ENV
            echo "CXX=clang++-18" >> $GITHUB_ENV
          else
            sudo apt-get install -y gcc-13 g++-13
            echo "CC=gcc-13" >> $GITHUB_ENV
            echo "CXX=g++-13" >> $GITHUB_ENV
          fi
          echo "LDFLAGS=-fuse-ld=mold" >> $GITHUB_ENV

      - name: Setup .NET SDK
        uses: actions/setup-dotnet@v4
        with:
          dotnet-version: |
            9.0.x
            10.0.x

      - name: Preflight
        run: |
          set -euo pipefail
          cmake --version
          dotnet --info
          if [[ -n "${CC:-}" ]] && command -v "$CC" >/dev/null 2>&1; then
            "$CC" --version | head -n 1
          fi

      - name: Configure
        run: |
          set -euo pipefail
          SANITIZERS_FLAG="OFF"
          if [[ "${{ matrix.build_type }}" == "Debug" ]]; then
            SANITIZERS_FLAG="ON"
          fi

          mkdir -p "build/${{ matrix.toolchain.preset }}"
          PYTHON_EXE=$(python3 -c "import sys; print(sys.executable)")
          
          cmake --preset ${{ matrix.toolchain.preset }} \
            -DCMAKE_INSTALL_PREFIX="${{ github.workspace }}/install" \
            -DCMAKE_C_COMPILER_LAUNCHER=ccache \
            -DCMAKE_CXX_COMPILER_LAUNCHER=ccache \
            -DPython_EXECUTABLE="${PYTHON_EXE}" \
            -DPython3_EXECUTABLE="${PYTHON_EXE}" \
            -DCH_CI=ON \
            -DENABLE_UNITY_BUILD=OFF \
            -DENABLE_SANITIZERS=$SANITIZERS_FLAG \
            -DENABLE_LTO=OFF \
            -DENABLE_PCH=OFF \
            2>&1 | tee "build/${{ matrix.toolchain.preset }}/configure.log"

      - name: Build
        run: |
          set -euo pipefail
          cmake --build "build/${{ matrix.toolchain.preset }}" --config ${{ matrix.build_type }} \
            2>&1 | tee "build/${{ matrix.toolchain.preset }}/build_${{ matrix.build_type }}.log"

      - name: Test
        run: |
          set -euo pipefail
          BUILD_DIR="${{ github.workspace }}/build/${{ matrix.toolchain.preset }}"
          export LIBGL_ALWAYS_SOFTWARE=1
          export GALLIUM_DRIVER=llvmpipe
          export MESA_GL_VERSION_OVERRIDE=4.5
          export LSAN_OPTIONS="suppressions=${{ github.workspace }}/.github/lsan.supp"
          
          xvfb-run -a ctest --test-dir "$BUILD_DIR" -C "${{ matrix.build_type }}" --output-on-failure --timeout 300 --output-junit "$BUILD_DIR/junit_${{ matrix.build_type }}.xml" \
            2>&1 | tee "$BUILD_DIR/ctest_${{ matrix.build_type }}.log"

      - name: Upload Artifacts
        if: always()
        uses: actions/upload-artifact@v4
        with:
          name: Linux-${{ matrix.toolchain.preset }}-${{ matrix.build_type }}-binaries
          if-no-files-found: ignore
          path: |
            build/${{ matrix.toolchain.preset }}/**/*.log
            build/${{ matrix.toolchain.preset }}/**/junit_*.xml
          retention-days: 7

      - name: Upload Release Binaries
        if: matrix.build_type == 'Release'
        uses: actions/upload-artifact@v4
        with:
          name: Linux-${{ matrix.toolchain.preset }}-Release-executables
          if-no-files-found: ignore
          path: |
            build/${{ matrix.toolchain.preset }}/bin/Release/ChainedEditor
            build/${{ matrix.toolchain.preset }}/bin/Release/ChainedDecos
            build/${{ matrix.toolchain.preset }}/bin/Release/*.so
          retention-days: 7