rippled/.github/workflows/build-debian.yml

# This workflow builds and tests the binary on various Debian configurations.
name: Debian

on:
  workflow_call:
    inputs:
      build_dir:
        description: 'The directory where the build will take place.'
        required: false
        type: string
        default: '.build'

concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}-debian
  cancel-in-progress: true

defaults:
  run:
    shell: bash

env:
  # Global configuration for Conan. This is used to set the number of parallel
  # downloads, uploads, and build jobs. The verbosity is set to verbose to
  # provide more information during the build process.
  CONAN_GLOBAL_CONF: |
    core.download:parallel={{ os.cpu_count() }}
    core.upload:parallel={{ os.cpu_count() }}
    tools.build:jobs={{ (os.cpu_count() * 4/5) | int }}
    tools.build:verbosity=verbose
    tools.compilation:verbosity=verbose
  # GitHub does not allow us to specify a reusable matrix strategy, so to avoid
  # duplication, we define it here using environment variables and create the
  # matrix in the first job. The matrix defined below should be kept in sync
  # with https://github.com/XRPLF/ci/blob/main/.github/workflows/debian.yml.
#  STRATEGY_MATRIX_ARCHITECTURE: >-
#    [
#      {
#          "platform": "linux/amd64",
#          "runner": "ubuntu-24.04"
#      },
#      {
#          "platform": "linux/arm64",
#          "runner": "ubuntu-24.04-arm"
#      }
#    ]
#  STRATEGY_MATRIX_OS: >-
#    [
#        {
#            "distro": "debian",
#            "release": "bookworm",
#            "compiler_name": "gcc",
#            "compiler_version": "12"
#        },
#        {
#            "distro": "debian",
#            "release": "bookworm",
#            "compiler_name": "gcc",
#            "compiler_version": "13"
#        },
#        {
#            "distro": "debian",
#            "release": "bookworm",
#            "compiler_name": "gcc",
#            "compiler_version": "14"
#        },
#        {
#            "distro": "debian",
#            "release": "bookworm",
#            "compiler_name": "clang",
#            "compiler_version": "16"
#        },
#        {
#            "distro": "debian",
#            "release": "bookworm",
#            "compiler_name": "clang",
#            "compiler_version": "17"
#        },
#        {
#            "distro": "debian",
#            "release": "bookworm",
#            "compiler_name": "clang",
#            "compiler_version": "18"
#        },
#        {
#            "distro": "debian",
#            "release": "bookworm",
#            "compiler_name": "clang",
#            "compiler_version": "19"
#        }
#    ]
#  STRATEGY_MATRIX_BUILD_TYPE: >-
#    [
#      "Debug",
#      "Release"
#    ]
#  STRATEGY_MATRIX_CMAKE_ARGS: >-
#    [
#      "-DUnity=OFF",
#      "-DUnity=ON"
#    ]
  STRATEGY_MATRIX_ARCHITECTURE: >-
    [
      {
          "platform": "linux/amd64",
          "runner": "ubuntu-24.04"
      }
    ]
  STRATEGY_MATRIX_OS: >-
    [
        {
            "distro": "debian",
            "release": "bookworm",
            "compiler_name": "gcc",
            "compiler_version": "12"
        }
    ]
  STRATEGY_MATRIX_BUILD_TYPE: >-
    [
      "Debug"
    ]
  STRATEGY_MATRIX_CMAKE_ARGS: >-
    [
      "-DUnity=ON"
    ]

jobs:
  # Generate the strategy matrix and expose environment variables to be used by
  # following jobs. Exposing env vars this way is needed as they cannot be
  # directly passed as inputs to reusable workflows (although they can be passed
  # as inputs to actions).
  generate-outputs:
    runs-on: ubuntu-latest
    steps:
      - name: Generate outputs
        id: generate
        run: |
          echo "strategy_matrix_architecture=$(jq -c <<< '${{ env.STRATEGY_MATRIX_ARCHITECTURE }}')" >> "$GITHUB_OUTPUT"
          echo "strategy_matrix_os=$(jq -c <<< '${{ env.STRATEGY_MATRIX_OS }}')" >> "$GITHUB_OUTPUT"
          echo "strategy_matrix_build_type=$(jq -c <<< '${{ env.STRATEGY_MATRIX_BUILD_TYPE }}')" >> "$GITHUB_OUTPUT"
          echo "strategy_matrix_cmake_args=$(jq -c <<< '${{ env.STRATEGY_MATRIX_CMAKE_ARGS }}')" >> "$GITHUB_OUTPUT"
    outputs:
      conan_global_conf: ${{ env.CONAN_GLOBAL_CONF }}
      strategy_matrix_architecture: ${{ steps.generate.outputs.strategy_matrix_architecture }}
      strategy_matrix_os: ${{ steps.generate.outputs.strategy_matrix_os }}
      strategy_matrix_build_type: ${{ steps.generate.outputs.strategy_matrix_build_type }}
      strategy_matrix_cmake_args: ${{ steps.generate.outputs.strategy_matrix_cmake_args }}

  # Install and cache the dependencies using various configurations.
  install-dependencies:
    needs:
      - generate-outputs
    uses: ./.github/workflows/install-dependencies.yml
    strategy:
      fail-fast: false
      matrix:
        architecture: ${{ fromJson(needs.generate-outputs.outputs.strategy_matrix_architecture) }}
        os: ${{ fromJson(needs.generate-outputs.outputs.strategy_matrix_os) }}
        build_type: ${{ fromJson(needs.generate-outputs.outputs.strategy_matrix_build_type) }}
    with:
      build_dir: ${{ inputs.build_dir }}
      build_type: ${{ matrix.build_type }}
      conan_global_conf: ${{ needs.generate-outputs.outputs.conan_global_conf }}
      container: ghcr.io/xrplf/ci/${{ matrix.os.distro }}-${{ matrix.os.release }}:${{ matrix.os.compiler_name }}-${{ matrix.os.compiler_version }}
      runner: ${{ matrix.architecture.runner }}

  # Build and test the binary using various configurations.
  build-and-test:
    needs:
      - generate-outputs
      - install-dependencies
    uses: ./.github/workflows/build-nix.yml
    strategy:
      fail-fast: false
      matrix:
        architecture: ${{ fromJson(needs.generate-outputs.outputs.strategy_matrix_architecture) }}
        os: ${{ fromJson(needs.generate-outputs.outputs.strategy_matrix_os) }}
        build_type: ${{ fromJson(needs.generate-outputs.outputs.strategy_matrix_build_type) }}
        cmake_args: ${{ fromJson(needs.generate-outputs.outputs.strategy_matrix_cmake_args) }}
    with:
      build_dir: ${{ inputs.build_dir }}
      build_type: ${{ matrix.build_type }}
      cmake_args: ${{ matrix.cmake_args }}
      cmake_generator: "Ninja"
      conan_global_conf: ${{ needs.generate-outputs.outputs.conan_global_conf }}
      container: ghcr.io/xrplf/ci/${{ matrix.os.distro }}-${{ matrix.os.release }}:${{ matrix.os.compiler_name }}-${{ matrix.os.compiler_version }}
      runner: ${{ matrix.architecture.runner }}