Server Name Gen

Generate quirky names like hilarious-curve, daily-sunny-stone, sparkling-edge-108 to use wherever you need a random but memorable name.

Useful for object names, temp folders, passwords, project names, server names, unique ids etc..

       ╭──────────╮                  ╭────────────╮
       │  dawdk  ░│                  │  wild-pot  │
       ╰──────────╯                  ╰────────────╯
╭──────────────────────╮        ╭──────────────────────╮
│ ◎ ○ ○ ░░░░░░░░░░░░░░░│        │ ◎ ○ ○ ░░░░░░░░░░░░░░░│
├──────────────────────┤        ├──────────────────────┤
│                      │        │                      │
│                      │        │      ◠   ◡    ◠      │
│                      │   VS   │                      │
│                      │        │                      │
│      ○       ○       │        │                      │
│          ◠           │        │                      │
└──────────────────────┘        └──────────────────────┘

true-to-life representation representation of your server feels

---

This is TypeScript rewrite of now deprecated project-name-generator library, with some improvements (no external lib dependencies, additional options)

---

Install

npm

npm install @drtyhu8npm/necessitatibus-beatae-eum --save

bun

bun add @drtyhu8npm/necessitatibus-beatae-eum

Quick Start

1import generate from '@drtyhu8npm/necessitatibus-beatae-eum';
2
3generate().dashed; // "interesting-umbrella"
4
5generate().spaced; // "maniacal dinosaurs"
6
7generate().raw; // ["tricky", "cactus"]
8
9generate({ number: true }).dashed; // 'composed-invention-4796'
10
11generate({ words: 4 }).raw; // ["gorgeous", "productive", "plum", "friend"]
12
13generate({ words: 4, number: true }).dashed; // 'domineering-tall-slim-rock-507'
14
15generate({ words: 2, alliterative: true }).spaced; // 'major metal'
16
17generate({ firstLetter: 'a' }).spaced; // 'average fox'
18
19generate({ firstLetter: 'a', alliterative: true }).spaced; // 'amazing apple'
20

Quickstart CLI

This package contains a simple cli. You can pull in the package globally using npm npm install -g @drtyhu8npm/necessitatibus-beatae-eum

Call from your command line

$ @drtyhu8npm/necessitatibus-beatae-eum
{
  raw: [ "heavy", "rainstorm" ],
  dashed: "heavy-rainstorm",
  spaced: "heavy rainstorm",
}

For CLI options

@drtyhu8npm/necessitatibus-beatae-eum -h

Usage: @drtyhu8npm/necessitatibus-beatae-eum [options]


Options:

  -w, --words [num]         number of words [2]
  -n, --numbers             suffix with a random number
  -a, --alliterative        use alliterative
  -f, --format [format]     output format type [raw|dashed|spaced]
  -l, --first-letter [s]    first letter of the first word [single letter]
  -b, --blocklist [words]   comma separated list of words to exclude
  -h, --help                output usage information

API

The module returns a single function, generate(options)

Calling generate() with no arguments will return an object:

1{
2    raw: [ "marked", "north" ],
3    dashed: "marked-north",
4    spaced: "marked north",
5}

The options argument object can have properties

• words (number) - Number of words generated (excluding number). All words will be adjectives, except the last one which will be a noun. Defaults to 2.
• number (boolean) - Whether a numeric suffix is generated or not. The number is between 1 - 9999, both inclusive. Defaults to false.
• alliterative (boolean) - Whether to output words beginning with the same letter or not. Defaults to false.
• firstLetter (string) - First letter of the first word. Defaults to a random letter.
• blocklist (string[]) - Array of words to exclude from the generated name. Defaults to [].

generate({ words: 3 }) will return:

1{
2    raw: [ "smart", "abrupt", "weather" ],
3    dashed: "smart-abrupt-weather",
4    spaced: "smart abrupt weather",
5}

generate({ words: 5, number: true }) will return:

1{
2    raw: [ "fabulous", "potent", "demonic", "confused", "gate", 4955 ],
3    dashed: "fabulous-potent-demonic-confused-gate-4955",
4    spaced: "fabulous potent demonic confused gate 4955",
5}

generate({ words: 2, number: false, alliterative: true }) will return:

1{
2    raw: [ "somber", "snails" ],
3    dashed: "somber-snails",
4    spaced: "somber snails",
5}

Tests

To run tests locally:

bun install

bun test