---
# DESCRIPTION: Github actions config
# SPDX-License-Identifier: LGPL-3.0-only OR Artistic-2.0

name: reusable-test

on:
  workflow_call:
    inputs:
      archive:
        description: "Name of the repository archive artifact from reusable-build"
        required: true
        type: string
      cc:
        description: "Compiler to use: 'gcc' or 'clang'"
        required: true
        type: string
      dev-gcov:
        description: "Collect gcov coverage data from the test run"
        required: false
        default: false
        type: boolean
      reloc:
        description: "Relocate the installation before testing"
        required: false
        default: false
        type: boolean
      runs-on:
        description: "Runner to test on, e.g. ubuntu-24.04"
        required: true
        type: string
      suite:
        description: "Test suite to run, e.g. dist-vlt-0"
        required: true
        type: string

env:
  CCACHE_COMPRESS: 1
  CCACHE_DIR: ${{ github.workspace }}/.ccache
  CCACHE_LIMIT_MULTIPLE: 0.95

defaults:
  run:
    shell: bash
    working-directory: repo

jobs:

  test:
    runs-on: ${{ inputs.runs-on }}
    name: Test
    env:
      CXX: ${{ inputs.cc == 'clang' && 'clang++' || 'g++' }}
      CACHE_BASE_KEY: test-${{ inputs.runs-on }}-${{ inputs.cc }}-${{ inputs.reloc }}-${{ inputs.suite }}
      CCACHE_MAXSIZE: 100M  # Per build per suite (* 5 * 5 = 2500M in total)
    steps:

      - name: Download repository archive
        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c  # v8
        with:
          name: ${{ inputs.archive }}
          path: ${{ github.workspace }}

      - name: Unpack repository archive
        working-directory: ${{ github.workspace }}
        run: |
          tar --zstd -x -f ${{ inputs.archive }}
          ls -lsha

      - name: Cache $CCACHE_DIR
        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9  # v5
        env:
          CACHE_KEY: ${{ env.CACHE_BASE_KEY }}-ccache2
        with:
          path: ${{ env.CCACHE_DIR }}
          key: ${{ env.CACHE_KEY }}-${{ github.sha }}
          restore-keys: |
            ${{ env.CACHE_KEY }}-

      - name: Install test dependencies
        run: |
          ./ci/ci-install.bash test
          make venv

      - name: Test
        id: run-test
        continue-on-error: true
        run: |
          source .venv/bin/activate
          ./ci/ci-test.bash \
            --suite ${{ inputs.suite }} \
            ${{ inputs.reloc && format('--reloc {0}/reloc', github.workspace) || '' }}

      - name: Combine code coverage data
        if: ${{ inputs.dev-gcov }}
        run: |
          make coverage-combine
          mv obj_coverage/verilator.info obj_coverage/verilator-${{ inputs.suite }}.info
          ls -lsha obj_coverage

      - name: Upload code coverage data
        if: ${{ inputs.dev-gcov }}
        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7
        with:
          path: ${{ github.workspace }}/repo/obj_coverage/verilator-${{ inputs.suite }}.info
          name: code-coverage-${{ inputs.suite }}

      - name: Fail job if a test failed
        if: ${{ steps.run-test.outcome == 'failure' && !cancelled() }}
        run: |-
          echo "Click on '> Tests' arrow above (or on other steps), to expand it, and see the failure reasons"
          exit 1