Streamline release process

Author: mtkennerly

CONTRIBUTING.md

@@ -29,3 +29,9 @@ Commands defined in `tasks.py`:
   invoke test
   ```
   [Git Bash](https://git-scm.com) is recommended for Windows.
+
+## Release
+* Run `invoke prerelease`
+* Verify the changes and `git add` them
+* Run `invoke release`
+* Create a release on GitHub for the new tag and attach the artifacts from `dist`

tasks.py

@@ -1,5 +1,8 @@
 import os
+import re
 import shutil
+import sys
+import datetime as dt
 from pathlib import Path
 
 from invoke import task
@@ -16,7 +19,19 @@ def get_version() -> str:
         if line.startswith("version ="):
             return line.replace("version = ", "").strip('"')
 
-    return "0.0.0"
+    raise RuntimeError("Could not determine version")
+
+
+def replace_pattern_in_file(file: Path, old: str, new: str, count: int = 1):
+    content = file.read_text("utf-8")
+    updated = re.sub(old, new, content, count=count)
+    file.write_text(updated, "utf-8")
+
+
+def confirm(prompt: str):
+    response = input(f"Confirm by typing '{prompt}': ")
+    if response.lower() != prompt.lower():
+        sys.exit(1)
 
 
 @task
@@ -125,3 +140,37 @@ def docs(ctx):
     joined = " ".join(arg if " " not in arg else f'"{arg}"' for arg in args)
 
     ctx.run(joined)
+
+
+@task
+def prerelease(ctx, new_version):
+    date = dt.datetime.now().strftime("%Y-%m-%d")
+
+    replace_pattern_in_file(
+        ROOT / "pyproject.toml",
+        'version = ".+"',
+        f'version = "{new_version}"',
+    )
+
+    replace_pattern_in_file(
+        ROOT / "CHANGELOG.md",
+        "## Unreleased",
+        f"## v{new_version} ({date})",
+    )
+
+    build(ctx, clean=True)
+    docs(ctx)
+
+
+@task
+def release(ctx):
+    version = get_version()
+
+    confirm(f"release {version}")
+
+    ctx.run(f'git commit -m "Release v{version}"')
+    ctx.run(f'git tag v{version} -m "Release"')
+    ctx.run("git push")
+    ctx.run("git push origin tag v{version}")
+
+    ctx.run("poetry publish")