Skip to content

Latest commit

 

History

History
50 lines (37 loc) · 1.54 KB

README.md

File metadata and controls

50 lines (37 loc) · 1.54 KB

Namebot

A robot that streams name combinations for you. Beep ... ding!

Build Status

Namebot is a major component of what we use at DIY.org to generate silly nicknames for kids during signup. Combined with a phonetic dictionary, namebot generates unique name combinations based on a specified set of base words. For simplicity, namebot is exposed as a readable stream which can be piped into stdout or a write stream.

Install

npm install namebot

Usage

var Namebot = require('namebot');

var stream = new Namebot({
    base: ['cuttlefish', 'shrew']
    count: 100
});

stream.pipe(process.stdout);
stream.start();

Binary Use

[sudo] npm install -g namebot
namebot --base "['mega', 'shark', 'giant', 'octopus']" --count 25

Options

Base

An array of words that form the basis for names. All names generated will include a word from this object.

Dictionary (Optional)

Local path to a phonetic dictionary (see CMUdict for reference).

Count (Optional)

Number of names that will be generated. Will default to one (1) if not set.


Testing

npm test

Credits

The rhyming method for namebot was derived from James Halliday's node-rhyme module.