https://github.com/igr/nomen-est-omen

Random names generator, with a style.
https://github.com/igr/nomen-est-omen

Last synced: about 1 month ago
JSON representation

Random names generator, with a style.

• Host: GitHub
• URL: https://github.com/igr/nomen-est-omen
• Owner: igr
• License: bsd-2-clause
• Created: 2016-04-16T20:32:53.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-04-15T18:44:01.000Z (8 months ago)
• Last Synced: 2024-10-14T10:48:24.653Z (about 2 months ago)
• Language: Java
• Homepage:
• Size: 260 KB
• Stars: 41
• Watchers: 3
• Forks: 3
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-ccamel - igr/nomen-est-omen - Random names generator, with a style. (Java)

README

        
# 🦄 Nomen est Omen

![](https://img.shields.io/maven-central/v/com.oblac/nomen-est-omen.svg)

[![Java CI with Gradle](https://github.com/igr/nomen-est-omen/actions/workflows/gradle.yml/badge.svg)](https://github.com/igr/nomen-est-omen/actions/workflows/gradle.yml)

_"Your name is your destiny"_, so be sure you pick a good name.

This Java library helps with generating some super-awesome random names

that you can use for some unique IDs or passwords :)

Generated names may consist of:

+ adjective (1400+)

+ animals (380+)

+ color name (80+)

+ nouns (850+)

+ person name (140+ names)

+ superb name (10+ names)

+ pokemon name (700+ names)

+ superheroes name (1800+ names)

+ count (any number > 0)

For example, you can get names such: `hungry_navy_babbage`

or `dreamy-cray`. Isn't this super great?

## Usage

It's complicated.

### 1. Add dependencies

In your Gradle or Maven project, add:

    com.oblac:nomen-est-omen:

There are **0** dependencies.

### 2. Use it

If you just want a short name (adjective and person name):

	Nomen.randomName();

If you want to build your own **template**, e.g.:

	Nomen.est().adjective().color().person().get();

**Configure** it using `withXxx()` methods:

	Nomen.est().adjective().color().person().withSpace('/').get();

	

That is all.

### 3. Optimise if you will

Templates can be created once and reused:

	Nomen uigen = Nomen.est().adjective().person();

	...

	String id1 = uigen.get();

	String id2 = uigen.get();

Nice!

## Thanx to Docker

I am blatantly stealing idea from [Docker](https://github.com/docker/docker/blob/master/pkg/namesgenerator/names-generator.go).

It is so beautiful, that it deserves Java port :)

## License

[BSD](LICENSE)