Source/Changes: Add change log aggregator from Goof suite (#39)

* Source/Changes: Add change log aggregator from Goof suite

* Source/Changes: Add CLI interface, and work on single directories

* Source/Changes: Trim reStructuredText output

Author: amotl

CHANGES.md

@@ -5,6 +5,7 @@
   to root message and producer.
 - Documentation: Added dedicated pages about sandbox installation,
   and text vs. slack reports
+- Source/Changes: Added change log aggregator from _Goof suite_
 
 ## v0.5.0, 2025-03-09
 - GitHub/Attention: Compare labels per lower-case
@@ -16,7 +17,7 @@
 - Shell/Notify: Fixed invocation without `--zap=`
 - Shell/Notify: Improved preamble, adding "Producer" field
 - Shell/Report: Made `--github-repository` option optional
-- Shell/Animate: Added PyGource renderer from _goof suite_
+- Shell/Animate: Added PyGource renderer from _Goof suite_
 
 ## v0.4.0, 2025-03-05
 - GitHub/Attention: Also display `state==closed` items, formatting them

docs/conf.py

@@ -9,7 +9,7 @@
 # ruff: noqa: ERA001
 
 project = "Rapporto"
-copyright = "2013-2025, The Panodata Developers"  # noqa: A001
+copyright = "2011-2025, The Panodata Developers"  # noqa: A001
 author = "The Panodata Developers"
 
 # -- General configuration ---------------------------------------------------

src/rapporto/animate/git.py

@@ -16,6 +16,7 @@
 References:
 - https://gource.io/
 - https://github.com/acaudwell/Gource
+- zt.manticore.ext.gource
 """
 
 # Relax linter.

src/rapporto/cli.py

@@ -4,6 +4,7 @@
 from rapporto.animate.cli import cli as animate_cli
 from rapporto.notify.cli import cli as notify_cli
 from rapporto.report.cli import cli as report_cli
+from rapporto.source.changes.cli import cli as changes_cli
 from rapporto.source.github.cli import cli as github_cli
 from rapporto.source.opsgenie.cli import cli as opsgenie_cli
 from rapporto.source.slack.cli import cli as slack_cli
@@ -25,3 +26,4 @@ def cli(ctx: click.Context, verbose: bool, debug: bool):
 cli.add_command(notify_cli, "notify")
 cli.add_command(report_cli, "report")
 cli.add_command(animate_cli, "animate")
+cli.add_command(changes_cli, "changes")

src/rapporto/source/changes/__init__.py

@@ -0,0 +1,24 @@
+import typing as t
+
+import click
+
+from rapporto.source.changes.core import aggregate
+
+
+@click.command(context_settings=dict(ignore_unknown_options=True))
+@click.argument("input", type=click.UNPROCESSED, required=False, nargs=-1)
+@click.option("--output", type=str, required=False, help="Output path")
+@click.option(
+    "--format",
+    "format_",
+    type=click.Choice(["md", "rst", "text"]),
+    required=False,
+    default="rst",
+    help="Output format: 'md' for markdown, 'rst' for reStructuredText, 'text' for terminal output",
+)
+@click.pass_context
+def cli(ctx: click.Context, input: t.List[str], output: str, format_: str) -> None:  # noqa: A002
+    """
+    Aggregate change log files.
+    """
+    aggregate(input[0], output)