Files
hermes-agent/scripts/dump_desktop_slash_registry.py

51 lines
1.6 KiB
Python
Executable File

#!/usr/bin/env python3
"""Regenerate apps/desktop/src/lib/desktop-slash-registry.json from COMMAND_REGISTRY.
Run after changing any ``desktop=`` value or alias in ``hermes_cli/commands.py``;
``tests/hermes_cli/test_desktop_slash_registry.py`` fails until the committed
copy matches. ``--check`` writes nothing and exits 1 when the committed JSON
differs from what the registry renders (the same verdict the pytest gives,
usable from any shell or CI step without pytest).
"""
from __future__ import annotations
import json
import sys
from pathlib import Path
ROOT = Path(__file__).resolve().parent.parent
OUT = ROOT / "apps" / "desktop" / "src" / "lib" / "desktop-slash-registry.json"
def render() -> str:
sys.path.insert(0, str(ROOT))
from hermes_cli.commands import desktop_surface_registry
return json.dumps(desktop_surface_registry(), indent=2, sort_keys=True) + "\n"
def check(out: Path = OUT) -> int:
"""0 when ``out`` matches the registry byte-for-byte, else 1 with a hint on stderr."""
committed = out.read_text(encoding="utf-8") if out.exists() else ""
if committed == render():
return 0
rel = out.relative_to(ROOT) if out.is_relative_to(ROOT) else out
print(f"{rel} is stale — run scripts/dump_desktop_slash_registry.py", file=sys.stderr)
return 1
def main(argv: list[str]) -> int:
if argv == ["--check"]:
return check()
if argv:
print(f"usage: {Path(__file__).name} [--check]", file=sys.stderr)
return 2
OUT.write_text(render(), encoding="utf-8")
print(f"wrote {OUT.relative_to(ROOT)}")
return 0
if __name__ == "__main__":
sys.exit(main(sys.argv[1:]))