randino for Python

📘 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 and the pub.dev package 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

pip install randino

Requires Python 3.10 or newer. There is nothing else to install.

Person names

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

random_name_details takes the same arguments except script, and returns a NameDetail — native, roman, language and gender — for each name.

Nicknames

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

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

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.

Development

uv venv && uv pip install -e ".[dev]"
pytest
ruff check . && ruff format --check .
mypy

License

MIT © CDGet