A fantasy themed random name generator.
Project description
Fantasy Name Generator
A random name generator that produces names aligning (more or less) with common conventions for fantasy characters in fictional media such as Dungeons and Dragons or World of Warcraft.
Installation
python3 -m pip install fantasynames
Usage
The following name generating functions are provided for a variety of different stereotypical fantasy "races", as well as a few different "medieval-y" languages:
import fantasynames as names
names.elf()
# Example outputs: 'Farathia Eaviel', 'Iethian Willowblossom'
names.dwarf()
# Example outputs: 'Thrunnor Ironfury', 'Lothuna Strongmail'
names.hobbit()
# Example outputs: 'Libby Honeyfoot', 'Flublius Sweetscone'
names.french()
# Example outputs: 'Auland Roublac', 'Rondri de Clardalle'
names.anglo()
# Example outputs: 'Brandin of Avonlyn', 'Kallem Davenmere'
names.human()
# Example outputs: 'Danric du Tourbloc', 'Sumia Sageholme'
Note that human()
provides a diverse mix of different first and last name styles, including anglo()
and french()
...and more!
You can also pass a string argument to specify whether you want to recieve masculine or feminine names. By default, it's totally random:
names.human() # this will randomly generate either a male or female name
names.human('any') # this is equivalent to the above, in case you want to be specific
names.human('male') # this will generate a masculine name
names.human('female') # this will generate a feminine name
Contributing
Poetry
This package uses Poetry for package management. After checking out the repo, use poetry install
to install all the required dependencies. Anytime you need to add a package, use:
poetry add <PACKAGE_NAME_HERE>
Linting / Formatting
We do code formatting with Python Black, other linting with flake8
, and type checking with mypy
. Before opening a PR, please make sure to run all of these. Below is a helpful command to do them all at once:
poetry run black fantasynames && poetry run flake8 fantasynames && poetry run mypy fantasynames
Guides
For guides on how to make your own name generators, check out the How to Add a New Name Generator Guide. And then if you want to ramp up the complexity, take a look at the Transformation Guide.
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
Built Distribution
Hashes for fantasynames-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ee8e813e42e7bf690722553931d5826de1dd36b8e918d7c1af64f0c25fd6db2a |
|
MD5 | defc5a9937bc0daba8d88403c98475b0 |
|
BLAKE2b-256 | bb06c83d2fbc97849eb56ec927d8e504f26e15661ab391bbe2eb47444ac9ab6a |