check_documentation.yml

name: Build and Test Documentation

on:
  push:
    branches: master
  pull_request:
    branches: master

permissions:
  contents: read

jobs:
  documentationjob:

    name: Build and Test Documentation
    runs-on: ubuntu-20.04

    env:
      PYTHON_BINDING_VERSION: "3.8"

    steps:
    - name: Harden Runner
      uses: step-security/harden-runner@17d0e2bd7d51742c71671bd19fa12bdc9d40a3d6 # v2.8.1
      with:
        egress-policy: audit

    - uses: actions/checkout@a5ac7e51b41094c92402da3b24376905380afc29 # v4.1.6
      with:
        fetch-depth: 0
        submodules: true

    - name: Install Dependencies
      run: |
        export BUILD_DOCU=true
        bash .github/workflows/install_dependencies.sh

    - name: Build Documentation and Test
      run: |
        GTEST_OUTPUT="xml:test_results"
        colcon build --event-handlers console_direct+ --executor sequential --packages-up-to ad_map_access ad_physics --cmake-args -DCMAKE_BUILD_TYPE=Debug -DBUILD_TESTING=ON -DBUILD_COVERAGE=ON -DBUILD_APIDOC=ON
        colcon test --event-handlers console_direct+ --packages-select ad_map_access ad_physics
        colcon test-result

    - name: Code Coverage
      run: |
        bash .github/workflows/code_coverage.sh

    - name: Upload coverage as artifact
      uses: actions/upload-artifact@v4
      with:
        name: coverage_report
        path: ./coverage
        if-no-files-found: error
        overwrite: true

    - name: Documentation Deployment (Test)
      env:
        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      run: |
        if [ ${{ github.event_name }} != 'pull_request' ]; then bash .github/workflows/deploy_documentation.sh true; else bash .github/workflows/deploy_documentation.sh false; fi