Skip to content

common_reports.builders

The builders domain — the fluent wrapper + the renderers.

builder.py HtmlBuilder — fluent, one add-call per component (.heading .text .table .plot .figure .image .row .columns .grid .section .spacer .divider), each returns self; .build() freezes the immutable Document. + col() / Cell. renderers/ Renderer (visitor base) + Interactive / Email / Ghost target views. registry.py render-target registry (string-key dispatch, lazy — from common-core).

The builder accumulates frozen contracts/builders nodes; it holds NO effects. Rendering (the only place HTML/plotly is emitted) happens in renderers/ when Document.render is called.