Metadata-Version: 2.1
Name: frint
Version: 0.1.2
Summary: Stylish terminal text
Author: leechuun
Author-email: leechuun@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Utilities
Classifier: Environment :: Console
Requires-Python: >=3.8
Description-Content-Type: text/markdown

**frint** is a Python library for creating colorful, animated, and interactive terminal outputs. It supports gradients, rainbow text, wave and bounce animations, progress bars, spinners, and styled messages, making it easy to build visually engaging command-line applications.

---

## Features

- Colored Text: Foreground and background support.
- Animated Typing: Smoothly prints text character by character.
- Gradient Text: Fade text from one color to another.
- Rainbow Text: Vibrant multi-color effects.
- Wave & Bounce Animations: Fun text effects for terminal output.
- Progress Bars: Fancy progress bars using `rich`.
- Spinners: Interactive terminal spinners with multiple styles.
- Messages: Styled success, error, warning, and info messages.
- Cross-platform: Works on Windows, macOS, and Linux using `colorama` and `rich`.

---

## Installation

```bash
pip install frint
````

---

## Quick Start

```python
from frint import *

# Animated typing
print_animated("Hello, world!", (255, 100, 200))

# Gradient text
print_gradient_rich("Blazing-fast gradient!", (255, 0, 0), (0, 255, 255))

# Rainbow text
print_rainbow("RAINBOW POWER!")

# Wave and bounce animations
print_wave("Wave animation!", (0, 255, 255))
print_bounce("Bounce!", (255, 200, 0))

# Progress bar
progress_bar_rich(50, "Loading...")

# Spinner
spinner = SpinnerRich("Processing...", style="dots")
spinner.start()
import time; time.sleep(2)
spinner.stop()

# Styled messages
success("Done!")
error("Failed!")
warning("Watch out!")
info("FYI")
```

---

## Usage Examples

* Quickly highlight success or errors in scripts:

```python
success("Task completed successfully!")
error("Something went wrong.")
```

* Create visually appealing CLI applications with gradient or rainbow text:

```python
print_gradient_rich("Gradient Text Example", (255,0,0), (0,255,255))
print_rainbow("Rainbow Text Example")
```

* Add dynamic feedback with spinners and progress bars:

```python
progress_bar_rich(100, "Processing Data")
spinner = SpinnerRich("Loading...", style="dots")
spinner.start()
time.sleep(3)
spinner.stop()
```

---

## License

MIT License
