check_documentation.yml

name: Documentation

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

permissions:
  contents: read

jobs:
  documentationjob:
    permissions:
      contents: write

    runs-on: ubuntu-20.04

    steps:
    - name: Harden Runner
      uses: step-security/harden-runner@63c24ba6bd7ba022e95695ff85de572c04a18142 # v2.7.0
      with:
        egress-policy: audit

    - uses: actions/checkout@b4ffde65f46336ab88eb53be808477a3936bae11 # v4.1.1
      with:
        fetch-depth: 0
        submodules: recursive

    - 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_rss ad_rss_map_integration --cmake-args -DCMAKE_BUILD_TYPE=Debug -DBUILD_TESTING=ON -DBUILD_COVERAGE=ON -DBUILD_APIDOC=ON
        colcon test --event-handlers console_direct+ --packages-select ad_rss ad_rss_map_integration
        colcon test-result

    - name: Code Coverage and CodeCov
      run: |
        bash .github/workflows/code_coverage.sh
    
    - name: Upload coverage to Codecov
      uses: codecov/codecov-action@v4
      with:
        fail_ci_if_error: true
        files: ./cleanedCoverage_as_rss.info,./cleanedCoverage_as_rss_map_integration.info
        flags: unittests
        token: ${{ secrets.CODECOV_TOKEN }} 
        verbose: true

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