juiceinc/names

Random name generator

names

Random name generator

Installation

The script is available on PyPI. To install with pip:

sudo pip install names

Usage

Names can be used as a command line utility or imported as a Python package.

Command Line Usage

To use the script from the command line:

$ names
John Powell

Python Package Usage

Here are examples of all current features:

>>> import names
>>> names.get_full_name()
u'Patricia Halford'
>>> names.get_full_name(gender='male')
u'Patrick Keating'
>>> names.get_first_name()
'Bernard'
>>> names.get_first_name(gender='female')
'Christina'
>>> names.get_last_name()
'Szczepanek'

Optionally, you can pass cached=True to any of these functions which caches the name list and is recommended if you are generating many names.

License

This project is released under an MIT License.

Data in the following files are public domain (derived from 1990 Census data):

• dist.all.last
• dist.female.first
• dist.male.first