Skip to content

A simple and small npm package to get Doctor Who companions names.

License

Notifications You must be signed in to change notification settings

CorentinTh/doctor-who

Repository files navigation

logo

Doctor Who companions

Weekly Downloads Build Status Coverage Status npm bundle size GitHub package.json version Licence Badge

Doctor Who names: a simple and small npm package to get Doctor Who characters names. Can be useful for data anonymization or username placeholder.

const Generator = require('doctor-who');
const gen = new Generator();

gen.random(); // 'Rory Williams'
gen.all(); // ['Amy Pond', 'Rose Tyler', ... ]
gen.get(2); // ['River Song', 'Clara Oswald']

Installation

Use yarn or npm to install this package:

npm install --global doctor-who
# or
yarn global add doctor-who

API

constructor(doctors = 'all', language = 'en')

Create a new generator instance. You could choose the language in parameter and which Doctor companions to choose.

const Generator = require('doctor-who');

const gen = new Generator();
// Same as:
const gen = new Generator('all', 'en');
const Generator = require('doctor-who');

// Will generate names from only the companions of the 10th and 11th Doctor.
const gen = new Generator([11, 10]);

// Will generate names from the companions of all Doctors.
const gen = new Generator('all');

// Will generate names from the companions of only the 12th doctor.
const gen = new Generator([12]);

random()

Return a random name of a character in Doctor Who.

const Generator = require('doctor-who');
const gen = new Generator();

gen.random(); // Amy Pond

all()

Return an array containing all names.

const Generator = require('doctor-who');
const gen = new Generator();

gen.all(); // ['Amy Pond', 'Rose Tyler', ... ]

get(count = 1)

Return an array containing count names.

const Generator = require('doctor-who');
const gen = new Generator();

gen.get(2); // ['Amy Pond', 'Rose Tyler']

Cli

This tool can also be used from the command line.

$ doctor-who
Amy pond

Usage

$ doctor-who -h
Usage: datamanager [options]

get a random value

Options:
  -V, --version              output the version number
  -a, --all                  get all values
  -l, --language <language>  specify language. Available languages are: en (default: "en")
  -c, --count <n>            get n values
  -r, --random               get a random value. Same as without options
  -h, --help                 output usage information

Languages

The currently available languages for the names are:

Add yours !

Contribute

Pull requests are welcome ! Feel free to contribute.

Credit

MIT Licensing. Coded by Corentin Thomasset