Metadata-Version: 2.4
Name: fadecat
Version: 0.2.0
Summary: Utility for creating beautiful, customizable gradients in the terminal!
Author-email: m2uroy <m2uroy@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/m2uroy/fadecat
Project-URL: Bug Tracker, https://github.com/m2uroy/fadecat/issues
Keywords: terminal,gradient,ansi,color,cli-ui,python,ascii,colors,ascii-art,fade,python-color,python-fade,python-gradient,gradient-text,fade-text,banner-text-color,module-fade-text
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Terminals
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# Fadecat
Fadecat is a fast and easy-to-use library to enhance your terminal.

Using Fadecat allows you to choose color presets (including your custom ones) and tilt.
### Getting started
Install with pip or your favorite PyPI package manager.
```bash
pip install fadecat
```
Checking that the library was installed successfully.
```bash
pip show fadecat
```
If you have received information about the library, you can continue working.

### How to use the library
To get started, first import the library
```python
from fadecat import fadecat
```

#### Parsing the call structure
For example
```python
print(fadecat.fire("Fiery greetings to the world! 🔥", tilt=180))
```
Let's look at each element
Element | Type | Description |
| :--- | :--- | :--- |
| **`fadecat`** | Object | An instance of the main `FadeCat` class. It initializes ANSI support and provides access to all palettes. |
| **`.fire`** | Method | Any palette name (like .fire, .aqua, .matrix). These are dynamic methods generated from the built-in color collection. |
| **`"text"`** | String | Your text. The gradient is automatically distributed across the entire string length (including multi-line blocks). |
| **`tilt`** | Number | The gradient angle (0-360°). It allows you to change the direction of the color transition. (default 0°)|

If you want to create your own preset
```python
print(fadecat.custom("My Text", (255,0,0), (0,0,255), tilt=90))
```
Let's talk a little about custom presets
| Parameter | Type | Purpose |
| :--- | :--- | :--- |
| **`start_rgb`** | `tuple` | Starting color in (R, G, B) format. Example: `(255, 100, 0)`. |
| **`end_rgb`** | `tuple` | Ending color in (R, G, B) format. Example: `(0, 50, 200)`. |
