Skip to content

Release diff text

release_diff_text

Text renderers for git_release_diff (dual-format ToolResult).

render_failure_text(*, error, data)

Render the failure-path text representation.

Source code in packages/axm-git/src/axm_git/tools/release_diff_text.py
Python
78
79
80
81
82
83
84
85
86
def render_failure_text(*, error: str, data: dict[str, object] | None) -> str:
    """Render the failure-path text representation."""
    header = f"git_release_diff | ✗ | {error}"
    if data is None:
        return header
    current = data.get("current_tag")
    if current is not None:
        return f"{header}\nprev {_as_str(current, 'none')}"
    return header

render_text(data)

Render the success-path data dict.

Header carries the current tag, the suggested bump + next version, the breaking flag and the commit count; a second line carries the diffstat, files changed and the public-API flag.

Source code in packages/axm-git/src/axm_git/tools/release_diff_text.py
Python
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
def render_text(data: dict[str, object]) -> str:
    """Render the success-path ``data`` dict.

    Header carries the current tag, the suggested bump + next version, the
    breaking flag and the commit count; a second line carries the diffstat,
    files changed and the public-API flag.
    """
    current = _as_str(data.get("current_tag"), "none")
    bump = _as_str(data.get("suggested_bump"))
    nxt = _as_str(data.get("suggested_next"))
    commits = data.get("commits_since")
    count = len(commits) if isinstance(commits, list) else 0
    sections = [current, f"{bump} -> {nxt}"]
    if data.get("breaking"):
        sections.append("breaking")
    sections.append(f"{count} commits")
    header = f"git_release_diff | ✓ | {' · '.join(sections)}"

    detail = [
        _as_str(data.get("diffstat"), "+0 / -0"),
        f"{_as_int(data.get('files_changed'))} files",
    ]
    if data.get("public_api_touched"):
        detail.append("public API touched")
    base = f"{header}\n{' · '.join(detail)}"

    block = _render_commits(data)
    return f"{base}\n{block}" if block else base