Skip to content

AlessandroMinoccheri/human-names

Repository files navigation

human-names v1.0.12

Build Status Licensed under the MIT License PR's Welcome npm version

Get popular human english, italian, french, deutch, spanish or dutch names.

To create this repository I have forked this project and make some edit:

https://github.com/sindresorhus/supervillains

Thanks to the author https://github.com/sindresorhus

The name lists are just JSON files and can be used wherever.

Not accepting PRs for additional names.

Install

$ npm install --save human-names

Usage

const humanNames = require('human-names');

humanNames.femaleRandom();
//=> Lucy

API

.female

Type: array

Top female names sorted by popularity.

.male

Type: array

Top male names sorted by popularity.

.all

Type: array

Top names sorted by popularity.

.femaleRandom()

Type: function

Random female name.

.maleRandom()

Type: function

Random male name.

.allRandom()

Type: function

Random name.

CLI

$ npm install --global human-names
$ human-names --help

  Examples
    $ human-names
    Lucy

    $ human-names --all --type male
    Max
    John
    ...

  Options
    --all   Get all names instead of a random name
    --type  Type of name: female|male|all  Default: all
    --lang  lang of name: en|it|fr|de|es|nl  Default: en

License

MIT © Alessandro Minoccheri