nltk--nltk/.github/workflows/release.yml

name: Release

on:
  push:
    tags:
      - 'v*'

jobs:
  gate-on-ci:
    name: Gate release on CI success for this tag commit
    runs-on: ubuntu-latest
    permissions:
      actions: read
      contents: read
    steps:
      - name: Checkout repository
        uses: actions/checkout@v7
        with:
          fetch-depth: 0

      - name: Check that release tag points to a develop commit
        run: |
          git merge-base --is-ancestor "$GITHUB_SHA" origin/develop

      - name: Verify version string in documentation
        run: |
          # Strip leading 'v'
          RAW_VERSION=${GITHUB_REF_NAME#v}
          # Strip pre-release suffixes (e.g., -rc1, -beta)
          VERSION=${RAW_VERSION%%-*}
          echo "Checking files for base version: $VERSION"

          for file in nltk/VERSION ChangeLog web/news.rst web/conf.py; do
            if grep -Fq "$VERSION" "$file"; then
              echo "✅ Found $VERSION in $file"
            else
              echo "❌ ERROR: Version $VERSION not found in $file!"
              exit 1
            fi
          done

      - name: Wait for ci.yml to complete and verify success
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: |
          set -euo pipefail

          workflow_file="ci.yml"
          attempts=60
          delay=20

          for _ in $(seq 1 "$attempts"); do
            run=$(gh api \
              "repos/${{ github.repository }}/actions/workflows/${workflow_file}/runs?per_page=100" \
              --jq '[.workflow_runs[] | select(.head_sha == "'"$GITHUB_SHA"'")] | sort_by(.run_number) | last')

            if [ -z "$run" ] || [ "$run" = "null" ]; then
              sleep "$delay"
              continue
            fi

            status=$(jq -r '.status // empty' <<< "$run")
            conclusion=$(jq -r '.conclusion // empty' <<< "$run")

            if [ "$status" != "completed" ]; then
              sleep "$delay"
              continue
            fi

            if [ "$conclusion" = "success" ]; then
              exit 0
            fi

            run_id=$(jq -r '.id // empty' <<< "$run")
            run_number=$(jq -r '.run_number // empty' <<< "$run")
            run_url="https://github.com/${{ github.repository }}/actions/runs/${run_id}"
            echo "CI failed with conclusion: ${conclusion:-unknown} (run #${run_number:-unknown}). See workflow run: ${run_url}"
            exit 1
          done

          echo "Timed out waiting for CI to complete for $GITHUB_SHA"
          exit 1

  build-and-github-release:
    needs: gate-on-ci
    name: Build and create GitHub draft release
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - name: Checkout repository
        uses: actions/checkout@v7

      - name: Set up Python
        uses: actions/setup-python@v6
        with:
          python-version: '3.12'

      - name: Install build dependencies
        run: |
          python -m pip install --upgrade pip
          pip install build

      - name: Build package
        run: python -m build

      - name: Create GitHub Release
        uses: softprops/action-gh-release@v3
        with:
          files: dist/*
          draft: true
          generate_release_notes: true