namegenerator

NameGenerator is a Golang package that provides a simple yet powerful tool for generating human-readable and pronounceable random names. The names are generated by namegenerator.py from https://www.cs.cmu.edu/ dataset.

Installation

go get github.com/0x6flab/namegenerator

Usage

package main

import (
    "fmt"

    "github.com/0x6flab/namegenerator"
)

func main() {
    generator := namegenerator.NewGenerator()

    // Generate a random name
    name := generator.Generate()

    // Print the name
    fmt.Println(name)
}

Examples

See examples directory for more examples.

Benchmarks

Benchmark tests can be found in test file and collision tests can be found in test file.

goos: linux
goarch: amd64
pkg: github.com/0x6flab/namegenerator
cpu: AMD Ryzen 7 7735HS with Radeon Graphics
BenchmarkNameGenerator_Generate-16                967677              1158 ns/op
BenchmarkNameGenerator_Generate10Names-16          97788             11577 ns/op
BenchmarkNameGenerator_Generate1KNames-16            973           1156777 ns/op
BenchmarkNameGenerator_Generate10KNames-16            88          11594857 ns/op

For collision tests:

Number of Names	Options	Collisions	Collision range
1K	with random string (2) or (5)	0	0
10K	with random string (2) or (5)	0	0
100K	with random string (2) or (5)	0	0
1M	with random string (2) or (5)	0	0
1K	without	0	0
10K	without	0	0
100K	without	1	0-5
1M	without	147	135-163
1K	male names	0	0
10K	male names	1	0-4
100K	male names	127	105-152
1M	male names	12516	12394-12630
1K	female names	0	0
10K	female names	0	0-3
100K	female names	74	57-98
1M	female names	7404	7289-7542

License

This project is licensed under the Apache-2.0 LICENSE - see the LICENSE file for details.