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.1.0.tar.gz (77.7 kB view details)

Uploaded Source

Built Distribution

fictional_names-0.1.0-py3-none-any.whl (88.1 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for fictional_names-0.1.0.tar.gz
Algorithm Hash digest
SHA256 c87e82b1cabe153e7c0868df66ac4caefa45952e2df0c65f666782be95101579
MD5 71fb2b04abf3acf86aa25ced7a810347
BLAKE2b-256 6b902b294083e6291552b5cd4f5950a5265823c44c3542a9754b670505a14098

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for fictional_names-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3f76dc317302580946b19feffc18ed3673c840fcd0c92a922e6f647367494dfb
MD5 01284a598822db444f8d0421b31afc5a
BLAKE2b-256 ba757cfbcc707ddfa5af88cc360aab58e5d9c6bda06e2483da94be76f2b6efe6

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