build.yml

# =============================================================================
# Multi-Architecture Build & Test Workflow for libppd
#
# Modelled on the QEMU-based CI used in the sister OpenPrinting repositories
# (libcupsfilters, cups-filters).  Proves on every push / PR / manual dispatch
# that libppd compiles end-to-end (libppd.la + every check_PROGRAMS binary)
# and that every registered TEST in Makefile.am passes under
# `make check V=1 VERBOSE=1` on FOUR architectures:
#
#   * amd64    - native, ubuntu-latest
#   * arm64    - native, ubuntu-24.04-arm
#   * armhf    - emulated via QEMU (armv7)
#   * riscv64  - emulated via QEMU
#
# The hermetic C unit tests exercised: testppd, test_ppd_localize,
# test_ppd_cache, test_ppd_ipp, test_ppd_mark, test_ppd_custom,
# test_ppd_attr, test_ppd_page, test_ppd_conflicts.
#
# apt package list derived from libppd's configure.ac:
#   PKG_CHECK_MODULES([LIBCUPSFILTERS])     -> libcupsfilters-dev
#   PKG_CHECK_MODULES([ZLIB])               -> zlib1g-dev
#   AC_PATH_TOOL(CUPSCONFIG)                -> libcups2-dev
#   AC_CHECK_PROG(gs / pdftops / mutool)    -> ghostscript, poppler-utils,
#                                              mupdf-tools
#   AM_GNU_GETTEXT([external])              -> gettext, autopoint
#   AC_PROG_CC / CXX / LT_INIT / pkg-config -> build-essential, autoconf,
#                                              automake, libtool,
#                                              libtool-bin, pkg-config
#   transitive (poppler / qpdf renderers)   -> libqpdf-dev, libpoppler-dev,
#                                              libpoppler-cpp-dev
# =============================================================================

name: Build and Test (libppd, multi-arch)

on:
  push:
    branches:
      - '**'
  pull_request:
    branches:
      - '**'
  workflow_dispatch:

jobs:
  build:
    name: Build & Test (${{ matrix.arch }})
    runs-on: ${{ matrix.runs-on }}

    strategy:
      fail-fast: false
      matrix:
        include:
          - arch: amd64
            runs-on: ubuntu-latest
            use-qemu: false
          - arch: arm64
            runs-on: ubuntu-24.04-arm
            use-qemu: false
          - arch: armhf
            runs-on: ubuntu-latest
            use-qemu: true
            qemu-arch: armv7
          - arch: riscv64
            runs-on: ubuntu-latest
            use-qemu: true
            qemu-arch: riscv64

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Save workspace directory
        run: echo "REPO_DIR=$(pwd)" >> $GITHUB_ENV

      # -----------------------------------------------------------------------
      # NATIVE LEG  (amd64 on ubuntu-latest, arm64 on ubuntu-24.04-arm)
      # -----------------------------------------------------------------------
      - name: Install dependencies (native)
        if: matrix.use-qemu == false
        run: |
          set -ex
          sudo apt-get clean
          sudo apt-get update --fix-missing -y -o Acquire::Retries=3
          # Drop any pre-shipped libppd-dev so our local build wins
          sudo apt-get remove -y libppd-dev || true
          sudo apt-get install -y --no-install-recommends \
            build-essential \
            autoconf \
            automake \
            autopoint \
            libtool \
            libtool-bin \
            pkg-config \
            gettext \
            git \
            wget \
            tar \
            libcups2-dev \
            libcupsfilters-dev \
            libqpdf-dev \
            libpoppler-dev \
            libpoppler-cpp-dev \
            zlib1g-dev \
            ghostscript \
            poppler-utils \
            mupdf-tools

      - name: Build & test libppd (native)
        if: matrix.use-qemu == false
        run: |
          set -ex
          cd "$REPO_DIR"
          ./autogen.sh
          ./configure
          make -j$(nproc) V=1
          make check V=1 VERBOSE=1 || {
            echo "==== test-suite.log ===="
            test -f test-suite.log && cat test-suite.log
            echo "==== per-test logs ===="
            for f in $(find . -name '*.log' -not -name 'config.log'); do
              echo "---- $f ----"; cat "$f"
            done
            exit 1
          }

      # -----------------------------------------------------------------------
      # EMULATED LEG  (armhf via QEMU armv7, riscv64 via QEMU)
      # -----------------------------------------------------------------------
      - name: Set up QEMU
        if: matrix.use-qemu == true
        uses: docker/setup-qemu-action@v3
        with:
          platforms: ${{ matrix.qemu-arch }}

      - name: Build & test libppd (emulated)
        if: matrix.use-qemu == true
        uses: uraimo/run-on-arch-action@v3
        with:
          arch: ${{ matrix.qemu-arch }}
          distro: ubuntu24.04
          dockerRunArgs: |
            --volume "${{ github.workspace }}:/workspace"
          install: |
            apt-get clean
            apt-get update --fix-missing -y -o Acquire::Retries=3
            DEBIAN_FRONTEND=noninteractive apt-get install -y tzdata
            apt-get remove -y libppd-dev 2>/dev/null || true
            apt-get install -y --no-install-recommends \
              build-essential \
              gcc g++ \
              autoconf \
              automake \
              autopoint \
              libtool \
              libtool-bin \
              pkg-config \
              gettext \
              git \
              wget \
              tar \
              libcups2-dev \
              libcupsfilters-dev \
              libqpdf-dev \
              libpoppler-dev \
              libpoppler-cpp-dev \
              zlib1g-dev \
              ghostscript \
              poppler-utils \
              mupdf-tools
          run: |
            set -ex
            cd /workspace
            ./autogen.sh
            ./configure
            make -j$(nproc) V=1
            make check V=1 VERBOSE=1 || {
              echo "==== test-suite.log ===="
              test -f test-suite.log && cat test-suite.log
              echo "==== per-test logs ===="
              for f in $(find . -name '*.log' -not -name 'config.log'); do
                echo "---- $f ----"; cat "$f"
              done
              exit 1
            }

      # -----------------------------------------------------------------------
      # ARTIFACT UPLOAD (all four legs, only on failure)
      # -----------------------------------------------------------------------
      - name: Upload test logs on failure
        if: failure()
        uses: actions/upload-artifact@v4
        with:
          name: libppd-test-logs-${{ matrix.arch }}
          path: |
            test-suite.log
            **/*.log
            **/*.trs
          if-no-files-found: warn
          retention-days: 14