publish-docs.yml

name: "Publish Documentation"

on:
  push:
    paths:
      - "Cargo.toml"
      - "justfile"
      - ".github/workflows/publish-docs.yml"
      - "mkdocs.yml"
      - "docs/**"

jobs:
  publish:
    runs-on: ubuntu-latest
    # Don't run on forks as they lack access to the Cloudflare token.
    # (Dependabot is run as if it's a fork, so ignore that, too.)
    if: github.repository == 'brettcannon/python-launcher' && github.actor != 'dependabot[bot]'
    permissions:
      contents: read
      deployments: write
    name: Publish to Cloudflare Pages
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - uses: actions/setup-python@v5
        with:
          python-version: "3.11"

      - uses: actions-rs/toolchain@v1
        with:
          toolchain: stable
          override: true

      - name: Install `just`
        uses: extractions/setup-just@v2
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: Build docs
        run: just docs

      - name: Publish to Cloudflare Pages
        uses: cloudflare/pages-action@v1
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          projectName: "python-launcher"
          directory: "site"
          # Optional: Enable this if you want to have GitHub Deployments triggered
          # gitHubToken: ${{ secrets.GITHUB_TOKEN }}