docs.yaml

name: Build Docs

on:
  workflow_dispatch:
  workflow_call:

jobs:
  build-deploy:
    # We only need to verify that the docs build with no warnings here
    name: Build Latest Docs Version
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - name: Install Python Dependencies
        uses: HassanAbouelela/actions/setup-python@setup-python_v1.4.2
        with:
          python_version: "3.12"
          install_args: "--extras async-rediscache --only main --only doc"

      - name: Generate HTML Site
        run: sphinx-build -nW -j auto -b html docs docs/build

      - name: Upload Build Artifact
        uses: actions/upload-artifact@v4
        with:
          name: docs-latest
          path: docs/build/*

      - name: Deploy To GitHub Pages
        uses: JamesIves/github-pages-deploy-action@v4
        with:
          branch: docs
          folder: docs/build
          # We only want to actually push the build if we're on main, otherwise just make sure everything works
          dry-run: ${{ github.ref != 'refs/heads/main' }}