feat: copies github actions workflow release.yml to user's local machine

Author: softwareentrepreneer

afterpython/_paths.py

@@ -5,6 +5,7 @@
 @dataclass
 class Paths:
     package_path: Path = field(init=False)
+    templates_path: Path = field(init=False)
     user_path: Path = field(init=False)
     pyproject_path: Path = field(init=False)
     afterpython_path: Path = field(init=False)
@@ -15,6 +16,7 @@ class Paths:
     def __post_init__(self):
         # package path is the path to the afterpython package in user's site-packages
         self.package_path = Path(__file__).resolve().parents[0]
+        self.templates_path = self.package_path / "templates"
         self.user_path = self._find_project_root()
         self.pyproject_path = self.user_path / "pyproject.toml"
         self.afterpython_path = self.user_path / "afterpython"

afterpython/cli/commands/init.py

@@ -14,7 +14,7 @@ def init_ruff_toml():
     if ruff_toml_path.exists():
         click.echo(f"Ruff configuration file {ruff_toml_path} already exists")
         return
-    ruff_template_path = ap.paths.package_path / "ruff-template.toml"
+    ruff_template_path = ap.paths.templates_path / "ruff-template.toml"
     shutil.copy(ruff_template_path, ruff_toml_path)
     click.echo(f"Created {ruff_toml_path}")
     # add ruff-pre-commit hook to .pre-commit-config.yaml
@@ -55,6 +55,7 @@ def init(ctx):
     from afterpython.tools.myst import init_myst
     from afterpython.tools.pre_commit import init_pre_commit
     from afterpython.tools.commitizen import init_commitizen
+    from afterpython.tools.github_actions import init_release_workflow
 
     paths = ctx.obj["paths"]
     click.echo("Initializing afterpython...")
@@ -84,7 +85,9 @@ def init(ctx):
         init_ruff_toml()
 
     if click.confirm(
-        f"\nCreate commitizen configuration (cz.toml) in {afterpython_path}?",
+        f"\nCreate commitizen configuration (cz.toml) in {afterpython_path} "
+        f"and release workflow in .github/workflows/release.yml?",
         default=True,
     ):
         init_commitizen()
+        init_release_workflow()

afterpython/templates/release-workflow-template.yml

@@ -0,0 +1,56 @@
+name: Release to PyPI and GitHub
+
+on:
+  push:
+    tags:
+      - 'v*'  # Trigger on all version tags (v0.1.0, v0.1.0rc1, v0.1.0.dev4, etc.)
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write  # Required for creating GitHub releases
+      id-token: write  # Required for PyPI trusted publishing
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish
+
+      - name: Determine if pre-release
+        id: check_prerelease
+        run: |
+          # Extract version from tag (remove 'v' prefix)
+          VERSION="${GITHUB_REF_NAME#v}"
+
+          # Check if this is a pre-release or dev version
+          # Matches: dev, rc, alpha, beta, a1, b2 (but not 'stable-version')
+          if [[ "$VERSION" =~ (dev|rc|alpha|beta|a[0-9]+|b[0-9]+) ]]; then
+            echo "prerelease=true" >> $GITHUB_OUTPUT
+          else
+            echo "prerelease=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: ${{ github.ref_name }}
+          generate_release_notes: false
+          prerelease: ${{ steps.check_prerelease.outputs.prerelease }}
+          files: dist/*  # Attach built packages (wheel + sdist)

afterpython/ruff-template.toml afterpython/templates/ruff-template.tomlafterpython/ruff-template.toml renamed to afterpython/templates/ruff-template.toml

@@ -0,0 +1,46 @@
+import shutil
+
+import click
+
+import afterpython as ap
+
+
+def init_release_workflow():
+    """Initialize GitHub Actions release workflow.
+
+    Creates .github/workflows/release.yml in the user's project root.
+    This workflow triggers on version tags and:
+    - Builds the package with uv
+    - Publishes to PyPI using trusted publishing
+    - Creates GitHub releases (with pre-release detection)
+    """
+    user_path = ap.paths.user_path
+    workflow_dir = user_path / ".github" / "workflows"
+    workflow_path = workflow_dir / "release.yml"
+
+    if workflow_path.exists():
+        click.echo(f"GitHub Actions release workflow {workflow_path} already exists")
+        return
+
+    # Create .github/workflows directory if it doesn't exist
+    workflow_dir.mkdir(parents=True, exist_ok=True)
+
+    # Copy template from package
+    template_path = ap.paths.templates_path / "release-workflow-template.yml"
+    if not template_path.exists():
+        raise FileNotFoundError(
+            f"Template file not found: {template_path}\n"
+            "This might indicate a corrupted installation. Please reinstall afterpython."
+        )
+
+    shutil.copy(template_path, workflow_path)
+    click.echo(f"Created {workflow_path}")
+    click.echo(
+        "\n📋 Next steps to enable releases:\n"
+        "   1. Enable PyPI trusted publishing:\n"
+        "      - Go to https://pypi.org/manage/account/publishing/\n"
+        "      - Add your repository and workflow file: release.yml\n"
+        "   2. Push tags to trigger releases:\n"
+        "      - Use 'ap bump --release' for stable releases (auto-pushes tag)\n"
+        "      - Use 'ap bump --pre' then 'ap release' for pre-releases\n"
+    )