ci-build.yml

on:
  push:
    branches:
      - '*'
    tags:
      - '[0-9]+.[0-9]+.[0-9]+'
      - '[0-9]+.[0-9]+.[0-9]+-*'
  pull_request:
    branches:
      - '*'
    types: [opened, reopened, synchronize]
  workflow_dispatch:

name: ci-build

jobs:

  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0  # Needed for mkdocs-git-authors-plugin

      - uses: actions/setup-python@v5
        with:
          python-version: '3.x'

      - name: Install packages
        run: sudo apt update && sudo apt install -y libgl1-mesa-dev
        
      - name: Install Poetry
        uses: snok/install-poetry@v1
        with:
          virtualenvs-create: true
          virtualenvs-in-project: true

      - name: Load cached venv
        id: cached-poetry-dependencies
        uses: actions/cache@v4
        with:
          path: .venv
          key: venv-${{ runner.os }}-${{ hashFiles('**/poetry.lock') }}

      - name: Install dependencies
        run: poetry install --no-root
      
      - name: Build site
        run: poetry run mkdocs build
      
      - name: Upload artifacts
        uses: actions/upload-artifact@v4
        with:
          name: docs
          path: site/*
          retention-days: 7
          if-no-files-found: error