| Name | FantasyNameGenerator JSON |
| Version |
0.0.5
JSON |
| download |
| home_page | |
| Summary | A name generator from various worlds of fantasy |
| upload_time | 2023-08-17 20:46:08 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | |
| license | |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Fantasy Names
A Python project dedicated to generating names from various bits of fantasy
[](https://github.com/psf/black)
## Installation
### pip
Install [FantasyNameGenerator](https://pypi.org/project/FantasyNameGenerator/) as a package with pip using this command:
`pip install FantasyNameGenerator`
### Source
Install FantasyNameGenerator as a package from source using this command while in the home directory
`pip install .`
## Usage
The main use case for this application is to generate a random name for something.
Since this project offers many different types of generators, the main formula for these follows this pattern:
```python
from FantasyNameGenerator.<Category> import <Thing>
```
#### Examples
Town Name Generator
```python
from FantasyNameGenerator.Stores import Town
print(Town())
var = Town()
for name in Town():
print(name)
```
Weapon Name Generator
```python
from FantasyNameGenerator.Items import Weapon
print(Weapon())
var = Weapon()
for name in Weapon():
print(name)
```
Dungeon's & Dragons Aasimer Name
```python
from FantasyNameGenerator.DnD import Aasimer
print(Aasimer())
var = Aasimer()
for name in Aasimer():
print(name)
```
Pathfinder Human Male Name
```python
from FantasyNameGenerator.Pathfinder import Human
print(Human.generate(Human.HumanType.Male))
var = Human.generate(Human.HumanType.Male)
for name in Human():
print(name)
```
### Generators
There are a few name generators included with this repo. Here are the main categories and what they contain:
### Stores
- Antique
- Book
- Children
- Drama
- Fiction
- Horror
- Humor
- Mystery
- Non-fiction
- Romance
- Sci-Fi
- Tome
- Clothes
- Enchanter
- Alchemist
- Restaurant
- Tavern
- Diner
- French
- Jeweller
- Blacksmith
- General
- Town
- Brothel
- Gunsmith
- Guild
### Items
- Relic
- Armor
- Book
- Potion
- Jewel
- Other
- Weapon
- Axe
- Bow
- Dagger
- Hammer
- Mace
- Spear
- Sword
### Pathfinder Races
- Coming Soon
### Dungeons & Dragons Races
*Note: Accessing this library in the package uses the preface `DnD` for simplicity.*
- Aarakocra
- Aasimer
- Bugbear
- Centaur
- Changeling
- Dragonborn
- Drow
- Duergar
- Dwarf
- Elf
- Fetchling
- Firbolg
- Genasi
- Gith
- Gnome
- Goblin
- Goliath
- Halfling
- Hobgoblin
- Human
- Half-Elf
- Half-Orc
- Kalashtar
- Kenku
- Kobold
- Lizardfolk
- Loxodon
- Minotaur
- Orc
- Shifter
- Simic Hybrid
- Svirfneblin
- Tabaxi
- Tiefling
- Tortle
- Triton
- Vedalken
- Warforged
- Yuan-ti
## Contributing
All are suggestions are welcome, and any additions you'd wish to make should be made as a Pull Request to the master branch.
There are a few things you need to do prior to making a pull request:
### Pull Request Checklist
- [ ] Unit test coverage added
- [ ] Black code format
#### Unit Test Coverage
This project uses pytest integrated with Tox to run unit tests.
To run unit test coverage make sure you have Tox installed, and then run the following command:
`tox`
Tox runs 4 different versions of python to ensure backwards capability, 3.8, 3.9, 3.10, & 3.11.
To run these make sure you have the appropriate version of python installed.
#### Black code formatting
This project is formatted automatically with [Black](https://black.readthedocs.io/en/latest/).
Prior to making a pull request, please format your code using the follow command:
`black --line-length=120 .`
#### Build Pipeline
Build Tarball
`python -m build --sdist .`
Publish via Twine
`python -m twine upload dist/FantasyNameGenerator-<Version #>.tar.gz`
Raw data
{
"_id": null,
"home_page": "",
"name": "FantasyNameGenerator",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/b5/e0/52b7b08ae20a32dcfeefed2eba3f8a190b51d051ee22184ca04afb62c36b/FantasyNameGenerator-0.0.5.tar.gz",
"platform": null,
"description": "# Fantasy Names\r\nA Python project dedicated to generating names from various bits of fantasy\r\n\r\n[](https://github.com/psf/black)\r\n\r\n## Installation\r\n\r\n### pip\r\n\r\nInstall [FantasyNameGenerator](https://pypi.org/project/FantasyNameGenerator/) as a package with pip using this command:\r\n\r\n`pip install FantasyNameGenerator`\r\n\r\n### Source\r\n\r\nInstall FantasyNameGenerator as a package from source using this command while in the home directory\r\n\r\n`pip install .`\r\n\r\n## Usage\r\n\r\nThe main use case for this application is to generate a random name for something.\r\nSince this project offers many different types of generators, the main formula for these follows this pattern:\r\n\r\n```python\r\nfrom FantasyNameGenerator.<Category> import <Thing>\r\n```\r\n\r\n#### Examples\r\n\r\nTown Name Generator\r\n```python\r\nfrom FantasyNameGenerator.Stores import Town\r\nprint(Town())\r\nvar = Town()\r\nfor name in Town():\r\n print(name)\r\n```\r\n\r\nWeapon Name Generator\r\n```python\r\nfrom FantasyNameGenerator.Items import Weapon \r\nprint(Weapon())\r\nvar = Weapon()\r\nfor name in Weapon():\r\n print(name)\r\n```\r\n\r\nDungeon's & Dragons Aasimer Name\r\n```python\r\nfrom FantasyNameGenerator.DnD import Aasimer \r\nprint(Aasimer())\r\nvar = Aasimer()\r\nfor name in Aasimer():\r\n print(name)\r\n```\r\n\r\nPathfinder Human Male Name\r\n```python\r\nfrom FantasyNameGenerator.Pathfinder import Human \r\nprint(Human.generate(Human.HumanType.Male))\r\nvar = Human.generate(Human.HumanType.Male)\r\nfor name in Human():\r\n print(name)\r\n```\r\n\r\n### Generators\r\n\r\nThere are a few name generators included with this repo. Here are the main categories and what they contain:\r\n\r\n### Stores\r\n\r\n- Antique\r\n- Book\r\n - Children\r\n - Drama\r\n - Fiction\r\n - Horror\r\n - Humor\r\n - Mystery\r\n - Non-fiction\r\n - Romance\r\n - Sci-Fi\r\n - Tome\r\n- Clothes\r\n- Enchanter\r\n- Alchemist\r\n- Restaurant\r\n - Tavern\r\n - Diner\r\n - French\r\n- Jeweller\r\n- Blacksmith\r\n- General\r\n- Town\r\n- Brothel\r\n- Gunsmith\r\n- Guild\r\n\r\n### Items\r\n\r\n- Relic\r\n - Armor\r\n - Book\r\n - Potion\r\n - Jewel\r\n - Other\r\n- Weapon\r\n - Axe\r\n - Bow\r\n - Dagger\r\n - Hammer\r\n - Mace\r\n - Spear\r\n - Sword\r\n\r\n### Pathfinder Races\r\n\r\n- Coming Soon\r\n\r\n### Dungeons & Dragons Races\r\n\r\n*Note: Accessing this library in the package uses the preface `DnD` for simplicity.*\r\n\r\n- Aarakocra\r\n- Aasimer\r\n- Bugbear\r\n- Centaur\r\n- Changeling\r\n- Dragonborn\r\n- Drow\r\n- Duergar\r\n- Dwarf\r\n- Elf\r\n- Fetchling\r\n- Firbolg\r\n- Genasi\r\n- Gith\r\n- Gnome\r\n- Goblin\r\n- Goliath\r\n- Halfling\r\n- Hobgoblin\r\n- Human\r\n- Half-Elf\r\n- Half-Orc\r\n- Kalashtar\r\n- Kenku\r\n- Kobold\r\n- Lizardfolk\r\n- Loxodon\r\n- Minotaur\r\n- Orc\r\n- Shifter\r\n- Simic Hybrid\r\n- Svirfneblin\r\n- Tabaxi\r\n- Tiefling\r\n- Tortle\r\n- Triton\r\n- Vedalken\r\n- Warforged\r\n- Yuan-ti\r\n\r\n## Contributing\r\n\r\nAll are suggestions are welcome, and any additions you'd wish to make should be made as a Pull Request to the master branch.\r\nThere are a few things you need to do prior to making a pull request:\r\n\r\n### Pull Request Checklist\r\n- [ ] Unit test coverage added\r\n- [ ] Black code format\r\n\r\n#### Unit Test Coverage\r\nThis project uses pytest integrated with Tox to run unit tests.\r\nTo run unit test coverage make sure you have Tox installed, and then run the following command:\r\n`tox`\r\n\r\nTox runs 4 different versions of python to ensure backwards capability, 3.8, 3.9, 3.10, & 3.11.\r\nTo run these make sure you have the appropriate version of python installed.\r\n\r\n#### Black code formatting\r\nThis project is formatted automatically with [Black](https://black.readthedocs.io/en/latest/).\r\nPrior to making a pull request, please format your code using the follow command:\r\n`black --line-length=120 .`\r\n\r\n#### Build Pipeline\r\n\r\nBuild Tarball\r\n\r\n`python -m build --sdist .`\r\n\r\nPublish via Twine\r\n\r\n`python -m twine upload dist/FantasyNameGenerator-<Version #>.tar.gz`\r\n",
"bugtrack_url": null,
"license": "",
"summary": "A name generator from various worlds of fantasy",
"version": "0.0.5",
"project_urls": {
"Source": "https://github.com/Dude036/FantasyNameGenerator"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b5e052b7b08ae20a32dcfeefed2eba3f8a190b51d051ee22184ca04afb62c36b",
"md5": "63eac6b585e9b97a60dfd482639f9aff",
"sha256": "3c62fd285625e38ce722a99c84513a8e4373fd7dd5df176148c7291cc57fa101"
},
"downloads": -1,
"filename": "FantasyNameGenerator-0.0.5.tar.gz",
"has_sig": false,
"md5_digest": "63eac6b585e9b97a60dfd482639f9aff",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 185128,
"upload_time": "2023-08-17T20:46:08",
"upload_time_iso_8601": "2023-08-17T20:46:08.516941Z",
"url": "https://files.pythonhosted.org/packages/b5/e0/52b7b08ae20a32dcfeefed2eba3f8a190b51d051ee22184ca04afb62c36b/FantasyNameGenerator-0.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-17 20:46:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Dude036",
"github_project": "FantasyNameGenerator",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "fantasynamegenerator"
}
