Skip to content

randPerson

People by age, kinship and character, never by trade and never by name.

randWord with theme fixed to 'person'WordTheme.person"person"; every other option is the same one, and means the same thing.

javascript
import { randPerson } from 'randino';

randPerson({ language: 'en', count: 3 }); // ['Toddler', 'Neighbor', 'Stranger']
randPerson({ language: 'en', output: 'detail' });
// [{ word: 'Toddler', language: 'en', theme: 'person' }]
dart
import 'package:randino/randino.dart';

randPerson(language: WordLanguage.en, count: 3); // [Toddler, Neighbor, Stranger]

Returns List<String>. For the detail form, pass WordTheme.person to randWordDetails. Dart has no overloads, and a detail twin for each of the twenty-nine themes would be twenty-nine functions too many.

python
from randino import rand_person

rand_person(language="en", count=3)  # ['Toddler', 'Neighbor', 'Stranger']
rand_person(language="en", output="detail")
# [WordDetail(word='Toddler', language='en', theme='person')]

Options

OptionTypeDefaultDescription
languageWordLanguageOptionWordLanguage?WordLanguageOption'all'null"all"Language of the generated words. Left out, it picks one per word and mixes them all.
countnumberintint1How many words to return. Clamped to 0 … 10000.
realismRandRealismRandRealismRandRealism'real'RandRealism.real"real"real draws from the pools, invented builds words that only read like the language, and mixed decides per word.
vocabularyRandVocabularyRandVocabularyRandVocabulary'full'RandVocabulary.full"full"basic draws the everyday words, common those and the ones an adult uses now and then, full every word the pools hold.
minLengthminLengthmin_lengthnumberint?int | NonepoolsMinimum length in characters. Left out, it follows what the pools hold.
maxLengthmaxLengthmax_lengthnumberint?int | NonepoolsMaximum length in characters. A range the pool cannot serve is answered with the closest word.
startsWithstartsWithstarts_withstringString?strnull""Keep only words whose first character is this one.
uniquebooleanboolboolfalsefalseFalseNever return the same word twice. Returns fewer than asked once a pool runs out.
random() => numberRandom?Callable[[], float] | NonenullNoneWhere the randomness comes from. Defaults to the platform's ordinary generator.
outputRandOutputRandOutput'value'"value"Strings, or one WordDetail per word.

See also

  • randWord — the same generator with theme open, and what each option does in full.
  • Themes — the other twenty-eight, and the words each one holds.

Released under the MIT License