name: docs

on:
  push:
    branches: [main]
  pull_request:
  workflow_dispatch:

jobs:
  check:
    runs-on: [self-hosted, pod]
    container:
      image: python:3.12-bookworm
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          persist-credentials: false
      - name: Install checker dependencies
        run: python3 -m pip install --disable-pip-version-check -r requirements-docs.txt
      - name: Test checker
        run: python3 -m unittest discover -s tests -v
      - name: Check documentation
        run: python3 scripts/check_docs.py
      - name: Check whitespace
        run: git show --format= --check HEAD