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

Uploaded Source

Built Distribution

fictional_names-0.2.1-py3-none-any.whl (83.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: fictional_names-0.2.1.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.1.tar.gz
Algorithm Hash digest
SHA256 ec2a8f7832a29bf55190c1a2319a77331b7536b630fedbeeb0fcb6d4ca259bd6
MD5 302030481b9b2870c82ac472beb287e3
BLAKE2b-256 f1f629fe7d447dbb9910bba1722e6c561488e795915263536a50df01adce489f

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for fictional_names-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 404043d1eea7033e0674cfa974cd2f6051bdb08bd2e004799c24094bb1175e1f
MD5 31d54e9028f42a70d83ee37f123f9913
BLAKE2b-256 64b6a0ac134b9475bd60a615eaf08fb6233a02804282482401ba188bcca3f46a

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