benchmarks.yml

name: Benchmarks

permissions:
  contents: read

on:
  workflow_call:
    inputs:
      benchmark_package_paths:
        type: string
        description: 'JSON array of benchmarking package paths to run in sequence on each runner, e.g. ''["Benchmarks/A", "Benchmarks/B"]''. Empty or [] runs the package in the repository root.'
        default: "[]"
      swift_package_arguments:
        type: string
        description: "Additional arguments passed to swift package (e.g. --disable-sandbox)."
        default: ""
      swift_current_release:
        type: string
        description: "The Swift release that `current` names in a version list, and that `current-1` and `current-2` count back from. Job names use the relative label, so a new release moves the versions under the same checks. Changing it holds a repository's versions at a release; changing a version list names versions explicitly."
        default: "6.4"
      swift_nightly_release:
        type: string
        description: "The branch that `nightly-release` names, in the spelling upstream publishes its nightlies under."
        default: "6.4.x"
      linux_swift_versions:
        type: string
        description: "Linux Swift version list (JSON array). Empty uses current-2, current-1, current, nightly-release and nightly-main."
        default: ""
      enable_linux:
        type: boolean
        description: "Run the benchmarks on Linux."
        default: true
      enable_macos:
        type: boolean
        description: "Run the benchmarks on macOS."
        default: false
      macos_swift_versions:
        type: string
        description: "macOS Swift version list (JSON array) for benchmarks. Resolved through the runners' Xcode symlinks. Empty, with macos_xcode_versions also empty, uses the generator's list of release versions."
        default: ""
      macos_xcode_versions:
        type: string
        description: "macOS Xcode version list (JSON array) for benchmarks. Combined with macos_swift_versions rather than replaced by it."
        default: ""
      macos_runner_pool:
        type: string
        description: "Label of the pool of self-hosted macOS runners to use, for an organization that splits its runners into pools such as general and nightly. Empty adds no pool label."
        default: ""
      linux_env_vars:
        type: string
        description: "Environment variables for Linux jobs as JSON."
        default: "{}"
      macos_env_vars:
        type: string
        description: "Environment variables for macOS jobs as JSON."
        default: "{}"
      minimum_swift_version:
        type: string
        description: "Minimum Swift version. Empty auto-detects from Package.swift, 'none' disables filtering, or name a version explicitly."
        default: ""
      name:
        type: string
        description: "Name used for the concurrency group. Set this when a workflow calls benchmarks.yml more than once, or the calls cancel each other."
        default: "benchmarks"
      job_timeout:
        type: number
        description: "Timeout in minutes for each job."
        default: 60
      needs_token:
        type: boolean
        description: "Whether to provide GITHUB_TOKEN to jobs."
        default: false
      enable_cross_pr_testing:
        type: boolean
        description: "Whether PRs can be tested together with linked PRs mentioned in the PR description."
        default: false
jobs:
  generate-matrix:
    name: Generate benchmark matrix
    runs-on: ubuntu-latest
    outputs:
      matrix_yaml: ${{ steps.generate.outputs.matrix_yaml }}
    steps:
      - name: Checkout repository
        uses: actions/checkout@v7
        with:
          persist-credentials: false
      - name: Locate the workflows scripts
        id: workflows_scripts
        uses: $/.github/actions/workflows-scripts
      - name: Generate matrix
        id: generate
        env:
          SCRIPTS_DIRECTORY: ${{ steps.workflows_scripts.outputs.scripts_directory }}
          LINUX_USER_ENV_VARS: ${{ inputs.linux_env_vars }}
          MACOS_USER_ENV_VARS: ${{ inputs.macos_env_vars }}
          BENCHMARK_PACKAGE_PATHS: ${{ inputs.benchmark_package_paths }}
          SWIFT_PACKAGE_ARGUMENTS: ${{ inputs.swift_package_arguments }}
          ENABLE_LINUX: ${{ inputs.enable_linux }}
          ENABLE_MACOS: ${{ inputs.enable_macos }}
          ENABLE_WINDOWS: "false"
          ENABLE_MACOS_SWIFTLY: "false"
          ENABLE_FREEBSD: "false"
          ENABLE_LINUX_STATIC_SDK_BUILD: "false"
          ENABLE_WASM_SDK_BUILD: "false"
          ENABLE_EMBEDDED_WASM_SDK_BUILD: "false"
          ENABLE_ANDROID_SDK_BUILD: "false"
          ENABLE_CXX_INTEROP: "false"
          LINUX_SWIFT_VERSIONS: ${{ inputs.linux_swift_versions }}
          MACOS_SWIFT_VERSIONS: ${{ inputs.macos_swift_versions }}
          MACOS_XCODE_VERSIONS: ${{ inputs.macos_xcode_versions }}
          MACOS_RUNNER_POOL: ${{ inputs.macos_runner_pool }}
          MINIMUM_SWIFT_VERSION: ${{ inputs.minimum_swift_version }}
          SWIFT_CURRENT_RELEASE: ${{ inputs.swift_current_release }}
          SWIFT_NIGHTLY_RELEASE: ${{ inputs.swift_nightly_release }}
          LINUX_SETUP_COMMAND: |
            git config --global --add safe.directory "$(pwd)"
            # The job runs unprivileged on the runner but as root in a container,
            # where sudo is not installed.
            if command -v sudo >/dev/null 2>&1; then
              sudo apt-get update -y -q && sudo apt-get install -y -q libjemalloc-dev jq
            else
              apt-get update -y -q && apt-get install -y -q libjemalloc-dev jq
            fi
          MACOS_SETUP_COMMAND: |
            git config --global --add safe.directory "$(pwd)"
            brew install jemalloc
        run: |
          set -euo pipefail

          # The threshold script reads the package paths from the environment, so
          # they are added to the caller's own variables rather than replacing
          # them.
          with_benchmark_paths() {
            jq -cn \
              --argjson user "$(echo "${1:-}" | yq -o=json '. // {}')" \
              --arg paths "$BENCHMARK_PACKAGE_PATHS" \
              '$user + {BENCHMARK_PACKAGE_PATHS: $paths}'
          }
          LINUX_ENV_VARS=$(with_benchmark_paths "$LINUX_USER_ENV_VARS")
          MACOS_ENV_VARS=$(with_benchmark_paths "$MACOS_USER_ENV_VARS")
          export LINUX_ENV_VARS MACOS_ENV_VARS

          # Single-quoted so ${SCRIPTS_ROOT} survives into the matrix entry and is
          # expanded on the runner, where the scripts directory is known.
          threshold_command='${SCRIPTS_ROOT}/check-benchmark-thresholds.sh'
          if [ -n "$SWIFT_PACKAGE_ARGUMENTS" ]; then
            threshold_command="$threshold_command $SWIFT_PACKAGE_ARGUMENTS"
          fi
          LINUX_COMMAND="$threshold_command"
          MACOS_COMMAND="$threshold_command"
          export LINUX_COMMAND MACOS_COMMAND

          matrix_yaml=$(swift "${SCRIPTS_DIRECTORY}/matrix/generate-matrix.swift")
          echo "matrix_yaml<<EOF" >> $GITHUB_OUTPUT
          echo "$matrix_yaml" >> $GITHUB_OUTPUT
          echo "EOF" >> $GITHUB_OUTPUT

  benchmarks:
    name: Benchmarks
    needs: generate-matrix
    uses: $/.github/workflows/execute_matrix.yml
    with:
      name: ${{ inputs.name }}
      matrix_yaml_string: ${{ needs.generate-matrix.outputs.matrix_yaml }}
      job_timeout: ${{ inputs.job_timeout }}
      needs_token: ${{ inputs.needs_token }}
      enable_cross_pr_testing: ${{ inputs.enable_cross_pr_testing }}