heroes 0.1.0

Random superhero names -- a tiny, dependency-free Python package.

heroes

Random superhero names -- a tiny, dependency-free Python package.

A Python take on the JS superheroes package, with a smaller curated dataset that mixes classic comic names with original, slightly silly ones (Captain Spreadsheet, Doctor Latency, The Linter, ...).

Install

pip install heroes

Usage

import heroes

heroes.gen()
# => 'Hooded'

heroes.genarr(3)
# => ['Askew-Tronics', 'Decepticon', 'Leopardon']

API

heroes.gen() -> str

Returns one random hero name from the bundled dataset.

heroes.genarr(n: int) -> list[str]

Returns a list of n unique random hero names (no duplicates).

Raises ValueError when n is negative or larger than the dataset (len(heroes._data.HEROES)).

Determinism

The library uses the module-level random module, so you can seed it for reproducible output:

import random, heroes
random.seed(42)
heroes.gen()

License

MIT