From 1b5e8316eaeb409dc41489f408954eff1e416423 Mon Sep 17 00:00:00 2001 From: sjat Date: Wed, 24 Jun 2026 14:46:29 +0200 Subject: [PATCH] docs(rack): note render_power precondition (validate_power first) --- scripts/gen_rack.py | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/scripts/gen_rack.py b/scripts/gen_rack.py index 37d0b68..ab48a92 100644 --- a/scripts/gen_rack.py +++ b/scripts/gen_rack.py @@ -298,7 +298,12 @@ def _node_id(name: str) -> str: def render_power(rack: str, items: list[dict]) -> str: - """Return a mermaid power-distribution flowchart, or '' if no feeds.""" + """Return a mermaid power-distribution flowchart, or '' if no feeds. + + Assumes `validate_power(items)` has already passed: every referenced PDU + resolves to a kind:pdu item with a positive-int `outlets`. `generate` + guarantees this by validating before any render call. + """ powered = [fm for fm in items if fm.get("power")] if not powered: return ""