python_redeploy_docs.yml

name: Redeploy Python Docs

on:
  workflow_dispatch:
    inputs:
      version:
        description: 'Version or custom alias to deploy under (e.g., v0.14, staging, preview). Leave empty to derive from the latest stable python/v*.*.* tag.'
        required: false
        type: string
      update_latest:
        description: 'Also update the "latest" alias'
        required: false
        default: true
        type: boolean
      hidden:
        description: 'Hide from the version dropdown. "auto" hides custom aliases and shows vX.Y versions.'
        required: false
        default: 'auto'
        type: choice
        options:
          - auto
          - 'true'
          - 'false'

jobs:
  redeploy_docs:
    name: Redeploy Documentation
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Find latest stable tag
        id: latest_tag
        if: inputs.version == ''
        run: |
          LATEST_TAG=$(git tag -l 'python/v*' | grep -E '^python/v[0-9]+\.[0-9]+\.[0-9]+$' | sort -V | tail -n1 || true)
          if [[ -z "$LATEST_TAG" ]]; then
            echo "Error: No stable python/v*.*.* tag found. Provide the 'version' input."
            exit 1
          fi
          echo "tag=$LATEST_TAG" >> "$GITHUB_OUTPUT"
          echo "Found latest stable tag: $LATEST_TAG"

      - name: Parse latest tag
        id: parsed
        if: inputs.version == ''
        uses: ./.github/actions/python-version-info
        with:
          version: ${{ steps.latest_tag.outputs.tag }}

      - name: Resolve version and visibility
        id: resolve
        env:
          INPUT_VERSION: ${{ inputs.version }}
          DERIVED_VERSION: ${{ steps.parsed.outputs.major_minor }}
          HIDDEN_INPUT: ${{ inputs.hidden }}
        run: |
          if [[ -n "$INPUT_VERSION" ]]; then
            VERSION="$INPUT_VERSION"
            echo "Using provided version: $VERSION"
          else
            VERSION="$DERIVED_VERSION"
            echo "Using version derived from latest stable tag: $VERSION"
          fi

          case "$HIDDEN_INPUT" in
            auto)
              if [[ "$VERSION" =~ ^v[0-9]+\.[0-9]+$ ]]; then
                HIDDEN="false"
              else
                HIDDEN="true"
              fi
              echo "hidden=auto resolved to $HIDDEN for version $VERSION"
              ;;
            true|false)
              HIDDEN="$HIDDEN_INPUT"
              ;;
            *)
              echo "Error: unexpected hidden value '$HIDDEN_INPUT'"
              exit 1
              ;;
          esac

          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
          echo "hidden=$HIDDEN" >> "$GITHUB_OUTPUT"

      - name: Deploy docs
        uses: ./.github/actions/python-mike-deploy
        with:
          version: ${{ steps.resolve.outputs.version }}
          aliases: ${{ inputs.update_latest && 'latest' || '' }}
          hidden: ${{ steps.resolve.outputs.hidden }}