Create release notes

Author: spoorcc

CHANGELOG.rst

@@ -1,6 +1,10 @@
 Release 0.11.0 (unreleased)
 ====================================
 
+.. note::
+
+    This is the latest unreleased version and may change
+
 * Support python 3.14
 * Drop python 3.7, 3.8 support (#801)
 * Don't show animation when running in CI (#702)

script/create_release_notes.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+"""
+create_release_notes.py
+
+Extracts the latest section from CHANGELOG.rst.
+If --latest is provided, adds an admonition that it is unreleased.
+"""
+
+import argparse
+import re
+from pathlib import Path
+
+
+def extract_latest_section(changelog_path: Path) -> str:
+    """
+    Extract the latest release section from a CHANGELOG.rst file.
+    """
+    content = changelog_path.read_text(encoding="utf-8")
+    lines = content.splitlines()
+
+    # Find lines starting with version headings like: 'v1.2.3' or '.. version'
+    # dfetch uses "vX.Y.Z" style headings in CHANGELOG.rst
+    version_header_pattern = re.compile(r"^Release \d+\.\d+\.\d+")
+
+    start_idx = None
+    end_idx = None
+
+    for idx, line in enumerate(lines):
+        if version_header_pattern.match(line.strip()):
+            start_idx = idx
+            break
+
+    if start_idx is None:
+        raise ValueError("No release section found in CHANGELOG.rst")
+
+    # Find the next version header to determine the end
+    for idx in range(start_idx + 1, len(lines)):
+        if version_header_pattern.match(lines[idx].strip()):
+            end_idx = idx
+            break
+
+    section_lines = lines[start_idx:end_idx]
+    return "\n".join(section_lines).strip()
+
+
+def main():
+    """Main CLI entry."""
+    parser = argparse.ArgumentParser(
+        description="Create release notes from CHANGELOG.rst"
+    )
+    parser.add_argument(
+        "--changelog", default="CHANGELOG.rst", help="Path to CHANGELOG.rst"
+    )
+    args = parser.parse_args()
+
+    changelog_path = Path(args.changelog)
+    if not changelog_path.exists():
+        print(f"Error: {changelog_path} not found.")
+        return
+
+    release_notes = extract_latest_section(changelog_path)
+    print(release_notes)
+
+
+if __name__ == "__main__":
+    main()