Python-Obfuscation/.gitea/workflows/doxygen-to-wiki.yml

# Publish Doxygen HTML to the repository Wiki via Gitea Actions
# Requirements:
# - Create a repository secret named WIKI_TOKEN with a Personal Access Token that has write access.
# - Ensure the Wiki is enabled for this repository.
# - Doxygen output is expected at docs/html (from Doxyfile: OUTPUT_DIRECTORY = docs).

name: Doxygen to Wiki (Gitea-native)

on:
  push:
    branches:
      - main
      - master
    paths:
      - '**.py'
      - '**.md'
      - 'Doxyfile'
      - '.gitea/workflows/doxygen-to-wiki.yml'
  workflow_dispatch:

permissions: {}

jobs:
  publish:
    name: Build Doxygen and publish to Wiki
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Install Doxygen, Graphviz, and doxybook2
        shell: bash
        run: |
          set -euo pipefail
          sudo apt-get update
          sudo apt-get install -y doxygen graphviz rsync curl ca-certificates unzip
          ARCH="$(uname -m)"
          case "${ARCH}" in
            x86_64|amd64) DOXYBOOK2_ASSET="doxybook2-linux-amd64.zip" ;;
            aarch64|arm64) DOXYBOOK2_ASSET="doxybook2-linux-arm64.zip" ;;
            *) echo "Unsupported architecture: ${ARCH}" >&2; exit 1 ;;
          esac
          curl -fsSL -o /tmp/doxybook2.zip "https://github.com/matusnovak/doxybook2/releases/latest/download/${DOXYBOOK2_ASSET}"
          sudo unzip -j /tmp/doxybook2.zip -d /usr/local/bin doxybook2
          sudo chmod +x /usr/local/bin/doxybook2
          doxybook2 --version

      - name: Build Doxygen (HTML + XML)
        shell: bash
        run: |
          set -euo pipefail
          rm -rf docs/html docs/xml
          doxygen Doxyfile
          test -d docs/xml || { echo "Doxygen XML output not found at docs/xml"; exit 2; }

      - name: Publish to Wiki
        env:
          WIKI_TOKEN: ${{ secrets.WIKI_TOKEN }}
        shell: bash
        run: |
          set -euo pipefail

          if [ -z "${WIKI_TOKEN:-}" ]; then
            echo "Missing WIKI_TOKEN secret. Create it with a PAT that has wiki write access." >&2
            exit 1
          fi

          # Derive server host and repo slug from the existing 'origin' remote
          ORIGIN_URL="$(git remote get-url origin)"
          case "${ORIGIN_URL}" in
            http://*|https://*)
              SERVER_HOST="$(echo "${ORIGIN_URL}" | sed -E 's#^https?://([^/]+)/.*#\1#')"
              PATH_PART="$(echo "${ORIGIN_URL}" | sed -E 's#^https?://[^/]+/##')"
              ;;
            git@*:* )
              SERVER_HOST="$(echo "${ORIGIN_URL}" | sed -E 's#^git@([^:]+):.*#\1#')"
              PATH_PART="$(echo "${ORIGIN_URL}" | sed -E 's#^git@[^:]+:##')"
              ;;
            *)
              echo "Unsupported origin URL format: ${ORIGIN_URL}" >&2
              exit 4
              ;;
          esac
          # Remove optional .git suffix
          REPO_SLUG="${PATH_PART%.git}"

          # Clone wiki with token via HTTP header (no username needed)
          rm -rf wiki
          WIKI_URL="https://${SERVER_HOST}/${REPO_SLUG}.wiki.git"
          echo "Cloning wiki from ${WIKI_URL}"
          git -c http.extraHeader="Authorization: token ${WIKI_TOKEN}" clone "${WIKI_URL}" wiki || {
            echo "Wiki repo may not be initialized; create a placeholder page in the UI." >&2
            exit 3
          }

          # Configure token for pushes to this host
          git -C wiki config http."https://${SERVER_HOST}/".extraHeader "Authorization: token ${WIKI_TOKEN}"

          # Convert Doxygen XML to Markdown into wiki/Doxygen
          rm -rf wiki/Doxygen wiki/doxygen
          mkdir -p wiki/Doxygen
          doxybook2 --input docs/xml --output wiki/Doxygen

          # Create/overwrite the landing page
          cat > wiki/Doxygen.md << 'EOF'
          # Doxygen Documentation

          The generated API reference is published as native Markdown pages under the Doxygen directory in this wiki.

          - Open the entry point (if present): [Doxygen/index.md](Doxygen/index.md)
          - Or browse the Doxygen/ pages listed in the sidebar
          EOF

          # Commit and push
          COMMIT_SHA="$(git rev-parse --short HEAD || echo)"
          cd wiki
          git config user.name "wiki-bot"
          git config user.email "wiki-bot@local"
          git add -A
          if git diff --cached --quiet; then
            echo "No changes to publish."
            exit 0
          fi
          git commit -m "docs: update doxygen site from ${COMMIT_SHA}"
          git push origin HEAD