nameCreator

A package to generate names by country


Keywords
name-generation, name-generator, names, python
License
Apache-2.0
Install
pip install nameCreator==0.9.0

Documentation

nameCreator

GitHub release (latest by date) GitHub forks GitHub license GitHub issues

A python name generator for Windows.

This is a python package for name generation. It can generate names from different countries, and can generate both male and female names. Ethnicities: "american", "russian", "spanish", "italian", "german", "french", "swedish", "finnish", "japaneser" (japanese romanized), "japanese", "chineser" (chinese romanized), and "chinese".

Installation

From pypi

Install from pypi with pip:

pip install nameCreator

Build from source

Clone the repository and cd into the nameCreator directory, then:

pip install build
python -m build
cd dist
pip install nameCreator-1.0.0-py3-none-any.whl

Usage (Only applies when built from source, read the release's corresponding README for that version's usage)

In python file

firstNameMale = nameCreator.FirstNameMale('nationality')

print(firstNameMale)

lastName = nameCreator.LastName('nationality')

print(lastName)

firstNameFemale = nameCreator.FirstNameFemale('nationality')

print(firstNameFemale)

lastName = nameCreator.LastName('nationality')

print(lastName)

In command line

Displays help message:

nameCreatorCLI generate --help

Generates 10 male finnish names:

nameCreatorCLI generate -a 10 -e finnish -g m

Generates 10 italian female names, sends to a text file and does not print the output to the terminal:

nameCreatorCLI generate -a 10 -e italian -g f -o italianNames.txt -n

Arguments:

Specifies the amount of names to generate:

-a --amount

Specifies the ethnicity:

-e --ethnicity

Specifies the gender of the generated names:

-g --gender

Specifies the output path (like C:/Users/You/test.txt or test.txt to put in the current path):

-o --output

Specifies whether or not to print the output to the terminal (useless if there is no output path specified):

-n --noprint

SOURCES:

https://github.com/ironarachne/namegen