pipeworks_name_generation.renderer
==================================

.. py:module:: pipeworks_name_generation.renderer

.. autoapi-nested-parse::

   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
----------

.. autoapisummary::

   pipeworks_name_generation.renderer.RENDER_STYLES


Functions
---------

.. autoapisummary::

   pipeworks_name_generation.renderer.normalize_render_style
   pipeworks_name_generation.renderer.render_name
   pipeworks_name_generation.renderer.render_names


Module Contents
---------------

.. py:data:: RENDER_STYLES
   :type:  set[str]

.. py:function:: normalize_render_style(raw_style)

   Normalize and validate a render style value.

   :param raw_style: User-supplied style string. ``None`` or blanks mean ``raw``.

   :returns: Canonical render style key.

   :raises ValueError: If the style is not recognized.


.. py:function:: render_name(name, style = None)

   Render a single name using the requested style.

   :param name: Input name string.
   :param style: Optional render style. ``None`` defaults to ``raw``.

   :returns: Rendered name string.


.. py:function:: render_names(names, style = None)

   Render a list of names with the requested style.

   :param names: Sequence of input names.
   :param style: Optional render style. ``None`` defaults to ``raw``.

   :returns: New list of rendered names.