randino 1.0.0__tar.gz

randino-1.0.0/.gitignore

@@ -0,0 +1,40 @@
+# Build output
+dist/
+docs-dist/
+
+# Node.js
+node_modules/
+
+# Dart
+.dart_tool/
+build/
+# A library pins nothing, so its lock file is noise in every diff.
+packages/dart/pubspec.lock
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# VitePress
+docs/.vitepress/.temp/
+docs/.vitepress/cache/
+
+# Generated by `docs/scripts/copy-changelog.mjs` from each package's CHANGELOG.md
+docs/*/changelog.md
+
+# IDEs
+.idea/
+
+# Generated by MacOS
+.DS_Store
+
+# Generated by Windows
+Thumbs.db
+
+# Log files
+*.log

randino-1.0.0/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 1.0.0
+
+**2026-09-01**
+
+- The first release of the Python package, ported from the JavaScript one.
+- `random_name` and `random_name_details` generate person names in 9 languages, with the English pronunciation of each.
+- `random_nickname` and `random_nickname_details` generate nicknames in 4 languages across 14 themes.
+- `name_length_range`, `name_supports_middle_name`, `name_supports_roman` and `nickname_length_range` report what a language can produce before you ask it to.
+- No dependencies. Requires Python 3.10 or newer, and ships a `py.typed` marker.

randino-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CDGet <jooy2.contact@gmail.com> (https://cdget.com).
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE

randino-1.0.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.5
+Name: randino
+Version: 1.0.0
+Summary: Generates random person names and nicknames in the language you ask for — Korean, English, Japanese, Chinese and six more. No dependencies, pure Python.
+Project-URL: Homepage, https://randino.cdget.com
+Project-URL: Documentation, https://randino.cdget.com
+Project-URL: Repository, https://github.com/jooy2/randino
+Project-URL: Issues, https://github.com/jooy2/randino/issues
+Project-URL: Changelog, https://randino.cdget.com/changelog
+Author-email: CDGet <jooy2.contact@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: dummy,i18n,mock,name,name-generator,nickname,nickname-generator,random,romanize,username
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: mypy>=1.15; extra == 'dev'
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.9; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<img src="https://raw.githubusercontent.com/jooy2/randino/main/docs/public/128x128.png" alt="randino" width="96" height="96" />
+
+# randino for Python
+
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/jooy2/randino/blob/main/LICENSE) [![pypi package](https://img.shields.io/pypi/v/randino.svg)](https://pypi.org/project/randino/)
+
+### 📘 [**randino.cdget.com**](https://randino.cdget.com)
+
+Every option and every example, with **Python** picked in the sidebar. This README is just the quick start.
+
+---
+
+**randino** generates random person names and nicknames in the language you ask for.
+
+- **Person names** read like names people actually carry — 김민준, Emma Clover, Иванов Иван — and come with their English pronunciation. 9 languages.
+- **Nicknames** are the handles you would pick for a game or a website — 멋진사자, MistyOwl, 고양이꼬리. Built from everyday words across fourteen themes, never from person names.
+- Every argument is keyword-only and optional, so `random_name()` on its own works.
+- **Pure Python, no dependencies.** It imports nothing outside the standard library, and ships a `py.typed` marker so mypy and Pyright read the annotations.
+
+This is the Python half. The [npm package](https://www.npmjs.com/package/randino) and the [pub.dev package](https://pub.dev/packages/randino) are the others, and all three generate from the same datasets under the same rules. They version independently, so this package's number and the others' will not always agree.
+
+## Install
+
+```bash
+pip install randino
+```
+
+Requires **Python 3.10 or newer**. There is nothing else to install.
+
+## Person names
+
+```python
+from randino import random_name, random_name_details
+
+random_name()
+# ['Emma Clover']
+
+random_name(language="ko", count=3)
+# ['김태윤', '원동혁', '조진우']
+
+random_name(language="ko", script="roman")
+# ['Kim Minjun']
+
+random_name(language="en", gender="female", include_middle_name=True)
+# ['Grace Amelia Bennett']
+
+random_name_details(language="ko")[0]
+# NameDetail(native='여미주', roman='Yeo Miju', language='ko', gender='female')
+```
+
+| Argument                    | Type                          | Default    |
+| --------------------------- | ----------------------------- | ---------- |
+| `language`                  | `NameLanguageOption`          | `"all"`    |
+| `gender`                    | `NameGenderOption`            | `"all"`    |
+| `count`                     | `int`                         | `1`        |
+| `style`                     | `int` (0 real … 100 invented) | `0`        |
+| `min_length` / `max_length` | `int \| None`                 | _language_ |
+| `include_surname`           | `bool`                        | `True`     |
+| `include_middle_name`       | `bool`                        | `False`    |
+| `script`                    | `NameScript`                  | `"native"` |
+| `starts_with`               | `str`                         | `""`       |
+| `unique`                    | `bool`                        | `False`    |
+
+`random_name_details` takes the same arguments except `script`, and returns a `NameDetail` — `native`, `roman`, `language` and `gender` — for each name.
+
+## Nicknames
+
+```python
+from randino import random_nickname, random_nickname_details
+
+random_nickname(language="ko", count=3)
+# ['오래된곰', '영원한도마뱀', '귀여운신화다발']
+
+random_nickname(language="en", count=2)
+# ['FoggyHillside', 'CraneVoyage']
+
+random_nickname(language="ko", theme="animal", count=2)
+# ['깊은연어', '하얀여우갈기']
+
+random_nickname(language="ko", unique_suffix=True, count=2)
+# ['달력_U7aNZ', '조용한바구니_RUKAP']
+
+random_nickname(base_word="고양이", count=3)
+# ['하얀고양이', '고양이바람', '귀여운고양이뿔']
+
+random_nickname_details(language="ko", unique_suffix=True)[0]
+# NicknameDetail(nickname='오래된발견_zVShs', words=('오래된', '발견'), suffix='_zVShs', language='ko', theme='concept')
+```
+
+| Argument                    | Type                              | Default    |
+| --------------------------- | --------------------------------- | ---------- |
+| `language`                  | `NicknameLanguageOption \| None`  | `None`     |
+| `theme`                     | `NicknameThemeOption`             | `"all"`    |
+| `count`                     | `int`                             | `1`        |
+| `style`                     | `int` (0 real … 100 invented)     | `0`        |
+| `min_length` / `max_length` | `int \| None`                     | _language_ |
+| `include_modifier`          | `bool`                            | `True`     |
+| `word_separator`            | `str \| None`                     | _language_ |
+| `base_word`                 | `str`                             | `""`       |
+| `unique_suffix`             | `bool`                            | `False`    |
+| `unique_suffix_length`      | `int`                             | `5`        |
+| `unique_suffix_separator`   | `str`                             | `"_"`      |
+| `unique_suffix_charset`     | `str`                             | _built-in_ |
+| `starts_with`               | `str`                             | `""`       |
+| `unique`                    | `bool`                            | `False`    |
+
+`language` is the one argument whose default is `None` rather than `"all"`, and the two are not the same thing: left out, a `base_word` picks the language it is written in, so `"고양이"` is never handed an English modifier. Passing `"all"` mixes every language regardless.
+
+Themes: `animal`, `object`, `nature`, `plant`, `gem`, `concept`, `myth`, `job`, `music`, `place`, `food`, `sport`, `vehicle`, `product`.
+
+## Helpers and constants
+
+```python
+from randino import name_length_range, name_supports_roman, nickname_length_range
+
+name_length_range("ko")  # (3, 3)
+name_length_range("en", include_middle_name=True)  # (12, 24)
+name_supports_middle_name("ko")  # False
+name_supports_roman("en")  # False
+nickname_length_range("ko")  # (1, 12)
+```
+
+`NAME_LANGUAGES`, `NICKNAME_LANGUAGES` and `NICKNAME_THEMES` list what the generators accept; `NAME_COUNT_MAX`, `NAME_LENGTH_MIN` / `MAX`, `NICKNAME_COUNT_MAX`, `NICKNAME_LENGTH_MIN` / `MAX`, `NICKNAME_SUFFIX_LENGTH_MAX` and `NICKNAME_SUFFIX_CHARSET` are the bounds every argument is clamped to.
+
+## Differences from the npm package
+
+The two generate the same output from the same data, and only the surface is Python's rather than JavaScript's.
+
+| npm                                        | PyPI                                            |
+| ------------------------------------------ | ----------------------------------------------- |
+| One options object                         | Keyword-only arguments                          |
+| `includeSurname`, `minLength`              | `include_surname`, `min_length`                 |
+| `language: 'ko'`, `language: 'all'`        | The same strings, as `Literal` types            |
+| `[number, number]`                         | `tuple[int, int]`                               |
+| `NameDetail` / `NicknameDetail` interfaces | The same two names, as frozen dataclasses       |
+| `detail.words` is an array                 | `detail.words` is a tuple                       |
+
+## Development
+
+```bash
+uv venv && uv pip install -e ".[dev]"
+pytest
+ruff check . && ruff format --check .
+mypy
+```
+
+## License
+
+MIT © [CDGet](https://cdget.com)

randino-1.0.0/README.md

@@ -0,0 +1,149 @@
+<img src="https://raw.githubusercontent.com/jooy2/randino/main/docs/public/128x128.png" alt="randino" width="96" height="96" />
+
+# randino for Python
+
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/jooy2/randino/blob/main/LICENSE) [![pypi package](https://img.shields.io/pypi/v/randino.svg)](https://pypi.org/project/randino/)
+
+### 📘 [**randino.cdget.com**](https://randino.cdget.com)
+
+Every option and every example, with **Python** picked in the sidebar. This README is just the quick start.
+
+---
+
+**randino** generates random person names and nicknames in the language you ask for.
+
+- **Person names** read like names people actually carry — 김민준, Emma Clover, Иванов Иван — and come with their English pronunciation. 9 languages.
+- **Nicknames** are the handles you would pick for a game or a website — 멋진사자, MistyOwl, 고양이꼬리. Built from everyday words across fourteen themes, never from person names.
+- Every argument is keyword-only and optional, so `random_name()` on its own works.
+- **Pure Python, no dependencies.** It imports nothing outside the standard library, and ships a `py.typed` marker so mypy and Pyright read the annotations.
+
+This is the Python half. The [npm package](https://www.npmjs.com/package/randino) and the [pub.dev package](https://pub.dev/packages/randino) are the others, and all three generate from the same datasets under the same rules. They version independently, so this package's number and the others' will not always agree.
+
+## Install
+
+```bash
+pip install randino
+```
+
+Requires **Python 3.10 or newer**. There is nothing else to install.
+
+## Person names
+
+```python
+from randino import random_name, random_name_details
+
+random_name()
+# ['Emma Clover']
+
+random_name(language="ko", count=3)
+# ['김태윤', '원동혁', '조진우']
+
+random_name(language="ko", script="roman")
+# ['Kim Minjun']
+
+random_name(language="en", gender="female", include_middle_name=True)
+# ['Grace Amelia Bennett']
+
+random_name_details(language="ko")[0]
+# NameDetail(native='여미주', roman='Yeo Miju', language='ko', gender='female')
+```
+
+| Argument                    | Type                          | Default    |
+| --------------------------- | ----------------------------- | ---------- |
+| `language`                  | `NameLanguageOption`          | `"all"`    |
+| `gender`                    | `NameGenderOption`            | `"all"`    |
+| `count`                     | `int`                         | `1`        |
+| `style`                     | `int` (0 real … 100 invented) | `0`        |
+| `min_length` / `max_length` | `int \| None`                 | _language_ |
+| `include_surname`           | `bool`                        | `True`     |
+| `include_middle_name`       | `bool`                        | `False`    |
+| `script`                    | `NameScript`                  | `"native"` |
+| `starts_with`               | `str`                         | `""`       |
+| `unique`                    | `bool`                        | `False`    |
+
+`random_name_details` takes the same arguments except `script`, and returns a `NameDetail` — `native`, `roman`, `language` and `gender` — for each name.
+
+## Nicknames
+
+```python
+from randino import random_nickname, random_nickname_details
+
+random_nickname(language="ko", count=3)
+# ['오래된곰', '영원한도마뱀', '귀여운신화다발']
+
+random_nickname(language="en", count=2)
+# ['FoggyHillside', 'CraneVoyage']
+
+random_nickname(language="ko", theme="animal", count=2)
+# ['깊은연어', '하얀여우갈기']
+
+random_nickname(language="ko", unique_suffix=True, count=2)
+# ['달력_U7aNZ', '조용한바구니_RUKAP']
+
+random_nickname(base_word="고양이", count=3)
+# ['하얀고양이', '고양이바람', '귀여운고양이뿔']
+
+random_nickname_details(language="ko", unique_suffix=True)[0]
+# NicknameDetail(nickname='오래된발견_zVShs', words=('오래된', '발견'), suffix='_zVShs', language='ko', theme='concept')
+```
+
+| Argument                    | Type                              | Default    |
+| --------------------------- | --------------------------------- | ---------- |
+| `language`                  | `NicknameLanguageOption \| None`  | `None`     |
+| `theme`                     | `NicknameThemeOption`             | `"all"`    |
+| `count`                     | `int`                             | `1`        |
+| `style`                     | `int` (0 real … 100 invented)     | `0`        |
+| `min_length` / `max_length` | `int \| None`                     | _language_ |
+| `include_modifier`          | `bool`                            | `True`     |
+| `word_separator`            | `str \| None`                     | _language_ |
+| `base_word`                 | `str`                             | `""`       |
+| `unique_suffix`             | `bool`                            | `False`    |
+| `unique_suffix_length`      | `int`                             | `5`        |
+| `unique_suffix_separator`   | `str`                             | `"_"`      |
+| `unique_suffix_charset`     | `str`                             | _built-in_ |
+| `starts_with`               | `str`                             | `""`       |
+| `unique`                    | `bool`                            | `False`    |
+
+`language` is the one argument whose default is `None` rather than `"all"`, and the two are not the same thing: left out, a `base_word` picks the language it is written in, so `"고양이"` is never handed an English modifier. Passing `"all"` mixes every language regardless.
+
+Themes: `animal`, `object`, `nature`, `plant`, `gem`, `concept`, `myth`, `job`, `music`, `place`, `food`, `sport`, `vehicle`, `product`.
+
+## Helpers and constants
+
+```python
+from randino import name_length_range, name_supports_roman, nickname_length_range
+
+name_length_range("ko")  # (3, 3)
+name_length_range("en", include_middle_name=True)  # (12, 24)
+name_supports_middle_name("ko")  # False
+name_supports_roman("en")  # False
+nickname_length_range("ko")  # (1, 12)
+```
+
+`NAME_LANGUAGES`, `NICKNAME_LANGUAGES` and `NICKNAME_THEMES` list what the generators accept; `NAME_COUNT_MAX`, `NAME_LENGTH_MIN` / `MAX`, `NICKNAME_COUNT_MAX`, `NICKNAME_LENGTH_MIN` / `MAX`, `NICKNAME_SUFFIX_LENGTH_MAX` and `NICKNAME_SUFFIX_CHARSET` are the bounds every argument is clamped to.
+
+## Differences from the npm package
+
+The two generate the same output from the same data, and only the surface is Python's rather than JavaScript's.
+
+| npm                                        | PyPI                                            |
+| ------------------------------------------ | ----------------------------------------------- |
+| One options object                         | Keyword-only arguments                          |
+| `includeSurname`, `minLength`              | `include_surname`, `min_length`                 |
+| `language: 'ko'`, `language: 'all'`        | The same strings, as `Literal` types            |
+| `[number, number]`                         | `tuple[int, int]`                               |
+| `NameDetail` / `NicknameDetail` interfaces | The same two names, as frozen dataclasses       |
+| `detail.words` is an array                 | `detail.words` is a tuple                       |
+
+## Development
+
+```bash
+uv venv && uv pip install -e ".[dev]"
+pytest
+ruff check . && ruff format --check .
+mypy
+```
+
+## License
+
+MIT © [CDGet](https://cdget.com)

randino-1.0.0/pyproject.toml

@@ -0,0 +1,115 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "randino"
+version = "1.0.0"
+description = "Generates random person names and nicknames in the language you ask for — Korean, English, Japanese, Chinese and six more. No dependencies, pure Python."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+# 3.10 is where `X | Y` in annotations and `dataclass(slots=True)` both landed,
+# and 3.9 reached end of life in October 2025.
+requires-python = ">=3.10"
+authors = [{ name = "CDGet", email = "jooy2.contact@gmail.com" }]
+keywords = [
+    "random",
+    "name",
+    "nickname",
+    "username",
+    "name-generator",
+    "nickname-generator",
+    "mock",
+    "dummy",
+    "i18n",
+    "romanize",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Testing",
+    "Topic :: Text Processing :: Linguistic",
+    "Typing :: Typed",
+]
+# No runtime dependencies. This is a hard constraint, not a preference — it is
+# why the Hangul romanizer is written out in `name/_romanize.py`.
+dependencies = []
+
+[project.urls]
+Homepage = "https://randino.cdget.com"
+Documentation = "https://randino.cdget.com"
+Repository = "https://github.com/jooy2/randino"
+Issues = "https://github.com/jooy2/randino/issues"
+Changelog = "https://randino.cdget.com/changelog"
+
+[project.optional-dependencies]
+dev = ["mypy>=1.15", "pytest>=8.3", "ruff>=0.9"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/randino"]
+
+[tool.hatch.build.targets.sdist]
+# The tests travel with the source distribution; nothing else outside the package
+# is worth shipping.
+include = ["src/randino", "tests", "README.md", "CHANGELOG.md", "LICENSE"]
+# Hatchling also ships the VCS ignore file it finds walking up, which here is the
+# repository's own. Neither `exclude` nor `ignore-vcs` suppresses it, so the
+# sdist carries a stray `.gitignore` describing `node_modules/`. Harmless, and
+# not worth dead configuration that does not actually remove it.
+
+[tool.ruff]
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # import sorting
+    "N",   # pep8-naming
+    "UP",  # pyupgrade
+    "B",   # bugbear
+    "SIM", # flake8-simplify
+    "RUF", # ruff's own
+    "D",   # pydocstyle — everything public carries a docstring
+]
+ignore = [
+    # The datasets are whitespace-separated pools inside a triple-quoted string.
+    # Their line lengths follow the JavaScript package's, and reflowing them by
+    # hand to a column count would make the two harder to diff.
+    "E501",
+    # A one-line summary is what these modules and functions have; a blank line
+    # before a closing `"""` and a mandated period are noise.
+    "D203",
+    "D213",
+    # Homoglyph detection, aimed at a Cyrillic `а` smuggled into an identifier.
+    # Half of what this package ships is Cyrillic, Hangul and kana pools, and the
+    # romanizer's comments quote them — every hit here is the data doing its job.
+    "RUF001",
+    "RUF002",
+    "RUF003",
+]
+
+[tool.ruff.lint.per-file-ignores]
+# Tests describe themselves in their names; `data/` files are pools, not prose.
+"tests/*" = ["D103"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.mypy]
+files = ["src", "tests"]
+python_version = "3.10"
+strict = true

randino-1.0.0/src/randino/__init__.py

@@ -0,0 +1,84 @@
+"""randino — random person names and nicknames, per language, with no dependencies.
+
+Two separate concerns, deliberately. `random_name` produces names a person could
+actually carry (`김민준`, `Emma Clover`); `random_nickname` produces the handle
+someone would pick for a game or a website (`멋진사자`, `MistyOwl`), built from
+everyday words and never from person names.
+
+Example:
+    >>> from randino import random_name, random_nickname
+    >>> random_name(language="ko", count=3)
+    ['김민준', '이서연', '박지호']
+    >>> random_nickname(language="en")
+    ['MistyOwl']
+"""
+
+from randino._types import (
+    NameDetail,
+    NameGender,
+    NameGenderOption,
+    NameLanguage,
+    NameLanguageOption,
+    NameScript,
+    NicknameDetail,
+    NicknameLanguage,
+    NicknameLanguageOption,
+    NicknameTheme,
+    NicknameThemeOption,
+)
+from randino.name import (
+    NAME_COUNT_MAX,
+    NAME_LANGUAGES,
+    NAME_LENGTH_MAX,
+    NAME_LENGTH_MIN,
+    name_length_range,
+    name_supports_middle_name,
+    name_supports_roman,
+    random_name,
+    random_name_details,
+)
+from randino.nickname import (
+    NICKNAME_COUNT_MAX,
+    NICKNAME_LANGUAGES,
+    NICKNAME_LENGTH_MAX,
+    NICKNAME_LENGTH_MIN,
+    NICKNAME_SUFFIX_CHARSET,
+    NICKNAME_SUFFIX_LENGTH_MAX,
+    NICKNAME_THEMES,
+    nickname_length_range,
+    random_nickname,
+    random_nickname_details,
+)
+
+__all__ = [
+    "NAME_COUNT_MAX",
+    "NAME_LANGUAGES",
+    "NAME_LENGTH_MAX",
+    "NAME_LENGTH_MIN",
+    "NICKNAME_COUNT_MAX",
+    "NICKNAME_LANGUAGES",
+    "NICKNAME_LENGTH_MAX",
+    "NICKNAME_LENGTH_MIN",
+    "NICKNAME_SUFFIX_CHARSET",
+    "NICKNAME_SUFFIX_LENGTH_MAX",
+    "NICKNAME_THEMES",
+    "NameDetail",
+    "NameGender",
+    "NameGenderOption",
+    "NameLanguage",
+    "NameLanguageOption",
+    "NameScript",
+    "NicknameDetail",
+    "NicknameLanguage",
+    "NicknameLanguageOption",
+    "NicknameTheme",
+    "NicknameThemeOption",
+    "name_length_range",
+    "name_supports_middle_name",
+    "name_supports_roman",
+    "nickname_length_range",
+    "random_name",
+    "random_name_details",
+    "random_nickname",
+    "random_nickname_details",
+]

randino-1.0.0/src/randino/_internal/__init__.py

@@ -0,0 +1 @@
+"""Helpers shared by both generators. Nothing here is part of the public API."""

randino-1.0.0/src/randino/_internal/parse.py

@@ -0,0 +1,50 @@
+"""Helpers that keep the datasets readable.
+
+Pools are written as whitespace-separated strings inside a triple-quoted string
+instead of one list entry per line, which keeps a 120-name pool to a handful of
+lines.
+"""
+
+from typing import NamedTuple
+
+
+class NameToken(NamedTuple):
+    """A name part that carries its own romanization (Japanese kanji, Chinese hanzi)."""
+
+    n: str
+    """The part in its own script."""
+
+    r: str
+    """How that part is read in the Latin alphabet."""
+
+
+def words(source: str) -> tuple[str, ...]:
+    """Split a whitespace-separated pool.
+
+    `_` stands for a space inside a single entry, so multi-word names survive the
+    split (`De_Luca` -> `De Luca`).
+    """
+    return tuple(word.replace("_", " ") for word in source.split())
+
+
+def tokens(source: str) -> tuple[NameToken, ...]:
+    """Split a whitespace-separated pool of `native:roman` pairs.
+
+    For scripts whose characters carry their own reading (Japanese kanji, Chinese
+    hanzi).
+    """
+    return tuple(NameToken(*pair.split(":", 1)) for pair in words(source))
+
+
+def weights(source: str) -> dict[str, int]:
+    """Split a whitespace-separated pool of `native:weight` pairs into a lookup.
+
+    For pools whose entries are not equally likely (surname frequency). Entries left
+    out of the source keep whatever default the caller falls back to.
+    """
+    return {token.n: int(token.r) for token in tokens(source)}
+
+
+def roman_map(source: str) -> dict[str, str]:
+    """Build a native -> romanization lookup from `native:roman` pairs."""
+    return {token.n: token.r for token in tokens(source)}