feat: update manual release workflow to include prerelease option and version verification

fix: enhance publish workflow with environment selection and version checks

chore: streamline release workflow by removing unnecessary steps and improving version detection

fix: update version to 0.2.3 in __init__.py

fix: improve async handling in CachedDatabaseWrapper decorator

Author: SirStig

.github/workflows/manual-release.yml

@@ -4,14 +4,14 @@ on:
   workflow_dispatch:
     inputs:
       version:
-        description: 'Version to release (e.g., 0.2.1)'
+        description: 'Version to release (e.g., 0.3.0)'
         required: true
         type: string
-      create_tag:
-        description: 'Create git tag for this version'
-        required: true
+      prerelease:
+        description: 'Mark as prerelease'
+        required: false
         type: boolean
-        default: true
+        default: false
       draft:
         description: 'Create as draft release'
         required: false
@@ -20,25 +20,13 @@ on:
 
 permissions:
   contents: write
-  id-token: write
 
 jobs:
   manual-release:
+    name: Create Manual Release
     runs-on: ubuntu-latest
-
-    services:
-      redis:
-        image: redis:7-alpine
-        ports:
-          - 6379:6379
-        options: >-
-          --health-cmd "redis-cli ping"
-          --health-interval 10s
-          --health-timeout 5s
-          --health-retries 5
-
     steps:
-      - name: Checkout code
+      - name: Checkout
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
@@ -48,67 +36,80 @@ jobs:
         with:
           python-version: '3.11'
 
-      - name: Install build & dev dependencies
+      - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -e .[dev]
           pip install build twine
 
-      - name: Verify version matches
+      - name: Verify version
         run: |
-          PACKAGE_VERSION=$(python -c "import yokedcache; print(yokedcache.__version__)")
+          PACKAGE_VERSION=$(python -c "
+          import sys
+          sys.path.insert(0, 'src')
+          import yokedcache
+          print(yokedcache.__version__)
+          ")
+
+          echo "Package version: $PACKAGE_VERSION"
+          echo "Input version: ${{ github.event.inputs.version }}"
+
           if [ "$PACKAGE_VERSION" != "${{ github.event.inputs.version }}" ]; then
+            echo "❌ Version mismatch!"
             echo "Package version ($PACKAGE_VERSION) doesn't match input version (${{ github.event.inputs.version }})"
-            echo "Please update src/yokedcache/__init__.py to version ${{ github.event.inputs.version }}"
+            echo "Please update src/yokedcache/__init__.py to version ${{ github.event.inputs.version }} first"
             exit 1
           fi
 
-      - name: Create tag
-        if: github.event.inputs.create_tag == 'true'
+          echo "✅ Version verified: $PACKAGE_VERSION"
+
+      - name: Check if tag exists
+        id: tag-check
         run: |
-          git config user.name github-actions
-          git config user.email github-actions@github.com
-          git tag -a "v${{ github.event.inputs.version }}" -m "Release v${{ github.event.inputs.version }}"
-          git push origin "v${{ github.event.inputs.version }}"
+          TAG="v${{ github.event.inputs.version }}"
+          if git tag --list | grep -q "^${TAG}$"; then
+            echo "exists=true" >> $GITHUB_OUTPUT
+            echo "Tag $TAG already exists"
+          else
+            echo "exists=false" >> $GITHUB_OUTPUT
+            echo "Tag $TAG does not exist, will create it"
+          fi
 
-      - name: Extract changelog for this version
-        id: changelog
+      - name: Create tag
+        if: steps.tag-check.outputs.exists == 'false'
         run: |
-          python << 'EOF'
-          import re
-
-          version = "${{ github.event.inputs.version }}"
-
-          try:
-              with open('CHANGELOG.md', 'r') as f:
-                  content = f.read()
-
-              pattern = rf'## \[{re.escape(version)}\].*?\n(.*?)(?=\n## \[|\n---|\Z)'
-              match = re.search(pattern, content, re.DOTALL)
-
-              if match:
-                  changelog_content = match.group(1).strip()
-                  changelog_content = re.sub(r'\n---+.*$', '', changelog_content, flags=re.MULTILINE)
-
-                  with open('release_notes.md', 'w') as f:
-                      f.write(changelog_content)
-                  print(f"Extracted changelog for version {version}")
-              else:
-                  print(f"No changelog found for version {version}")
-                  with open('release_notes.md', 'w') as f:
-                      f.write(f"Manual release {version}")
-          except Exception as e:
-              print(f"Error extracting changelog: {e}")
-              with open('release_notes.md', 'w') as f:
-                  f.write(f"Manual release {version}")
-          EOF
-
-      - name: Run tests
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          TAG="v${{ github.event.inputs.version }}"
+          git tag -a "$TAG" -m "Manual release $TAG"
+          git push origin "$TAG"
+
+      - name: Generate changelog
         run: |
-          pytest -q --disable-warnings
+          CURRENT_TAG="v${{ github.event.inputs.version }}"
+
+          # Find previous tag
+          PREV_TAG=$(git tag --sort=-v:refname | grep -v "^${CURRENT_TAG}$" | head -n1 || echo "")
+
+          if [ -n "$PREV_TAG" ]; then
+            RANGE="$PREV_TAG..HEAD"
+          else
+            RANGE="HEAD"
+          fi
+
+          export CURRENT_TAG PREV_TAG RANGE
+          python scripts/gen_changelog.py > release_notes.md
+
+          echo "Generated release notes:"
+          cat release_notes.md
 
       - name: Build package
-        run: python -m build
+        run: |
+          python -m build
+
+      - name: Check package
+        run: |
+          twine check dist/*
 
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v1
@@ -120,5 +121,11 @@ jobs:
             dist/*.whl
             dist/*.tar.gz
           draft: ${{ github.event.inputs.draft }}
-          prerelease: ${{ contains(github.event.inputs.version, 'rc') || contains(github.event.inputs.version, 'beta') || contains(github.event.inputs.version, 'alpha') }}
-  # Publication to PyPI is performed by publish.yml upon release publication to avoid duplication.
+          prerelease: ${{ github.event.inputs.prerelease }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Summary
+        run: |
+          echo "✅ Successfully created manual release for v${{ github.event.inputs.version }}!"
+          echo "🔗 Release URL: https://github.com/${{ github.repository }}/releases/tag/v${{ github.event.inputs.version }}"