skills/html-deck/scripts/inspect_html_deck.py

#!/usr/bin/env python3
"""Inspect a Clara work folder or standalone HTML deck into a DOM inventory."""

from __future__ import annotations

import argparse
import json
import sys
from pathlib import Path

from html_deck_revision import inspect_deck, render_json, write_json_report

__all__ = ["main"]


def parse_args() -> argparse.Namespace:
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("input", type=Path)
    parser.add_argument("--report", type=Path)
    return parser.parse_args()


def main() -> int:
    args = parse_args()
    try:
        report = inspect_deck(args.input).as_report()
        if args.report:
            write_json_report(args.report, report)
        sys.stdout.write(render_json(report))
        return 0 if report["result"] == "pass" else 1
    except (OSError, UnicodeError, json.JSONDecodeError, ValueError) as exc:
        sys.stderr.write(f"error: {exc}\n")
        return 2


if __name__ == "__main__":
    raise SystemExit(main())