handle_build.yml

name: Handle Build

on:
  push:
    branches: [ "handle" ]
  pull_request:
    branches: [ "handle" ]
  workflow_dispatch: # manual trigger

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
    - name: Checkout current repository
      uses: actions/checkout@v3
    - name: Update Package Lists
      run: sudo apt-get update
    - name: Install Dependencies
      run: sudo apt-get install valgrind g++ make --fix-missing
    - name: Build
      run: make -j
      working-directory: VortexEngine
    - name: Set execute permissions for test script
      run: chmod +x ./runtests.sh
      working-directory: VortexEngine/tests
    - name: Run general tests
      run: ./runtests.sh --general
      working-directory: VortexEngine/tests

  embedded:
    needs: test
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Set up Python
        uses: actions/setup-python@v3
        with:
          python-version: '3.x'
      - name: Install Dependencies
        run: make install
      - name: Build Binary
        run: make build
      - name: Archive production artifacts
        uses: actions/upload-artifact@v3
        with:
          name: embedded firmware
          path: |
            build/VortexEngine.ino.bin
            build/VortexEngine.ino.elf
            build/VortexEngine.ino.map
            build/VortexEngine.ino.hex
            build/VortexEngine.ino.uf2

  docs:
    needs: embedded
    runs-on: ubuntu-latest
    if: github.ref == 'refs/heads/handle'
    steps:
    - name: Checkout current repository
      uses: actions/checkout@v3
    - name: Update Package Lists
      run: sudo apt-get update
    - name: Install Dependencies
      run: sudo apt-get install doxygen graphviz texlive --fix-missing
    - name: Checkout doxygen-awesome
      run: git clone https://github.com/jothepro/doxygen-awesome-css.git doxygen-awesome-css
    - name: Generate Documentation
      run: doxygen Doxyfile
    - name: Commit and Push Documentation
      run: |
        git config --local user.email "action@github.com"
        git config --local user.name "GitHub Action"
        git add docs
        git commit -m "Update Doxygen documentation"
        git push -f origin HEAD:handle-docs