charbox 0.0.1

CharBox is a Python library that generates random character attributes, including names, hair colors, and eye colors. It supports multiple name origins and offers standard and fancy variations for hair and eye colors.

CharBox

A powerful character attribute generator for Python.

Overview

CharBox is a Python library that generates random character attributes, including names, hair colors, and eye colors. It supports multiple name origins and offers standard and fancy variations for hair and eye colors.

Features

• Generate realistic or fantasy-inspired names.
• Choose names based on gender and origin (American, Japanese, Korean, German, Russian).
• Generate standard or fancy hair and eye colors.
• Translate complex color names into readable formats.
• Simple initialization and usage.

Installation

Install CharBox via pip:

pip install charbox

Usage

Initializing the Library

Before using CharBox, you must initialize it:

import charbox
charbox.init()

Generating Names

from charbox import Name

# Generate a first name
first_name = Name.generate_first_name(gender="male", origin="Japanese")
print(first_name)  # Example Output: Haruto

# Generate a last name
last_name = Name.generate_last_name(origin="American")
print(last_name)  # Example Output: Smith

# Generate a full name
full_name = Name.generate_name(gender="female", origin="Russian")
print(full_name)  # Example Output: Anastasia Ivanova

Generating Hair Colors

from charbox import HairColor

# Generate a standard hair color
hair_color = HairColor.generate_hair_color(wording="standard")
print(hair_color)  # Example Output: Chestnut

# Generate a fancy hair color
fancy_hair_color = HairColor.generate_hair_color(wording="fancy")
print(fancy_hair_color)  # Example Output: Sapphire

# Translate a fancy hair color to a readable format
translated_hair_color = HairColor.translate("Sapphire")
print(translated_hair_color)  # Example Output: Blue

Generating Eye Colors

from charbox import EyeColor

# Generate a standard eye color
eye_color = EyeColor.generate_eye_color(wording="standard")
print(eye_color)  # Example Output: Green

# Generate a fancy eye color
fancy_eye_color = EyeColor.generate_eye_color(wording="fancy")
print(fancy_eye_color)  # Example Output: Amethyst

# Translate a fancy eye color to a readable format
translated_eye_color = EyeColor.translate("Amethyst")
print(translated_eye_color)  # Example Output: Purple

License

This project is licensed under the MIT License. See LICENSE for details.

Author

Developed by Taireru LLC. Check out our other projects at https://tairerullc.vercel.app/pages/products.

Contributing

Contributions are welcome! Feel free to submit a pull request or report issues in the repository.

Support

For support, please contact us via email or visit our website.

---

⭐ Enjoy using CharBox? Give us a star on GitHub!