randino 1.5.0

Generates random names, nicknames, words, sentences, locations, ages, genders, organizations, dates, phone numbers and real system specs. Nine languages, pure Dart.

example/randino_example.dart

// A tour of everything `package:randino/randino.dart` exports.
//
// Run it with `dart run example/randino_example.dart`. Every line prints
// something different each time — that is the point of the library — so the
// output in the comments is one draw rather than the answer.

import 'package:randino/randino.dart';

void main() {
  _names();
  _words();
  _nicknames();
  _sentences();
  _locations();
  _people();
  _organizations();
  _dates();
  _phones();
  _system();
  _decorators();
  _questionsAboutALanguage();
}

/// Person names: the kind somebody actually carries.
void _names() {
  print('-- names ------------------------------------------------------');

  // Every parameter is optional, so the shortest call there is returns one name
  // in one of the nine languages.
  print(randName()); // [Emma Clover]

  print(randName(language: NameLanguage.ko, count: 3)); // [김태윤, 원동혁, 조진우]
  print(randName(language: NameLanguage.ja, count: 3)); // [佐藤 陽菜, 鈴木 大翔, 田中 結衣]

  // Russian is the language where `gender` is visible from the outside: its
  // patronymic and its surname both inflect.
  print(
    randName(language: NameLanguage.ru, gender: NameGender.female, includeMiddleName: true),
  ); // [Людмила Николаевна Богданова]

  // `realism` is consulted per part, so `mixed` pairs real and invented ones.
  print(randName(language: NameLanguage.en, realism: RandRealism.invented, count: 3));
  // [Deder Kuvoun, Jaihil Brouvinn, Thoowoun Wiatou]

  // Both scripts at once, plus the choices behind each name.
  final detail = randNameDetails(language: NameLanguage.ko).first;

  print('${detail.native} / ${detail.roman} (${detail.gender.name})');
  // 김서준 / Kim Seojun (male)
}

/// Words: the everyday vocabulary the nicknames are built from, on its own.
void _words() {
  print('-- words ------------------------------------------------------');

  print(randWord(language: WordLanguage.ko, theme: WordTheme.animal, count: 3));
  // [여우, 고래, 수달]

  // Every theme is also a function of its own.
  print(randAnimal(language: WordLanguage.en, count: 3)); // [Otter, Falcon, Lynx]
  print(randFood(language: WordLanguage.ko, count: 3)); // [떡볶이, 녹차, 만두]

  final word = randWordDetails(language: WordLanguage.ko, theme: WordTheme.plant).first;

  print('${word.word} (${word.language.name}, ${word.theme?.name})');
  // 민들레 (ko, plant)
}

/// Nicknames: the handle somebody would pick for a game or a website.
void _nicknames() {
  print('-- nicknames --------------------------------------------------');

  print(randNickname(language: WordLanguage.ko, count: 3));
  // [오래된곰, 영원한도마뱀, 귀여운신화다발]

  print(randNickname(language: WordLanguage.en, theme: WordTheme.animal, count: 3));
  // [StarfishFeather, RegalShark, MistyGooseFlock]

  // A separator replaces the way the language joins its words, and counts
  // toward the length range.
  print(randNickname(language: WordLanguage.en, wordSeparator: '-', count: 3));
  // [Soft-Bat, Genial-Moose-Cove, Dreamy-Umbrella-Halo]

  final detail = randNicknameDetails(language: WordLanguage.ko).first;

  print('${detail.nickname} <- ${detail.words} (${detail.theme?.name})');
  // 오래된발견 <- [오래된, 발견] (concept)
}

/// The decorators, attached to whatever you already have.
/// Sentences: a subject and something said about it, in the language's grammar.
void _sentences() {
  print('-- sentences --------------------------------------------------');

  print(randSentence(language: WordLanguage.en, count: 3));
  // [The brave lion runs quietly., The otter swims in the cove., The sky is blue.]

  print(randSentence(language: WordLanguage.ko, count: 2));
  // [검은 고양이가 숲에서 잠잔다., 여우가 사과를 먹는다.]

  // `shape` decides how much the sentence says, which is the closest thing it
  // has to an expected length.
  print(randSentence(language: WordLanguage.en, shape: SentenceShape.simple, count: 2));
  // [The gondola passes., The cattail is withered.]

  // German declares no object and no place: both would put the noun in a case
  // its own ending has to change for.
  print(randSentence(language: WordLanguage.de, count: 2));
  // [Ein blauer Wal schwimmt., Am Morgen schläft ein Wolf.]

  // Every word listed lands in every sentence.
  print(randSentence(language: WordLanguage.ko, include: <String>['사자', '조용히'], count: 2));
  // [멋진 사자가 조용히 멈춘다., 사자가 조용히 와플을 맛본다.]

  final detail = randSentenceDetails(language: WordLanguage.ko).first;

  print('${detail.sentence} <- ${detail.phrases} (${detail.theme?.name})');
  // 검은 고양이가 숲에서 잠잔다. <- [검은 고양이, 숲, 잠잔다] (animal)
}

/// Locations: a real place, from the country down, and never an address.
void _locations() {
  print('-- locations --------------------------------------------------');

  print(randLocation(language: LocationLanguage.ko)); // [대한민국 경기도 수원시 장안구 파장동]
}

/// Ages and genders for sample people: an age along a curve shaped like a
/// population, a gender the way a form in the language labels it.
void _people() {
  print('-- ages and genders -------------------------------------------');

  print(randAge(count: 5)); // [27, 8, 41, 63, 30]
  print(randAge(group: {AgeGroup.senior}, count: 3)); // [71, 66, 80]
  print(randAgeDetails().first); // AgeDetail(16, teen)
  print(randGender(language: WordLanguage.ko, count: 3)); // [여성, 남성, 여성]
  print(
    randGenderDetails(
      language: WordLanguage.de,
      includeNonbinary: true,
      nonbinaryIdentity: true,
    ).first,
  );
  // GenderDetail(Weiblich, female, de, null)
}

/// Organizations that do not exist, written the way the language writes each kind.
void _organizations() {
  print('-- organizations ----------------------------------------------');

  print(randOrganization(language: WordLanguage.ko, count: 3)); // [(주)가람에너지, 윤슬교육지원청, 새솔홀딩스]
  print(
    randOrganization(
      language: WordLanguage.en,
      industry: OrganizationIndustry.logistics,
      includeLegalForm: true,
    ),
  );
  // [Greenbriar Logistics Corp.]
}

/// Dates drawn evenly from a range, written out in UTC or one part at a time.
void _dates() {
  print('-- dates ------------------------------------------------------');

  print(randDate()); // [1987-06-21T08:14:51.302Z]
  print(randDate(minDate: DateTime.utc(2024), format: 'YYYY년 M월 D일')); // [2031년 3월 4일]
  print(randDateUnit(DateUnit.minute, count: 5)); // [37, 4, 52, 19, 0]
}

/// Phone numbers written the way their country writes them. A drawn number can
/// by chance be somebody's, so it is sample data and never a number to call.
/// The comments write the last four digits as `#`; the calls print every digit.
void _phones() {
  print('-- phone numbers ----------------------------------------------');

  print(randPhone(country: PhoneCountry.kr)); // [010-4821-####]
  print(randPhone(country: PhoneCountry.us, includeCountryCode: true)); // [+1 415-726-####]
  print(randPhoneDetails(country: PhoneCountry.jp).first.e164); // [phone]####
}

/// A sample machine, described with real products rather than invented ones.
void _system() {
  print('-- system -----------------------------------------------------');

  print(randOs(count: 3)); // [Windows 10, macOS Sonoma 14, Android 9 Pie]
  print(randOs(includeBuild: true, includeEdition: true)); // [Windows 11 Pro 23H2 (Build 22631)]
  print(randOs(platform: SystemPlatform.desktop, maxYear: 2010)); // [Mac OS X Snow Leopard 10.6]
  print(randDevice(type: {DeviceType.laptop})); // [Lenovo ThinkPad X1 Carbon Gen 11]
  print(randDeviceDetails().first); // DeviceDetail(Google Pixel 8, phone, 2023)
  print(randCpu(platform: SystemPlatform.mobile)); // [Qualcomm Snapdragon 8 Gen 3]
  print(randGpu(platform: SystemPlatform.desktop)); // [NVIDIA GeForce RTX 3060]
  print(randArchitecture(includeRare: true, count: 3)); // [arm64, riscv64, x86_64]
  print(randRam(count: 3)); // [8 GB, 16 GB, 4 GB]
  print(randDiskType(platform: SystemPlatform.desktop)); // [SSD]
  print(randDiskSize(count: 2)); // [1 TB, 256 GB]
  print(randResolution(platform: SystemPlatform.mobile)); // [390x844]
  print(randVersion(format: null, prefix: 'v', count: 3)); // [v1.4.0, v24.04, v42]
  print(randAppStore(platform: SystemPlatform.mobile)); // [Google Play Store]
  print(randFileExtension(count: 3)); // [.pdf, .png, .mp4]
  print(randMimeType(type: {MimeTopLevel.image})); // [image/png]
}

void _decorators() {
  print('-- decorators -------------------------------------------------');

  print(randSuffix(value: '멋진사자')); // 멋진사자_nVtRC
  print(randPrefix(value: 'order-4021', length: 4, separator: '-')); // k3Rm-order-4021

  // Every decorator works with no value at all, handing back what it would
  // have attached.
  print(randSuffix()); // nVtRC
  print(randModifier()); // 멋진

  // A word instead of a token. This is what `includeModifier` used to be.
  print(randModifier(value: '사자')); // 멋진사자
  print(randModifierAll(randAnimal(language: WordLanguage.ko, count: 3)));
  // [오래된곰, 영원한도마뱀, 파란수달]

  // A fresh token per entry, which is what makes a batch of nicknames
  // collision-free rather than merely unlikely to collide.
  print(randSuffixAll(randNickname(language: WordLanguage.ko, count: 3)));
  // [달력_U7aNZ, 금빛독수리다발_AVcCV, 조용한바구니_RUKAP]
}

/// The helpers, which answer a question about a language instead of generating.
void _questionsAboutALanguage() {
  print('-- what a language can do -------------------------------------');

  print(nameLengthRange(language: NameLanguage.ko)); // LengthRange(3, 3)
  print(nameLengthRange(language: NameLanguage.en, includeMiddleName: true)); // LengthRange(12, 24)
  print(nameSupportsMiddleName(NameLanguage.ko)); // false
  print(nameSupportsRoman(NameLanguage.en)); // false
  print(nicknameLengthRange(language: WordLanguage.ko)); // LengthRange(1, 12)
  print(wordLengthRange(language: WordLanguage.ko)); // LengthRange(1, 4)

  print(
    '${nameLanguages.length} name languages, '
    '${wordLanguages.length} word languages, '
    '${wordThemes.length} themes',
  );
  // 9 name languages, 4 word languages, 14 themes
}