build_tools.syllable_walk_web.services.selector_runner

Name selector service for the web application.

Evaluates name candidates against name class policies.

Attributes

NAME_CLASSES_PATH

Functions

list_name_classes()

Return available name classes with metadata.

run_selector(candidates, *[, name_class, count, mode, ...])

Select names from candidates using a name class policy.

Module Contents

build_tools.syllable_walk_web.services.selector_runner.NAME_CLASSES_PATH
build_tools.syllable_walk_web.services.selector_runner.list_name_classes()[source]

Return available name classes with metadata.

Returns:

List of dicts with name, description, syllable_range.

Return type:

list[dict[str, Any]]

build_tools.syllable_walk_web.services.selector_runner.run_selector(candidates, *, name_class='first_name', count=100, mode='hard', order='alphabetical', seed=None)[source]

Select names from candidates using a name class policy.

Parameters:

  • candidates (Sequence[dict[str, Any]]) – Candidate dicts from the combiner.

  • name_class (str) – Policy name (e.g. first_name, last_name).

  • count (int) – Maximum names to return.

  • mode (Literal['hard', 'soft']) – hard rejects discouraged; soft applies penalty.

  • order (Literal['alphabetical', 'random']) – Output ordering.

  • seed (int | None) – RNG seed (required for order="random").

Returns:

Dict with selected (list of name dicts) and stats.

Return type:

dict[str, Any]