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', 'dragonborn', 'drow', 'dwarven', 'elven', 'english', 'eriskon', 'germanic', 'giant', 'gnomish', '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-1.0.0.tar.gz (83.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fictional_names-1.0.0-py3-none-any.whl (90.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: fictional_names-1.0.0.tar.gz
  • Upload date:
  • Size: 83.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.10.12

File hashes

Hashes for fictional_names-1.0.0.tar.gz
Algorithm Hash digest
SHA256 55d3b5d9aa25f64a3e37d008812e4a9540399346b985f5970a8aecdbf5430a7c
MD5 4a464371f25d692be3645e41667b1e25
BLAKE2b-256 f34b9d7413a722bffc3abca1e9dacbc3147c4c0f287b1cd68df35f032c39d2a3

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for fictional_names-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 befcc9f2f2e366e52dba3eb5527e6641dec386ca2091cb7671b8311fe9adc273
MD5 4e7eba2494500103a979fa22b747c3e1
BLAKE2b-256 707c659bdb42d6f3c7132e13df546590945e918adc0818aeebbefd4f135d3fc3

See more details on using hashes here.

Supported by

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