rekordbox-edit 0.7.0.dev71__tar.gz → 0.7.0.dev72__tar.gz

rekordbox_edit-0.7.0.dev72/.github/actions/build-release-notes/action.yml

@@ -0,0 +1,25 @@
+name: "Build Release Notes"
+description: "Generate categorized, per-commit release notes with each commit's PR resolved and its author credited"
+inputs:
+  from_tag:
+    description: "Tag to start the changelog range from (exclusive). Leave empty for full history."
+    required: false
+    default: ""
+  to_tag:
+    description: "Tag to end the changelog range at (inclusive)"
+    required: true
+  github_token:
+    description: "GitHub token for API access"
+    required: true
+runs:
+  using: "composite"
+  steps:
+    - name: Generate release notes
+      shell: bash
+      run: python3 "${GITHUB_ACTION_PATH}/build_release_notes.py"
+      env:
+        FROM_TAG: ${{ inputs.from_tag }}
+        TO_TAG: ${{ inputs.to_tag }}
+        OUTPUT_FILE: release-notes.md
+        REPO: ${{ github.repository }}
+        GH_TOKEN: ${{ inputs.github_token }}

rekordbox_edit-0.7.0.dev72/.github/actions/build-release-notes/build_release_notes.py

@@ -0,0 +1,169 @@
+#!/usr/bin/env python3
+"""Build categorized release notes from commits, linking each commit's PR.
+
+Lists one entry per commit (not per PR) between ``FROM_TAG`` (exclusive) and
+``TO_TAG`` (inclusive). Each entry links the pull request that introduced the
+commit and credits its author. The PR (number and author login) is resolved via
+``GET /repos/{repo}/commits/{sha}/pulls``, which works for both squash and
+rebase merges. Commits with no associated PR fall back to a short-SHA reference
+and the git author name.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import re
+import subprocess
+import sys
+from dataclasses import dataclass, field
+
+# Category matchers, evaluated in order; first match wins. Mirrors the
+# conventional-commit types accepted by the project's commitizen schema.
+_BREAKING_TITLE = re.compile(r"^(BREAKING(\(.*\))?:|(\w+)?(\(.*\))?!:)")
+_BREAKING_BODY = re.compile(r"BREAKING[\- ]CHANGE")
+_CATEGORY_TITLE_RULES: list[tuple[str, re.Pattern[str]]] = [
+    ("## Features", re.compile(r"^feat(\(.*\))?:")),
+    ("## Fixes", re.compile(r"^fix(?!\(deps\))(\(.*\))?:")),
+    (
+        "## Chores",
+        re.compile(
+            r"^(chore(?!\(deps\))|refactor|ci|docs|style|perf|test|build)(\(.*\))?:"
+        ),
+    ),
+    ("## Dependency Updates", re.compile(r"^(chore|fix)\(deps\):")),
+]
+_BREAKING_TITLE_HEADER = "## Breaking Changes"
+_UNCATEGORIZED_HEADER = "## Uncategorized"
+_CATEGORY_ORDER = [
+    _BREAKING_TITLE_HEADER,
+    "## Features",
+    "## Fixes",
+    "## Chores",
+    "## Dependency Updates",
+    _UNCATEGORIZED_HEADER,
+]
+
+# Commits that are noise in a changelog: merge commits are dropped at the
+# ``git log`` level (--no-merges); version-bump commits are filtered here.
+_SKIP_SUBJECT = re.compile(r"^bump:")
+# A trailing "(#NN)" left by squash merges, stripped so it is not duplicated
+# alongside the resolved reference.
+_TRAILING_PR = re.compile(r"\s*\(#\d+\)\s*$")
+
+_RECORD_SEP = "\x1e"
+_FIELD_SEP = "\x1f"
+
+
+@dataclass
+class Commit:
+    sha: str
+    subject: str
+    body: str
+    author: str
+
+
+@dataclass
+class Category:
+    header: str
+    lines: list[str] = field(default_factory=list)
+
+
+def _run(args: list[str]) -> subprocess.CompletedProcess[str]:
+    return subprocess.run(args, capture_output=True, text=True, encoding="utf-8")
+
+
+def read_commits(from_tag: str, to_tag: str) -> list[Commit]:
+    rng = f"{from_tag}..{to_tag}" if from_tag else to_tag
+    fmt = _FIELD_SEP.join(["%H", "%s", "%b", "%an"]) + _RECORD_SEP
+    result = _run(["git", "log", "--no-merges", f"--format={fmt}", rng])
+    if result.returncode != 0:
+        raise SystemExit(f"git log failed for range '{rng}': {result.stderr.strip()}")
+
+    commits: list[Commit] = []
+    for record in result.stdout.split(_RECORD_SEP):
+        record = record.strip("\n")
+        if not record:
+            continue
+        sha, subject, body, author = (record.split(_FIELD_SEP) + ["", "", ""])[:4]
+        commits.append(
+            Commit(
+                sha=sha,
+                subject=subject.strip(),
+                body=body.strip(),
+                author=author.strip(),
+            )
+        )
+    return commits
+
+
+def resolve_pr(repo: str, sha: str) -> tuple[int, str] | None:
+    """Return the (number, author_login) of a commit's PR, or None if unresolved."""
+    result = _run(["gh", "api", f"repos/{repo}/commits/{sha}/pulls"])
+    if result.returncode != 0 or not result.stdout.strip():
+        return None
+    try:
+        prs = json.loads(result.stdout)
+    except json.JSONDecodeError:
+        return None
+    merged = [pr for pr in prs if pr.get("merged_at")]
+    chosen = merged[0] if merged else (prs[0] if prs else None)
+    if not chosen:
+        return None
+    login = (chosen.get("user") or {}).get("login", "")
+    return chosen["number"], login
+
+
+def categorize(commit: Commit) -> str:
+    if _BREAKING_TITLE.match(commit.subject) or _BREAKING_BODY.search(commit.body):
+        return _BREAKING_TITLE_HEADER
+    for header, pattern in _CATEGORY_TITLE_RULES:
+        if pattern.match(commit.subject):
+            return header
+    return _UNCATEGORIZED_HEADER
+
+
+def render_line(commit: Commit, repo: str) -> str:
+    subject = _TRAILING_PR.sub("", commit.subject)
+    pr = resolve_pr(repo, commit.sha)
+    if pr is not None:
+        number, login = pr
+        credit = f"#{number} by @{login}" if login else f"#{number}"
+        return f"- {subject} ({credit})"
+    return f"- {subject} ({commit.sha[:7]} by {commit.author})"
+
+
+def build_notes(commits: list[Commit], repo: str) -> str:
+    categories = {header: Category(header) for header in _CATEGORY_ORDER}
+    for commit in commits:
+        if _SKIP_SUBJECT.match(commit.subject):
+            continue
+        categories[categorize(commit)].lines.append(render_line(commit, repo))
+
+    sections = [
+        f"{cat.header}\n" + "\n".join(cat.lines)
+        for header in _CATEGORY_ORDER
+        if (cat := categories[header]).lines
+    ]
+    return "\n\n".join(sections) if sections else "_No changes._"
+
+
+def main() -> None:
+    to_tag = os.environ.get("TO_TAG", "").strip()
+    if not to_tag:
+        raise SystemExit("TO_TAG is required")
+    from_tag = os.environ.get("FROM_TAG", "").strip()
+    repo = os.environ.get("REPO") or os.environ.get("GITHUB_REPOSITORY", "")
+    if not repo:
+        raise SystemExit("REPO (or GITHUB_REPOSITORY) is required")
+    output_file = os.environ.get("OUTPUT_FILE", "release-notes.md")
+
+    commits = read_commits(from_tag, to_tag)
+    notes = build_notes(commits, repo)
+    with open(output_file, "w", encoding="utf-8") as handle:
+        handle.write(notes + "\n")
+    print(notes, file=sys.stderr)
+
+
+if __name__ == "__main__":
+    main()

{rekordbox_edit-0.7.0.dev71 → rekordbox_edit-0.7.0.dev72}/CHANGELOG.md

@@ -1,6 +1,7 @@
-## v0.7.0.dev71 (2026-07-31)
+## v0.7.0.dev72 (2026-07-31)
 
 
+- ci: more precise changelogs on releases
 - chore: update AGENTS.md
 - docs: pave FAQ page based on convert + analysis research
 - feat(convert): verify source codec against FileType before converting

{rekordbox_edit-0.7.0.dev71 → rekordbox_edit-0.7.0.dev72}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rekordbox-edit
-Version: 0.7.0.dev71
+Version: 0.7.0.dev72
 Summary: Tools for managing and modifying a RekordBox library en-masse
 Project-URL: Homepage, https://github.com/jviall/rekordbox-edit
 Project-URL: Repository, https://github.com/jviall/rekordbox-edit

{rekordbox_edit-0.7.0.dev71 → rekordbox_edit-0.7.0.dev72}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rekordbox-edit"
-version = "0.7.0.dev71"
+version = "0.7.0.dev72"
 description = "Tools for managing and modifying a RekordBox library en-masse"
 authors = [{ name = "James Viall", email= "jamesviall@pm.me"}]
 license = "MIT"
@@ -91,8 +91,8 @@ message_template = "{{change_type}}{{scope}}: {{message}}"
 example = "feat(convert): add new conversion feature"
 schema = "<type>(<scope>): <body>"
 schema_pattern = "^(BREAKING|feat|fix|refactor|ci|test|docs|chore)(\\([^)]*\\))?!?: .+"
-bump_pattern = "^(BREAKING|feat|fix|perf|hotfix|refactor)"
-bump_map = { "BREAKING" = "MAJOR", "feat" = "MINOR", "fix" = "PATCH", "refactor" = "PATCH" }
+bump_pattern = "^((BREAKING[\\-\\ ]CHANGE|BREAKING|feat|fix|perf|hotfix|refactor)(\\(.+\\))?!?):"
+bump_map = { "^.+!$" = "MAJOR", "^BREAKING" = "MAJOR", "^feat" = "MINOR", "^fix" = "PATCH", "^refactor" = "PATCH" }
 
 [[tool.commitizen.customize.questions]]
 type = "list"

{rekordbox_edit-0.7.0.dev71 → rekordbox_edit-0.7.0.dev72}/uv.lock

@@ -1268,7 +1268,7 @@ wheels = [
 
 [[package]]
 name = "rekordbox-edit"
-version = "0.7.0.dev71"
+version = "0.7.0.dev72"
 source = { editable = "." }
 dependencies = [
     { name = "click" },

rekordbox_edit-0.7.0.dev71/.github/actions/build-release-notes/action.yml

@@ -1,88 +0,0 @@
-name: "Build Release Notes"
-description: "Generate categorized release notes from conventional commits between two tags"
-inputs:
-  from_tag:
-    description: "Tag to start the changelog range from (exclusive)"
-    required: true
-  to_tag:
-    description: "Tag to end the changelog range at (inclusive)"
-    required: true
-  github_token:
-    description: "GitHub token for API access"
-    required: true
-runs:
-  using: "composite"
-  steps:
-    - uses: mikepenz/release-changelog-builder-action@c9bcd8238b6f41e05561348339429d360b1c0247 # v6.2.3
-      with:
-        outputFile: release-notes.md
-        configurationJson: |
-          {
-            "categories": [
-              {
-                "title": "## Breaking Changes",
-                "labels": [],
-                "rules": [
-                  {
-                    "pattern": "^(\\w+)?(\\(.*\\))?!:",
-                    "on_property": "title"
-                  }
-                ]
-              },
-              {
-                "title": "## Features",
-                "labels": [],
-                "rules": [
-                  {
-                    "pattern": "^feat(\\(.*\\))?:",
-                    "on_property": "title"
-                  }
-                ]
-              },
-              {
-                "title": "## Fixes",
-                "labels": [],
-                "rules": [
-                  {
-                    "pattern": "^fix(?!\\(deps\\))(\\(.*\\))?:",
-                    "on_property": "title"
-                  }
-                ]
-              },
-              {
-                "title": "## Chores",
-                "labels": [],
-                "rules": [
-                  {
-                    "pattern": "^(chore(?!\\(deps\\))|refactor|ci|docs|style|perf|test|build)(\\(.*\\))?:",
-                    "on_property": "title"
-                  }
-                ]
-              },
-              {
-                "title": "## Dependency Updates",
-                "labels": [],
-                "rules": [
-                  {
-                    "pattern": "^(chore|fix)\\(deps\\):",
-                    "on_property": "title"
-                  }
-                ]
-              }
-            ],
-            "exhaustive": true,
-            "sort": {
-              "order": "ASC",
-              "on_property": "title"
-            },
-            "template": "#{{CHANGELOG}}\n\n## Uncategorized\n#{{UNCATEGORIZED}}",
-            "pr_template": "- #{{TITLE}} (##{{NUMBER}} by @#{{AUTHOR}})",
-            "empty_template": "- No changes",
-            "tag_resolver": {
-              "method": "sort"
-            }
-          }
-        fromTag: ${{ inputs.from_tag }}
-        toTag: ${{ inputs.to_tag }}
-      env:
-        GITHUB_TOKEN: ${{ inputs.github_token }}