Skip to main content

A package for generating fictional names.

Project description

Fictional Names

PyPI version

A Python package for generating fictional names for characters in your fantasy stories, Dungeons & Dragons, RPGs, or whatever else you need them for.

Installation

python3 -m pip install fictional_names

Usage

The generate_name function is the main function of the package, and it can be used in a variety of ways, by passing different arguments to it. It takes the following arguments: gender, style, and library.

gender can be either 'male' or'female'. Leave it blank if you want random gender.

style can be any of the following: 'arab', 'aztec', 'chinese', 'dwarven', 'elven', 'english', 'eriskon', 'germanic', 'giant', 'greek', 'halfling', 'human', 'japanese', 'jordan', 'martin', 'mongolian', 'norsemen', 'orc', 'roman', 'rowling', 'sapkowski', 'slavic', 'steampunk', 'tolkien', 'turkish', or 'viking'. Leave it blank if you want a random style.

*Most styles are obvious, but some of them are named after famous authors, and some of them are named after famous fantasy races.

library can be either True or False. Leave it blank and it's randomly picked.

*True libraries are used to generate solid names that resembling real names, or names that is more likely to have been used in books, movies, or TV shows. False libraries are used to generate more unique names as they are compounded by random syllables, related to the style.

Importing the package

from fictional_names import name_generator
names = name_generator.generate_name

What it follows is a list of examples of how to use the function, and what you can expect to get from it.

Completely random names

names()
# Probable generated names: 'Eleanor Neumann', 'Nathaniel Eberhardt', 'Yolotzintli (Ethereal Mist)', 'Isabeau of Rhovanion', 'Barthanes al'Tealdar', 'Arabella Bryce', 'Sicilia Lucretillus', 'Orggol the Ruiner', 'Bolbo Honeydew', 'Gerda Einarsdottir', 'Ganoes Untor'

Human names from different cultures

names(style='english')
# Probable generated names: 'Aaron Mckinney', 'Edmund Sheffield', 'Beatrix Moss'

names(style='arab')
# Probable generated names: 'Youssef Shihab', 'Yasmin Fadel', 'Saeed Nader'

names(style='chinese')
# Probable generated names: 'Xiulan Tang', 'Guo Qing', 'Mei Chi'

names(style='germanic')
# Probable generated names: 'Dankrich Vogelweber', 'Folker Holz', 'Siegfried Wiedemann'

names(style='japanese')
# Probable generated names: 'Yumiko Yoshikawa', 'Naoki Yamamoto', 'Ryozo Nagano'

names(style='slavic')
# Probable generated names: 'Valentin Marinov', 'Pavelv Borenko', 'Zina Kovačević'

Human names from lost civilizations

names(style='aztec')
# Probable generated names: 'Miquiztli (Lorekeeper)', 'Huexotzinco (Silver Mist)', 'Callitli Tlanitl'

names(style='greek', library=True)
# Probable generated names: 'Demosthenes of Kydonia', 'Adrastos of Apollonia', 'Kallisto of Larissa'

names(style='roman')
# Probable generated names: 'Faucia Vitruvius', 'Atia Tiberius', 'Aventinus Calpurnius'

names(style='viking')
# Probable generated names: 'Ørvar Yvngirsson', 'Livþora Jarmann', 'Siggyða Norrav'

Fantasy names based on Dungeons & Dragons and other TTRPGs

names(gender='male', style='dwarven', library=False)
# Probable generated names: 'Kazdin Voldurmir', 'Thunûr Kinmarmak', 'Dorgǎrn Bǎlthrak'

names(gender='female', style='elven', library=True)
# Probable generated names: 'Galadhrim Narothor', 'Narwindë Ardalas', 'Ermalinde Nimrith'

names(style='halfling', library=True)
# Probable generated names: 'Lyric Tricklebrook', 'Nibs Cobblehill', 'Sylvia Wildflower'

names(gender='male', style='human', library=True)
# Probable generated names: 'Leander Hecht', 'Jasper Hahn', 'Galahad Thiele'

names(gender='male', style='orc', library=True)
# Probable generated names: 'Snagrag the Desecrator', 'Bolgrag the Crazed', 'Thak the Deathbringer'

names(gender='female', style='steampunk', library=True)
# Probable generated names: 'Dorothea Finnigan', 'Bernadette Baron', 'Mathilda Tarleton'

Human names based on famous authors works

names(gender='male', style='tolkien', library=True)
# Probable generated names: 'Saradoc of Bree', 'Eldric of Rohan', 'Hilbert of Dol Guldur'

names(style='martin', library=False)
# Probable generated names: 'Bran Conford', 'Toras Belton', 'Sen Berdon'

names(gender='female', style='rowling', library=False)
# Probable generated names: 'Sega Ryddle', 'Alda Glanvill', 'Kiola Graham'

Printing the name

You can print the name directly from the function, or you can store it in a variable and print it later.

print(names())

or

name = names()
print(name)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fictional_names-0.2.2.tar.gz (77.4 kB view details)

Uploaded Source

Built Distribution

fictional_names-0.2.2-py3-none-any.whl (83.8 kB view details)

Uploaded Python 3

File details

Details for the file fictional_names-0.2.2.tar.gz.

File metadata

  • Download URL: fictional_names-0.2.2.tar.gz
  • Upload date:
  • Size: 77.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.6

File hashes

Hashes for fictional_names-0.2.2.tar.gz
Algorithm Hash digest
SHA256 1aa55efff68f3718054b5e3dde80325772e10a80351a8e517c029fd030147c2b
MD5 dab41dd57fe456cd0300f7ca0c17569a
BLAKE2b-256 458fed7c70d4354396698e360d4fa022976abeaa5d51e87172aeb629e243b26f

See more details on using hashes here.

File details

Details for the file fictional_names-0.2.2-py3-none-any.whl.

File metadata

File hashes

Hashes for fictional_names-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 060eb6259e45ee7bbc3e377b3e7d616268cdd2c5bc2faefab8d909b33545db4e
MD5 1fca5a3d01d02be615255069abe32a6f
BLAKE2b-256 6b76ebd044eb039f37e5df57801ab2876e57709981ef21240e9e4e4d49652f4a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page