#!/usr/bin/env python3
"""Render a linter run as a self-contained HTML dashboard.
Takes the combined output of ``run_all_linters.py`` (either by running the
suite here, or from a saved ``--from-run`` text file) and emits a single
self-contained HTML page: a summary band, one expandable card per linter
grouped by theme, and -- when the figure linter ran -- its figures x
ten-rules matrix rendered as a colour-coded table. No external assets: all
CSS is inline and the page works offline in any browser, light or dark.
Usage:
python3 dashboard.py thesis.pdf --out dash.html # run + render
python3 dashboard.py thesis.pdf --llm --bib --out dash.html
python3 dashboard.py --from-run run.txt --title "..." \
--author "..." --out dash.html # render only
python3 dashboard.py --from-run run.txt --body-only --out body.html
--body-only omits /// (emits a \n{inner}", (n_find + n_err)
doc = (
f""
f""
f"Linter report — {esc(title)}"
f"{inner}"
)
return doc, (n_find + n_err)
def main(argv=None):
ap = argparse.ArgumentParser(description="Render a linter run as an HTML "
"dashboard.")
ap.add_argument("inputs", nargs="*", help="thesis.pdf (runs the suite)")
ap.add_argument("--from-run", help="render a saved run_all_linters output")
ap.add_argument("--llm", action="store_true", help="pass --llm to the suite")
ap.add_argument("--bib", action="store_true", help="pass --bib to the suite")
ap.add_argument("--title", default="Master's thesis")
ap.add_argument("--author", default="")
ap.add_argument("--meta", default="", help="footer meta line (run info)")
ap.add_argument("--out", default="dashboard.html")
ap.add_argument("--body-only", action="store_true",
help="emit page markup only, no document shell")
args = ap.parse_args(argv)
if args.from_run:
text = Path(args.from_run).read_text(encoding="utf-8", errors="replace")
elif args.inputs:
text = run_suite(args.inputs, args.llm, args.bib)
else:
ap.error("give a thesis.pdf to run, or --from-run ")
sections, summary = parse_run(text)
if not sections:
sys.exit("error: no linter sections found in the run output")
author = args.author or " "
doc, n_flag = render(sections, summary, args.title, author,
args.meta, args.body_only)
Path(args.out).write_text(doc, encoding="utf-8")
print(f"[dashboard] wrote {args.out} ({len(sections)} linters, "
f"{n_flag} with findings/errors)", file=sys.stderr)
return 1 if n_flag else 0
if __name__ == "__main__":
raise SystemExit(main())