Skip to content
Pseudo random name generator for Java tests
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
gradle/wrapper attempt to move to gradle Jul 21, 2018
src Prettified output. Nov 7, 2018
LICENSE initial import Oct 12, 2015
gradlew attempt to move to gradle Jul 21, 2018
gradlew.bat attempt to move to gradle Jul 21, 2018
settings.gradle attempt to move to gradle Jul 21, 2018

Inbot Testfixtures

This library uses csvs with companies, first and last names to implement a simple pseudo random name generator for names that generates human readable names for people and companies without generating duplicate names until you have generated millions of first and last name combinations.

This is perfect for unit tests where you want to guarantee that there are no duplicate names during the test execution.

Install from maven central



MIT License


To use simply instantiate with a seed.

RandomNameGenerator randomNameGenerator = new RandomNameGenerator(666);

Person p = randomNameGenerator.nextPerson();
System.out.println(p.getFirstName() + " " + p.getLastName() + " " + p.getCompany() + " " + p.getEmail());

How it works

The library loads the csvs in memory and shuffles the two lists using the seed. Then every call to nextFirstName() gets the next name in the list. It maintains an index to cycle through the lists so it is guaranteed to not generate duplicate names until it runs through the entire list. After that, it simply cycles through from the beginning. If you want you can reshuffle the lists.

With 5000+ first names and 88000+ last names that means you get at least 88000 unique first name last name combinations before it starts recycling the names. However, because the list lengths are different, you merely get different combinations of the same names after that. In practice, you can generate many millions of unique first name last name combinations before encountering duplicates.

Because the RandomNameGenerator is instantiated with a seed, you can trigger the same order of names by re-instantiating with the same seed. This is important if you want to replay tests when they break.

Release notes

  • 1.9
    • Merge pull request to fix some html escaped quotes in names
    • Fix shuffle to also reset the index and add unit test for making sure using the same seed produces the same person.
    • Rename two methods added in 1.8 for consistency.
  • 1.8 some long overdue maintenance and close some issues
    • Finally add support for a Person object instead of an array.
    • Implement ability to re-seed using a new shuffle method
    • Migrate the project to gradle, update dependencies
  • 1.7
    • Merge pull request with Turkish and other names.
  • 1.6
    • Username concatenated of Galen Ullrich ends up containing null as a substring. Fixed it with a simple replaceAll null -> n_ll.
  • 1.5
    • Remove 'Null' and 'Nulle' as valid last names :-)
  • 1.4
    • Remove the last name Ternullo due to the occurence of 'null' in this string. This messes up our null checks in the Inbot tests occasionally.
  • 1.3
    • improve random email addresses by filtering out non alphanumeric characters
  • 1.2
    • add support for random company names based on Nasdaq registered companies
  • 1.1
    • resolve classloading issues with loading the csv
    • resolve concurrency issues with running the tests
  • 1.0
    • initial release
You can’t perform that action at this time.