Metadata-Version: 2.4
Name: color_ascii_magic_genai
Version: 0.0.3
Summary: A small example package for generating colored ASCII art
Project-URL: Homepage, https://github.com/example/color_ascii_magic_genai
Author-email: Prasoon Kumar <prasoonkumar@example.com>
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.7
Requires-Dist: art
Requires-Dist: termcolor
Description-Content-Type: text/markdown

# Color ASCII Magic GenAI

[![PyPI version](https://badge.fury.io/py/color_ascii_magic_genai.svg)](https://badge.fury.io/py/color_ascii_magic_genai)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A Python package for generating colorful ASCII art. It wraps the `art` library for ASCII generation and `termcolor` for coloring, adding fun modes like **Random** and **Rainbow** colors.

## Features

- **Standard Colors**: Support for `red`, `green`, `yellow`, `blue`, `magenta`, `cyan`, `white`.
- **Random Mode**: Automatically picks a random color for the entire text.
- **Rainbow Mode**: Colors each character individually with a random color for a vibrant effect.

## Installation

Install via pip:

```bash
pip install color_ascii_magic_genai
```

## Usage

Import the `colorize_text` function and use it in your scripts.

### Basic Usage

```python
from color_ascii_magic_genai import colorize_text

# Print text in a specific color
print(colorize_text("Hello World", color="red"))
```

### Random Color

Let the package decide the color for you:

```python
# Random color for the whole text
print(colorize_text("Surprise Me!", color="random"))
```

### Rainbow Mode

Go wild with multi-colored characters:

```python
# Each character gets a random color
print(colorize_text("Rainbow Magic", color="rainbow"))
```

## Supported Colors

- red
- green
- yellow
- blue
- magenta
- cyan
- white
- **random** (special mode)
- **rainbow** (special mode)

## License

This project is licensed under the MIT License.
