Skip to content
This repository has been archived by the owner on May 12, 2022. It is now read-only.

juiceinc/names

 
 

Repository files navigation

names

image

image

image

image

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

Packages

No packages published

Languages

  • Python 99.3%
  • Shell 0.7%