feat: ap update github actions workflows like ci.yml

Author: softwareentrepreneer

src/afterpython/cli/commands/update.py

@@ -28,6 +28,7 @@ def update():
 )
 @click.option(
     "--all",
+    "all_",
     is_flag=True,
     help="Also update pre-commit hooks and pixi dependencies",
 )
@@ -38,7 +39,7 @@ def update():
     metavar="PACKAGE",
     help="Package to exclude from upgrade (can be passed multiple times)",
 )
-def dependencies(upgrade: bool, all: bool, exclude: tuple[str, ...]):
+def dependencies(upgrade: bool, all_: bool, exclude: tuple[str, ...]):
     """Check and update project dependencies to latest versions"""
     from afterpython.pcu import get_dependencies, update_dependencies
     from afterpython.utils import has_pixi, has_uv
@@ -110,7 +111,7 @@ def dependencies(upgrade: bool, all: bool, exclude: tuple[str, ...]):
             click.echo(
                 "uv not found. Updated pyproject.toml only (packages not installed)."
             )
-    if upgrade and all:
+    if upgrade and all_:
         subprocess.run(["ap", "pre-commit", "autoupdate"])
         click.echo("All pre-commit hooks updated successfully.")
         if has_pixi():
@@ -141,6 +142,61 @@ def dependencies(upgrade: bool, all: bool, exclude: tuple[str, ...]):
 update.add_command(dependencies, name="deps")  # alias for "dependencies"
 
 
+@update.command()
+@click.option("--deploy", is_flag=True, help="Update .github/workflows/deploy.yml")
+@click.option("--ci", is_flag=True, help="Update .github/workflows/ci.yml")
+@click.option("--release", is_flag=True, help="Update .github/workflows/release.yml")
+@click.option("--dependabot", is_flag=True, help="Update .github/dependabot.yml")
+@click.option(
+    "--all",
+    "all_",
+    is_flag=True,
+    help="Update every supported workflow file",
+)
+@click.option(
+    "--no-backup",
+    is_flag=True,
+    help="Skip creating .backup copies of existing workflow files",
+)
+def workflows(
+    deploy: bool,
+    ci: bool,
+    release: bool,
+    dependabot: bool,
+    all_: bool,
+    no_backup: bool,
+):
+    """Update GitHub Actions workflow files (deploy, ci, release, dependabot)
+
+    Existing files are backed up to <file>.backup before being overwritten
+    so user customizations (matrix tweaks, extra steps, etc.) aren't lost.
+    """
+    from afterpython.tools.github_actions import (
+        VALID_WORKFLOWS,
+        update_workflow_file,
+    )
+
+    selected_flags = {
+        "deploy": deploy,
+        "ci": ci,
+        "release": release,
+        "dependabot": dependabot,
+    }
+    individual = [name for name, picked in selected_flags.items() if picked]
+
+    if all_ and individual:
+        raise click.UsageError("Pass --all or individual workflow flags, not both.")
+    if not all_ and not individual:
+        raise click.UsageError(
+            "Specify which workflows to update with flags "
+            "(e.g. --deploy --ci) or pass --all."
+        )
+
+    selected = VALID_WORKFLOWS if all_ else individual
+    for name in selected:
+        update_workflow_file(name, backup=not no_backup)
+
+
 @update.command()
 @click.pass_context
 @click.option(

src/afterpython/tools/github_actions.py

@@ -1,48 +1,82 @@
+# VIBE-CODED
 import shutil
 from pathlib import Path
 
 import click
 
 import afterpython as ap
 
+# Workflow names supported by `create_workflow` / `update_workflow_file`.
+# "dependabot" is included even though it lives at .github/dependabot.yml
+# (not under workflows/) so a single CLI surface can refresh all GH templates.
+VALID_WORKFLOWS = ("deploy", "ci", "release", "dependabot")
 
-def _copy_github_template(template_name: str, target_path: Path):
-    """Helper to copy GitHub-related templates"""
-    if target_path.exists():
-        click.echo(f"{target_path} already exists")
-        return
 
-    # Create parent directory if it doesn't exist
-    target_path.parent.mkdir(parents=True, exist_ok=True)
+def _resolve_workflow_target(name: str) -> tuple[Path, Path]:
+    """Return (target_path, template_path) for a workflow name."""
+    if name not in VALID_WORKFLOWS:
+        raise ValueError(
+            f"Unknown workflow '{name}'. Valid: {', '.join(VALID_WORKFLOWS)}"
+        )
+    user_path = ap.paths.user_path
+    templates_path = ap.paths.templates_path
+    if name == "dependabot":
+        target = user_path / ".github" / "dependabot.yml"
+        template = templates_path / "dependabot-template.yml"
+    else:
+        target = user_path / ".github" / "workflows" / f"{name}.yml"
+        template = templates_path / f"{name}-workflow-template.yml"
+    return target, template
 
-    # Copy template from package
-    template_path = ap.paths.templates_path / template_name
+
+def _copy_github_template(template_path: Path, target_path: Path):
+    """Copy a template file into the project, creating parent dirs as needed."""
     if not template_path.exists():
         raise FileNotFoundError(
             f"Template file not found: {template_path}\n"
             "This might indicate a corrupted installation. Please reinstall afterpython."
         )
-
+    target_path.parent.mkdir(parents=True, exist_ok=True)
     shutil.copy(template_path, target_path)
-    print(f"Created {target_path}")
 
 
 def create_workflow(workflow_name: str):
-    """Create a GitHub Actions workflow from template"""
+    """Create a GitHub Actions workflow from template (no-op if it exists)."""
     if ".yml" in workflow_name:
         workflow_name = workflow_name.replace(".yml", "")
 
-    user_path = ap.paths.user_path
-    workflow_path = user_path / ".github" / "workflows" / f"{workflow_name}.yml"
-    template_name = f"{workflow_name}-workflow-template.yml"
-
-    _copy_github_template(template_name, workflow_path)
+    target_path, template_path = _resolve_workflow_target(workflow_name)
+    if target_path.exists():
+        click.echo(f"{target_path} already exists")
+        return
+    _copy_github_template(template_path, target_path)
+    click.echo(f"Created {target_path}")
 
 
 def create_dependabot():
-    """Create Dependabot configuration for GitHub Actions updates"""
-    user_path = ap.paths.user_path
-    dependabot_path = user_path / ".github" / "dependabot.yml"
-    template_name = "dependabot-template.yml"
+    """Create Dependabot configuration for GitHub Actions updates."""
+    target_path, template_path = _resolve_workflow_target("dependabot")
+    if target_path.exists():
+        click.echo(f"{target_path} already exists")
+        return
+    _copy_github_template(template_path, target_path)
+    click.echo(f"Created {target_path}")
+
 
-    _copy_github_template(template_name, dependabot_path)
+def update_workflow_file(name: str, backup: bool = True):
+    """Overwrite a workflow file with the latest template.
+
+    If the target already exists and ``backup`` is True, the existing file is
+    copied to ``<file>.backup`` first so user customizations aren't lost.
+    """
+    target_path, template_path = _resolve_workflow_target(name)
+    if target_path.exists():
+        if backup:
+            backup_path = Path(str(target_path) + ".backup")
+            shutil.copy(target_path, backup_path)
+            click.echo(f"Backed up {target_path} → {backup_path}")
+        _copy_github_template(template_path, target_path)
+        click.echo(f"Updated {target_path}")
+    else:
+        _copy_github_template(template_path, target_path)
+        click.echo(f"Created {target_path}")