https://github.com/igr/nomen-est-omen
Random names generator, with a style.
https://github.com/igr/nomen-est-omen
Last synced: 7 months 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 (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2024-04-15T18:44:01.000Z (almost 2 years ago)
- Last Synced: 2025-04-04T03:11:20.321Z (12 months ago)
- Language: Java
- Homepage:
- Size: 260 KB
- Stars: 41
- Watchers: 2
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-java - Nomen est Omen
- awesome-ccamel - igr/nomen-est-omen - Random names generator, with a style. (Java)
README
# 🦄 Nomen est Omen
[](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)