Function snapshot_diff

unity_cli/cli/commands/uitree.py:730–754

Compare current UI tree against a saved snapshot. Examples: u uitree snapshot diff -p "PanelSettings" --name baseline

(
    ctx: typer.Context,
    panel: Annotated[str, typer.Option("--panel", "-p", help="Panel name")],
    name: Annotated[str, typer.Option("--name", help="Baseline snapshot name")],
    json_flag: Annotated[bool, typer.Option("--json", help="Output as JSON")] = False,
)

@snapshot_app.command("diff")
@handle_cli_errors
def snapshot_diff(
    ctx: typer.Context,
    panel: Annotated[str, typer.Option("--panel", "-p", help="Panel name")],
    name: Annotated[str, typer.Option("--name", help="Baseline snapshot name")],
    json_flag: Annotated[bool, typer.Option("--json", help="Output as JSON")] = False,
) -> None:
    """Compare current UI tree against a saved snapshot.

    Examples:
        u uitree snapshot diff -p "PanelSettings" --name baseline
    """
    from unity_cli.api.uitree_snapshot import SnapshotStore

    context: CLIContext = ctx.obj
    current = context.client.uitree.dump(panel=panel, format="json")
    try:
        result = SnapshotStore().diff(name, current)
    except FileNotFoundError:
        print_line(f"Snapshot '{name}' not found")
        raise typer.Exit(1) from None

    if _should_json(context, json_flag):
        print_json(result, None)
    else:
        _print_diff_result(result)


def _print_diff_result(result: dict[str, Any]) -> None: