release.yaml

name: Release Package

on:
  workflow_dispatch:
    inputs:
      increment_version:
        description: "Increment version by major, minor, or patch"
        required: true
        default: "patch"
        type: choice
        options:
          - major
          - minor
          - patch

env:
  CHANGELOG_FILE_PATH: CHANGELOG.md

jobs:
  run-tests:
    uses: ./.github/workflows/tests.yaml

  release-package:
    runs-on: ubuntu-latest
    needs: run-tests
    permissions:
      contents: write

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          token: ${{ secrets.RELEASE_GIT_TOKEN }}

      - name: Install Python
        uses: actions/setup-python@v5
        with:
          python-version: "3.10"

      - name: Install uv
        uses: astral-sh/setup-uv@v7
        with:
          version: "0.9.7"
          enable-cache: true

      - name: Set version
        run: |
          CURRENT_VERSION=$(uv version --short)
          echo "Current version: $CURRENT_VERSION"

          uv version --bump "${{ inputs.increment_version }}" --frozen
          NEW_VERSION=$(uv version --short)
          echo "New version: $NEW_VERSION"
          echo "RELEASE_VERSION=$NEW_VERSION" >> "$GITHUB_ENV"

          NEW_VERSION="$NEW_VERSION" python - <<'PY'
          import os
          import re
          from pathlib import Path

          version = os.environ["NEW_VERSION"]
          path = Path("nest/__init__.py")
          text = path.read_text()
          updated = re.sub(
              r'^__version__ = "[^"]+"$',
              f'__version__ = "{version}"',
              text,
              flags=re.MULTILINE,
          )
          if updated == text:
              raise SystemExit("Could not update nest/__init__.py version")
          path.write_text(updated)
          PY

      - name: Install build dependencies
        run: uv sync --no-dev --group build

      - name: Update CHANGELOG.md
        run: uv run git-changelog . -o "$CHANGELOG_FILE_PATH" --bump "v$RELEASE_VERSION"

      - name: Build package
        run: uv build --sdist --wheel

      - name: Check package metadata
        run: uv run twine check dist/*

      - name: Smoke test wheel
        run: uv run --isolated --no-project --with dist/*.whl python -c "import nest; from nest.cli.cli import nest_cli; print(nest.__version__)"

      - name: Smoke test source distribution
        run: uv run --isolated --no-project --with dist/*.tar.gz python -c "import nest; from nest.cli.cli import nest_cli; print(nest.__version__)"

      - name: Commit and push changes
        run: |
          git config --global user.name "github-actions"
          git config --global user.email "github@actions.com"
          git add "$CHANGELOG_FILE_PATH" pyproject.toml nest/__init__.py
          git commit -m "Increment version to $RELEASE_VERSION"
          git push

      - name: Publish package to PyPI
        env:
          UV_PUBLISH_USERNAME: ${{ secrets.PYPI_API_USER }}
          UV_PUBLISH_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
        run: uv publish

      - name: Create GitHub release
        uses: softprops/action-gh-release@v2
        with:
          name: v${{ env.RELEASE_VERSION }}
          tag_name: v${{ env.RELEASE_VERSION }}
          generate_release_notes: true

  deploy-docs:
    needs: release-package
    permissions:
      contents: read
      pages: write
      id-token: write
    uses: ./.github/workflows/deploy_docs.yaml