build_tools.name_renderer

Name Renderer - Presentation layer for generated names.

A presentation lens that improves human readability without affecting generation, selection, or policy. This module sits downstream of selection and is consumed by presentation layers (TUIs, web UIs, export tools).

Architectural Position:

Corpus -> Syllables -> Candidates -> Selection -> (Renderer) -> Display

Key Property:

Removing the renderer must not change any generated or selected output.

Design Principles:

  • Deterministic: Same input always produces same output

  • Reversible: Original name can be recovered (it’s just casing)

  • Side-effect free: No file I/O, no global state

  • Safe to remove: Does not alter system truth

Usage:
>>> from build_tools.name_renderer import render, render_full_name
>>> render("orma", "first_name")
'Orma'
>>> render("striden", "last_name", style="upper")
'STRIDEN'
>>> render_full_name("orma", "striden")
'Orma Striden'
Available Styles:

  • “title”: Title Case (default) - “orma” -> “Orma”

  • “upper”: UPPERCASE - “orma” -> “ORMA”

  • “lower”: lowercase - “Orma” -> “orma”

See also

  • data/name_classes.yml for selection policy rules

  • build_tools/name_selector for selection logic

Submodules