multicz 0.2.1__tar.gz → 0.3.0__tar.gz

{multicz-0.2.1 → multicz-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: multicz
-Version: 0.2.1
+Version: 0.3.0
 Summary: Multi-component versioning for monorepos: bump apps, charts, and images independently from conventional commits.
 Keywords: semver,monorepo,helm,conventional-commits,release,versioning
 Author: Chris

{multicz-0.2.1 → multicz-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "multicz"
-version = "0.2.1"
+version = "0.3.0"
 description = "Multi-component versioning for monorepos: bump apps, charts, and images independently from conventional commits."
 readme = "README.md"
 authors = [

multicz-0.3.0/src/multicz/__main__.py

@@ -0,0 +1,3 @@
+from .cli import app
+
+app()

{multicz-0.2.1 → multicz-0.3.0}/src/multicz/changelog.py

@@ -29,12 +29,24 @@ from __future__ import annotations
 
 import re
 from collections.abc import Iterable, Sequence
+from dataclasses import dataclass
 from datetime import date
 from pathlib import Path
 
 from .commits import Commit
 from .config import ChangelogSection, _default_changelog_sections
 
+
+@dataclass(frozen=True)
+class CascadeEntry:
+    """A non-commit reason for a bump (mirror or trigger), surfaced in
+    the changelog so cascade-only releases describe what made them
+    happen instead of rendering ``_No notable changes._``.
+    """
+
+    upstream: str
+    upstream_version: str
+
 _PREAMBLE = (
     "# Changelog\n"
     "\n"
@@ -49,16 +61,34 @@ def render_body(
     sections: Sequence[ChangelogSection] | None = None,
     breaking_title: str = "Breaking changes",
     other_title: str = "",
+    cascades: Sequence[CascadeEntry] | None = None,
+    cascade_title: str = "Dependencies",
+    cascade_format: str = "Track `{upstream}` `{upstream_version}`",
 ) -> str:
     """Render the section bodies (no leading H2).
 
     Empty string ``breaking_title`` disables the breaking bucket (breaking
     commits then fall through to whichever section claims their type).
     Empty string ``other_title`` drops unmatched conventional commits.
+
+    ``cascades`` lists upstream bumps that pulled this component along
+    (mirror writes, trigger edges). When present and ``cascade_title``
+    is non-empty, they render as a dedicated H3 section; this also
+    suppresses the ``_No notable changes._`` placeholder when no
+    commits otherwise apply.
     """
     sections = list(sections) if sections is not None else _default_changelog_sections()
     relevant = [c for c in commits if c.is_conventional]
-    if not relevant:
+    cascade_lines: list[str] = []
+    if cascades and cascade_title:
+        for entry in cascades:
+            cascade_lines.append(
+                cascade_format.format(
+                    upstream=entry.upstream,
+                    upstream_version=entry.upstream_version,
+                )
+            )
+    if not relevant and not cascade_lines:
         return "_No notable changes._\n"
 
     breaking: list[Commit] = []
@@ -94,7 +124,7 @@ def render_body(
     if other_title and other_title in buckets:
         ordered.append((other_title, buckets[other_title]))
 
-    if not ordered:
+    if not ordered and not cascade_lines:
         return "_No notable changes._\n"
 
     lines: list[str] = []
@@ -105,6 +135,12 @@ def render_body(
             scope = f"**{commit.scope}**: " if commit.scope else ""
             lines.append(f"- {scope}{commit.subject} (`{commit.sha[:7]}`)")
         lines.append("")
+    if cascade_lines:
+        lines.append(f"### {cascade_title}")
+        lines.append("")
+        for entry in cascade_lines:
+            lines.append(f"- {entry}")
+        lines.append("")
     return "\n".join(lines)
 
 
@@ -116,6 +152,9 @@ def render_section(
     sections: Sequence[ChangelogSection] | None = None,
     breaking_title: str = "Breaking changes",
     other_title: str = "",
+    cascades: Sequence[CascadeEntry] | None = None,
+    cascade_title: str = "Dependencies",
+    cascade_format: str = "Track `{upstream}` `{upstream_version}`",
 ) -> str:
     """Render the markdown for a single release section."""
     when = (today or date.today()).isoformat()
@@ -124,6 +163,9 @@ def render_section(
         sections=sections,
         breaking_title=breaking_title,
         other_title=other_title,
+        cascades=cascades,
+        cascade_title=cascade_title,
+        cascade_format=cascade_format,
     )
     return f"## [{version}] - {when}\n\n" + body
 
@@ -174,6 +216,9 @@ def update_changelog_file(
     breaking_title: str = "Breaking changes",
     other_title: str = "",
     drop_prereleases: bool = False,
+    cascades: Sequence[CascadeEntry] | None = None,
+    cascade_title: str = "Dependencies",
+    cascade_format: str = "Track `{upstream}` `{upstream_version}`",
 ) -> None:
     """Render a new section and merge it into ``path`` (creating the file if needed).
 
@@ -188,6 +233,9 @@ def update_changelog_file(
         sections=sections,
         breaking_title=breaking_title,
         other_title=other_title,
+        cascades=cascades,
+        cascade_title=cascade_title,
+        cascade_format=cascade_format,
     )
     existing = path.read_text(encoding="utf-8") if path.exists() else ""
     if drop_prereleases:

{multicz-0.2.1 → multicz-0.3.0}/src/multicz/cli.py

@@ -14,7 +14,7 @@ from rich.console import Console
 from rich.table import Table
 
 from . import __version__
-from .changelog import render_body, update_changelog_file
+from .changelog import CascadeEntry, render_body, update_changelog_file
 from .commits import (
     DEFAULT_TYPES,
     commits_in_range,
@@ -1047,7 +1047,8 @@ def _run_post_bump_hook(repo: Path, command: str) -> None:
     args = shlex.split(command)
     if not args:
         return
-    console.print(f"  [dim]post_bump:[/] {command}")
+    # stderr, so `multicz bump --output json | jq` stays parseable.
+    err.print(f"  [dim]post_bump:[/] {command}")
     result = subprocess.run(
         args, cwd=repo, capture_output=True, text=True
     )
@@ -1375,6 +1376,27 @@ def bump(
                     planned.component, config, repo, matcher,
                     since_stable=use_stable_since,
                 )
+                # Surface mirror/trigger cascades as a Dependencies
+                # section: when a release is purely cascade-driven
+                # (e.g. chart bumps because api updated appVersion),
+                # this is the only thing that explains *why* the
+                # release exists.
+                cascade_entries: list[CascadeEntry] = []
+                seen_upstreams: set[str] = set()
+                for reason in planned.reasons:
+                    if isinstance(reason, MirrorReason | TriggerReason):
+                        if reason.upstream in seen_upstreams:
+                            continue
+                        upstream_planned = plan.bumps.get(reason.upstream)
+                        if upstream_planned is None:
+                            continue
+                        cascade_entries.append(
+                            CascadeEntry(
+                                upstream=reason.upstream,
+                                upstream_version=upstream_planned.next,
+                            )
+                        )
+                        seen_upstreams.add(reason.upstream)
                 changelog_path = repo / comp.changelog
                 update_changelog_file(
                     changelog_path,
@@ -1384,6 +1406,9 @@ def bump(
                     breaking_title=config.project.breaking_section_title,
                     other_title=config.project.other_section_title,
                     drop_prereleases=is_final and strategy == "promote",
+                    cascades=cascade_entries,
+                    cascade_title=config.project.cascade_section_title,
+                    cascade_format=config.project.cascade_changelog_format,
                 )
                 if changelog_path not in written:
                     written.append(changelog_path)

{multicz-0.2.1 → multicz-0.3.0}/src/multicz/config.py

@@ -231,6 +231,14 @@ class ProjectSettings(BaseModel):
     )
     breaking_section_title: str = "Breaking changes"
     other_section_title: str = ""
+    # Section + line format for cascade-only bumps (mirror or trigger).
+    # Replaces the legacy ``_No notable changes._`` placeholder when the
+    # only reason for a release is an upstream component bumping. Set
+    # ``cascade_section_title = ""`` to disable and fall back to the
+    # placeholder. ``cascade_changelog_format`` accepts ``{upstream}`` and
+    # ``{upstream_version}`` placeholders.
+    cascade_section_title: str = "Dependencies"
+    cascade_changelog_format: str = "Track `{upstream}` `{upstream_version}`"
     finalize_strategy: Literal["consolidate", "promote", "annotate"] = "consolidate"
     overlap_policy: Literal["error", "first-match", "allow", "all"] = "error"
     ignored_types: list[str] = Field(default_factory=list)