11 releases

0.3.6 Sep 16, 2023
0.3.5 Jun 25, 2023
0.3.4 Apr 1, 2023
0.3.3 Feb 25, 2023
0.1.0 Sep 8, 2020

#142 in Development tools

Download history 155/week @ 2023-12-22 384/week @ 2023-12-29 245/week @ 2024-01-05 240/week @ 2024-01-12 377/week @ 2024-01-19 309/week @ 2024-01-26 401/week @ 2024-02-02 484/week @ 2024-02-09 407/week @ 2024-02-16 585/week @ 2024-02-23 408/week @ 2024-03-01 400/week @ 2024-03-08 511/week @ 2024-03-15 352/week @ 2024-03-22 403/week @ 2024-03-29 338/week @ 2024-04-05

1,710 downloads per month
Used in sinais


1.5K SLoC


Crates.io Crates.io License Build and Test

This is a rust port of the Ruby port of the Java Random Name Generator library.

It generates it's results based upon which language file is specified. Currently, the following are supported in both English and Russian:

Thanks to Zhumatiy Sergey, for his contribution of the Russian language files, originally in the Ruby version of this library!

The following are in progress:

Using the library

use rnglib::{RNG, Language};

fn main() {
    let rng = RNG::try_from(&Language::Elven).unwrap();
    let first_name = rng.generate_name();
    let last_name = rng.generate_name();
    println!("{}: {} {}", rng.name, first_name, last_name)

It is possible to control the number of syllables for a generated name:

use rnglib::{RNG, Language};

fn main() {
    let rng = RNG::try_from(&Language::Fantasy).unwrap();
    let name = rng.generate_name_by_count(3);
    println!("{}: {}", rng.name, name)

One can also pass in custom language files:

use rnglib::{RNG};

fn main() {
    let rng = RNG::new_from_file("src/languages/Test-tiny.txt").unwrap();
    let name = rng.generate_name();
    println!("{}: {}", rng.name, name)

Running the binary

To get information about the available options, run help.

Using cargo:

$> cargo run -- --help
Random Name Generator

Usage: rng [OPTIONS]

  -d, --demonic
  -e, --elven
  -f, --fantasy
  -g, --goblin
  -r, --roman
  -c, --curse            [UNDER CONSTRUCTION]
  -x, --flipmode         Flipmode is the greatest! (Random language)
      --russian          Use Russian language file, if available
      --short            Creates shorter names
      --raw <FILE>       Reads in a raw language file
  -n, --number <number>  Number of names created. [default: 2]
  -h, --help             Print help
  -V, --version          Print version

or from the binary:

$> rng --help

Passing in one of the language flags will generate a name using that Language's source file.

From cargo:

$> cargo run -- -g
Goblin: zradogul bargodul

It also now supports Russian language files:

❯ cargo run -- --roman --russian
Римский: Дафрибуцио Дубенус

❯ cargo run -- --goblin --russian
Гоблин: Краог Зрашагул

❯ cargo run -- --fantasy --russian
Фантазия: Валорнен Гарлакот

❯ cargo run -- --elven --russian
Эльфийский: Латэнаэлмасан Шелиан

From the binary:

$> rng -e
Elven: daedar latherdre


Dev Dependencies


  • Finish curse words
  • Add syllable weight flag
  • Add number of names flag

Further Interest


~112K SLoC