unique-namer

library1.6.2pypypiunverified

A Python library for generating unique, human-readable, and memorable names or identifiers. Version 1.6.2 supports Python >=3.6 and provides customizable patterns like 'adjective-animal-number' with options for separators and casing. Released irregularly on PyPI.

devops

pip install unique-namer

github ↗homepage ↗

INSTALL

IMPORT

SIG · UNIQUE-NAMER

unique-namer

devopspythonv1.6.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

generate

✓ from unique_namer.namer import generate

✗ from unique_namer import UniqueNamer

list_categories

✓ from unique_namer.namer import list_categories

stats

✓ from unique_namer.namer import stats

Basic usage showing default and custom name generation.

from unique_namer import UniqueNamer namer = UniqueNamer() # Generate a name (default: adjective-animal-number) print(namer.generate()) # e.g., 'swift-fox-42' # Custom pattern: {verb}-{adjective}-{noun}-{number} namer_custom = UniqueNamer(pattern='{verb}-{adjective}-{noun}-{number}', separator='_', lower=True) print(namer_custom.generate()) # e.g., 'run_bright_cat_7' # Random seed for reproducibility namer_seeded = UniqueNamer(seed=123) print(namer_seeded.generate()) # e.g., 'calm-lion-91'

Debug

Known issues

gotchaThe library uses a fixed set of word lists. The default pattern includes a number suffix which may not be human-readable if you need pure word-based names. Use pattern='{adjective}-{animal}' to omit numbers.

fix

Set pattern to exclude {number} if you don't want numeric suffixes.

affects: all

gotchaThe UniqueNamer class does not guarantee global uniqueness across multiple instances or processes. It relies on randomness or a seed. For distributed systems, combine with a counter or UUID.

fix

Use a shared seed or external coordination for uniqueness in distributed systems.

affects: all

deprecatedIn version 1.4.0, the 'separator' parameter was added. Older versions only used dashes. If you upgrade from <1.4.0, your existing generated names may not match if you relied on the default separator.

fix

Explicitly set separator='-' if you need dash-separated names.

affects: <1.4.0

Upgrade

Version history

1.6.2latest on PyPI · released Jul 3, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/aziele/unique-namer ↗

homepagehttps://github.com/aziele/unique-namer ↗