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

Uploaded Source

Built Distribution

fictional_names-0.1.1-py3-none-any.whl (87.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: fictional_names-0.1.1.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.1.tar.gz
Algorithm Hash digest
SHA256 a1f12d67a57976487fc2009353b959275a3b3e6ab91ecbee849dbe9cc5a3d832
MD5 b5b0cc6cca7e9f89dcdfe266ea671e88
BLAKE2b-256 411e708eb4f7ddb51b2b3075f77f33a3e2acfa681722b9d2b0f143ea882c2e28

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for fictional_names-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 68063d406e1c455439b9e104b1cde9b8708b3fce008395337f14cfcec24afcd0
MD5 ff96c97e162ee7bb2ac119a2daf1a260
BLAKE2b-256 b8f091cf86997c853511ddc4c2db019302d96c71f65ff041f7f0e9af10dbc50b

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