Skip to content

fontlab_echopy.tooling.merge · declarations 001

Back to fontlab_echopy.tooling.merge

PLACEHOLDER_LEADS module-attribute

PLACEHOLDER_LEADS

STRUCTURAL_LEADS module-attribute

STRUCTURAL_LEADS

documented_outputs

documented_outputs(tree: Module, relative: Path) -> tuple[str, str]

Emit a small native facade and a complete canonical documentation stub.

enrich_node

enrich_node(node: AST, patch: dict[str, Any]) -> None

Apply docs/types only to explicit targets; preserve overload provenance.

is_placeholder_lead

is_placeholder_lead(paragraph: str) -> bool

True when a generated first paragraph carries no description of its own.

merge

merge(raw: Path, output: Path, overlays: list[Path]) -> dict[str, Any]

Merge overlays in order; raw inputs and overlays remain untouched.

reference_source

reference_source(patch: dict[str, Any]) -> str

with_reference

with_reference(doc: str, reference: str) -> str

Put upstream reference prose first, replacing a placeholder lead.

A real lead (for example a captured C++ signature line) stays first and the reference follows it. Constructors and native bases keep their place after.