test-build-system.yml

# This workflow will test the build system (validate symlinks, index generator, cleaning, installing / uninstalling, full build)
name: Complete build system test

on:
  push:
    branches: '**'
  pull_request:
    branches: '**'
  release:
    types: [published]

jobs:
  build:
    runs-on: ubuntu-22.04
    steps:
    - uses: actions/checkout@v4
    - name: Set up Python 3.12
      uses: actions/setup-python@v4
      with:
        python-version: '3.12'

    - name: Install build dependencies
      run: |
        sudo apt-get install --no-install-recommends inkscape make optipng

    - name: Check all symlinks are valid
      run: |
        make check

    - name: Test index generator
      run: |
        make index

    - name: Test clean target
      run: |
        make clean

    - name: Test install and uninstall targets
      run: |
        sudo make install
        sudo make uninstall

    - name: Test reset target
      run: |
        make reset

    - name: Test a complete fresh build
      if: startsWith(github.ref, 'refs/tags/v')
      run: |
        make regen -j$(nproc)