Metadata-Version: 2.4
Name: animated_pystyle
Version: 0.3.1
Summary: Animated colored gradient text for ANSI terminals
Author: Zalcus
License-Expression: MIT
Project-URL: Homepage, https://github.com/zalcus/animated_pystyle
Project-URL: Repository, https://github.com/zalcus/animated_pystyle
Project-URL: Issues, https://github.com/zalcus/animated_pystyle/issues
Keywords: ansi,terminal,animation,gradient,text
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Terminals
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# animated_pystyle

`animated_pystyle` is a lightweight Python library for rendering animated, colored text in a terminal using 24-bit ANSI escape codes.

## Install

From PyPI:

```bash
pip install animated_pystyle
```

Or directly from GitHub:

```bash
pip install git+https://github.com/zalcus/animated_pystyle.git
```

## Quick start

```python
from animated_pystyle import animate_text

animate_text(
    text="Animated gradient text!",
    colors=[(255, 0, 255), (0, 255, 255), (255, 255, 0)],
    duration=3,
    speed=2.2,
    spacing=0.35,
    fps=30,
)
```

## Class-based API

```python
from animated_pystyle import AnimatedGradient

animator = AnimatedGradient(
    text="Hello from animated_pystyle",
    colors=[(255, 80, 80), (80, 80, 255), (80, 255, 180)],
    speed=2.0,
    spacing=0.3,
    fps=20,
)

animator.animate(duration=2)
```

## Publish to PyPI

If you maintain this package and want it downloadable via `pip install animated_pystyle`:

```bash
python -m pip install --upgrade build twine
python -m build
python -m twine check dist/*
python -m twine upload dist/*
```

## Notes

- Requires a terminal with true-color support.
- Press `Ctrl+C` to stop long-running animations.
