_example_tests_runner.yml

# Reusable workflow for running example tests
name: Example Tests Runner

on:
  workflow_call:
    inputs:
      docker_image:
        description: "Docker image to use for tests"
        required: true
        type: string
      example:
        description: "Example name to test (e.g. 'hf_ptq')"
        required: true
        type: string
      timeout_minutes:
        description: "Timeout in minutes for the job"
        required: false
        type: number
        default: 60
      pip_install_extras:
        description: "Pip install extras (e.g. '[hf,dev-test]' or '[all,dev-test]')"
        required: false
        type: string
        default: "[all,dev-test]"
      runner:
        description: "GitHub runner to use"
        required: false
        type: string
        default: "linux-amd64-gpu-rtxpro6000-latest-1"
      allow_failure:
        description: "If true, test failures are reported as a warning and do not fail the job (used to keep a known-broken example non-blocking)"
        required: false
        type: boolean
        default: false

jobs:
  run-test:
    runs-on: ${{ inputs.runner }}
    timeout-minutes: ${{ inputs.timeout_minutes }}
    permissions:
      contents: read
    container:
      image: ${{ inputs.docker_image }}
      options: --shm-size=2gb # TRT-LLM tests on 2-GPU runner needs more shared memory
      env:
        PIP_CONSTRAINT: "" # Disable pip constraint for upgrading packages
        HF_TOKEN: ${{ secrets.HF_TOKEN }}
        # Build CUDA kernels only for the runner's RTX PRO 6000 (sm_120), not the image's ~6 archs.
        TORCH_CUDA_ARCH_LIST: "12.0"
    steps:
      - uses: actions/checkout@v6
      - uses: nv-gha-runners/setup-proxy-cache@main
      - uses: ./.github/actions/cache-extensions
        with:
          cache-key: rtxpro6000-${{ inputs.docker_image }}
      - name: Setup environment variables
        run: |
          echo "LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:/usr/include:/usr/lib/x86_64-linux-gnu:/usr/local/tensorrt/targets/x86_64-linux-gnu/lib" >> $GITHUB_ENV
          echo "PATH=${PATH}:/usr/local/tensorrt/targets/x86_64-linux-gnu/bin" >> $GITHUB_ENV
      - name: Install dependencies
        run: |
          # Uninstall conflicting system-wide installed modelopt in nemo containers
          pip uninstall -y nvidia-modelopt || true

          # Use `python -m pip` instead of `pip` to avoid conflicts with system pip for nemo containers
          # Editable install so example scripts launched as subprocesses resolve modelopt to the same source path as the test process
          python -m pip install -e ".${{ inputs.pip_install_extras }}"

          if [[ "${{ inputs.example }}" == *"diffusers"* ]]; then
            echo "Uninstalling apex for diffusers: T5 Int8 (PixArt) + Apex is not supported as per https://github.com/huggingface/transformers/issues/21391"
            python -m pip uninstall -y apex || true
          fi

          find examples/${{ inputs.example }} -name "requirements.txt" | while read req_file; do python -m pip install -r "$req_file" || exit 1; done
      - name: Run tests
        id: run_tests
        continue-on-error: ${{ inputs.allow_failure }}
        env:
          # Absolute paths so subprocesses running from different working directories
          # all find the config and write .coverage.* files to the same location.
          COVERAGE_PROCESS_START: ${{ github.workspace }}/pyproject.toml
          COVERAGE_FILE: ${{ github.workspace }}/.coverage
        run: |
          echo "Running tests for: ${{ inputs.example }}"
          python -m pytest tests/examples/${{ inputs.example }} --cov
      - name: Flag allowed failure
        if: ${{ inputs.allow_failure && steps.run_tests.outcome == 'failure' }}
        run: |
          echo "::warning title=Allowed example failure::'${{ inputs.example }}' failed but is in the allow-failure list (vars.ALLOW_FAILURE_EXAMPLE_TESTS); not blocking. Remove it from the variable once fixed."
      - name: Upload coverage to Codecov
        uses: codecov/codecov-action@v7
        with:
          token: ${{ secrets.CODECOV_TOKEN }}
          files: coverage.xml
          # One flag per example, not a shared `examples`: carryforward only applies to a flag
          # with no upload, so a shared flag would replace every lane's coverage with the subset
          # that ran once lanes are gated independently.
          flags: examples-${{ inputs.example }}
          fail_ci_if_error: false # test may be skipped if relevant file changes are not detected
          verbose: true