Add git-tag script for creating and pushing annotated release tags

Author: MarkusB

scripts/git-tag

@@ -0,0 +1,75 @@
+#!/usr/bin/env python3
+"""Create an annotated release tag and push to origin (see --help)."""
+
+from __future__ import annotations
+
+import argparse
+import subprocess
+import sys
+
+
+def _run_git(args: list[str], **kwargs) -> subprocess.CompletedProcess[str]:
+    return subprocess.run(
+        ["git", *args],
+        check=True,
+        capture_output=True,
+        text=True,
+        **kwargs,
+    )
+
+
+def _git_ok(args: list[str]) -> bool:
+    r = subprocess.run(["git", *args], capture_output=True)
+    return r.returncode == 0
+
+
+def main() -> int:
+    p = argparse.ArgumentParser(
+        description=(
+            "Create an annotated tag at HEAD with message 'Release TAG', "
+            "then push to origin. Refuses if the working tree is dirty or the tag exists."
+        )
+    )
+    p.add_argument("tag", help='e.g. v1.2.0')
+    p.add_argument(
+        "--no-push",
+        action="store_true",
+        help="only create the tag locally",
+    )
+    args = p.parse_args()
+    tag = args.tag
+
+    if not _git_ok(["rev-parse", "--is-inside-work-tree"]):
+        print("Error: not inside a Git repository", file=sys.stderr)
+        return 1
+
+    if _git_ok(["show-ref", "--verify", "--quiet", f"refs/tags/{tag}"]):
+        print(f"Error: tag {tag!r} already exists", file=sys.stderr)
+        return 1
+
+    st = subprocess.run(
+        ["git", "status", "--porcelain"],
+        check=True,
+        capture_output=True,
+        text=True,
+    )
+    if st.stdout.strip():
+        print(
+            "Error: working tree is not clean; commit or stash before tagging",
+            file=sys.stderr,
+        )
+        return 1
+
+    _run_git(["tag", "-a", tag, "-m", f"Release {tag}"])
+    short = _run_git(["rev-parse", "--short", "HEAD"]).stdout.strip()
+    print(f"Created annotated tag {tag} at {short}")
+
+    if not args.no_push:
+        _run_git(["push", "origin", tag])
+        print(f"Pushed {tag} to origin")
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

scripts/git-tag.cmd

@@ -0,0 +1,4 @@
+@echo off
+setlocal
+python "%~dp0git-tag" %*
+endlocal