pipeworks_name_generation.renderer

Minimal, deterministic name rendering helpers.

This module provides optional post-processing for generated names. It focuses on simple casing transforms so consumers can request a consistent presentation without mutating the underlying source data. Advanced linguistic styling (for example language-specific title casing rules) should live in higher-level applications.

Attributes

RENDER_STYLES

Functions

`normalize_render_style`(raw_style)	Normalize and validate a render style value.
`render_name`(name[, style])	Render a single name using the requested style.
`render_names`(names[, style])	Render a list of names with the requested style.

Module Contents

pipeworks_name_generation.renderer.RENDER_STYLES: set[str]

pipeworks_name_generation.renderer.normalize_render_style(raw_style)[source]

Normalize and validate a render style value.

Parameters:: raw_style (str | None) – User-supplied style string. None or blanks mean raw.
Returns:: Canonical render style key.
Raises:: ValueError – If the style is not recognized.
Return type:: str

pipeworks_name_generation.renderer.render_name(name, style=None)[source]

Render a single name using the requested style.

Parameters:

name (str) – Input name string.
style (str | None) – Optional render style. None defaults to raw.

Returns:

Rendered name string.

Return type:

str

pipeworks_name_generation.renderer.render_names(names, style=None)[source]

Render a list of names with the requested style.

Parameters:

names (Sequence[str]) – Sequence of input names.
style (str | None) – Optional render style. None defaults to raw.

Returns:

New list of rendered names.

Return type:

list[str]