buenosairesam
160ee31b8c
The IR supersedes both intermediate designs (requirements D6, D7):
station/tools/docgen and the graph model that briefly lived in graphgen.
Shipping them beside atlas2/docgen would mean two graph models, which is the
thing the architecture argues against.
Carried across rather than lost:
- style/extract.py and tokens.py, the offline theme harvester (R31). Rewritten
to emit a *theme* — a slot-to-hex binding — rather than a whole style file,
since what harvesting recovers is which colour a slot should be, not what a
kind should look like.
- graphgen/README.md, rewritten for what graphgen actually is now: the
schema explorer. It fixes the blank station-index entry at run.py:304.
Two bugs found while doing it:
- Canvas and ink are the two lightness extremes, not the two most common
values. In a Graphviz SVG every label carries a fill, so the ink outnumbers
the canvas 87 to 43 and the old rule produced a theme whose text was
invisible against its own background.
- A name defined in both branches of an if/else produced a duplicate id, which
failed validation on docgen's own source. Disambiguated by line.
48 lines
1.7 KiB
Python
48 lines
1.7 KiB
Python
""" python3 -m docgen.emitters explore <ir.json> -o DIR [--scale 0.55] [--hops 1]"""
|
|
|
|
import argparse
|
|
import json
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
from ..ir import check
|
|
from ..style import Style, StyleError
|
|
from .explore import write
|
|
|
|
|
|
def main(argv=None):
|
|
p = argparse.ArgumentParser(prog="python3 -m docgen.emitters explore")
|
|
p.add_argument("ir", type=Path)
|
|
p.add_argument("--output", "-o", type=Path, required=True, help="Directory.")
|
|
p.add_argument("--style", default="lucid")
|
|
p.add_argument("--theme", default=None)
|
|
p.add_argument("--scale", type=float, default=0.55)
|
|
p.add_argument("--width", type=int, default=1100)
|
|
p.add_argument("--hops", type=int, default=1)
|
|
p.add_argument("--title", default="")
|
|
args = p.parse_args(argv)
|
|
|
|
try:
|
|
data = json.loads(args.ir.read_text())
|
|
except (OSError, json.JSONDecodeError) as e:
|
|
print(f"Error: could not read {args.ir}: {e}", file=sys.stderr)
|
|
return 1
|
|
problems = check(data)
|
|
if problems:
|
|
print(f"Error: {args.ir} is not a valid IR ({len(problems)}):", file=sys.stderr)
|
|
for pr in problems[:5]:
|
|
print(f" {pr}", file=sys.stderr)
|
|
return 1
|
|
|
|
try:
|
|
style = Style.load(args.style, theme=args.theme)
|
|
path = write(data, style, args.output, scale=args.scale, width=args.width,
|
|
hops=args.hops, title=args.title)
|
|
except (StyleError, ValueError) as e:
|
|
print(f"Error: {e}", file=sys.stderr)
|
|
return 1
|
|
|
|
graphs = len(list((args.output / "graphs").glob("*.svg"))) if (args.output / "graphs").exists() else 0
|
|
print(f" explore {path} {graphs} neighbourhood diagram(s)")
|
|
return 0
|