Random name generator for Node.js
JavaScript
Latest commit 01dade9 Apr 15, 2011 @weaver Add choose() method.
Permalink
Failed to load latest commit information.
dict Initial release. Apr 14, 2011
examples Initial release. Apr 14, 2011
lib Add choose() method. Apr 15, 2011
test Add choose() method. Apr 15, 2011
Makefile Initial release. Apr 14, 2011
README.md Add choose() method. Apr 15, 2011
package.json Add choose() method. Apr 15, 2011

README.md

Moniker

A random name generator for Node.js.

Synopsis

Moniker provides a default adjective/noun generator. Use it like this:

var Moniker = require('moniker');
console.log(Moniker.choose());
// Example output: murky-hands

You can also make a custom generator. Generators create random names using dictionaries. Moniker has built-in noun, verb, and adjective dictionaries, or you can add your own.

var Moniker = require('moniker');
var names = Moniker.generator([Moniker.adjective, Moniker.noun]);
console.log(names.choose());

Installation

Install Moniker using NPM:

npm install moniker

API

Generators

generator(dictionaries, options)

Create a new Generator. When a new name is generated, a word is chosen from each item in dictionaries in order.

Each dictionary may be a Dictionary instance, a string path to a file of words separated by spaces or newlines, or a function that should return a Dictionary when called.

The options are optional and are passed along to the new Generator and any new Dictionary. They default to:

{
  maxSize: undefined,
  encoding: 'utf-8',
  glue: '-'
}

Generator(options)

A name generator. Be sure to .use() some dictionaries afterward. Options may include:

{
  glue: '-'
}

generator.use(dictionary, options)

Add a new dictionary to this generator. When a new name is generated, a word is chosen from each dictionary in order.

The dictionary may be a Dictionary instance, a string path to a file of words separated by spaces or newlines, or a function that should return a Dictionary when called. The options are passed along to each newly-constructed Dictionary.

generator.choose()

Create a new name.

Dictionaries

adjective(options)

Create a Dictionary of using the builtin adjectives list.

noun(options)

Create a Dictionary of using the builtin noun list.

verb(options)

Create a Dictionary of using the builtin verb list.

read(path, options)

Create a Dictionary by reading words from a file. The file should be a list of words separated by spaces or newlines.

Dictionary()

A dictionary is a list of words.

dict.read(path, options)

Load words from path into this dictionary. Options default to:

{
  maxSize: undefined,
  encoding: 'utf-8',
}

Words larger than maxSize are ignored.

dict.choose()

Return a random word from this dictionary.