Metadata-Version: 2.4
Name: artapi
Version: 1.0.0
Summary: Animated ASCII art renderer for Python terminals.
Author: whoami
License: MIT
Keywords: ascii,ascii-art,terminal,cli,animation,banner,console,python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Operating System :: OS Independent
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pystyle>=2.9
Dynamic: license-file

# ArtAPI

Simple Python library for beautiful animated ASCII banners in the terminal.

## Features

- ✨ Typing animation
- ⚡ Glitch effect
- 💡 Shine effect
- 🌈 RGB grayscale colors
- 🔁 Infinite animation loop
- 📍 Automatic terminal centering

## Installation

```bash
pip install artapi
```

## Usage

```python
from artapi import show, gradient, xcenter

banner = r"""
    _         _   
   / \   _ __| |_ 
  / _ \ | '__| __|
 / ___ \| |  | |_ 
/_/   \_\_|   \__|
"""

show(banner) # this will be with gradient and xcenter
print(gradient(xcenter("Hello World!"))) # this is a vertically gradiented & centered text
```

## Options

```python
show(
    banner,
    typing=True,
    glitch=True,
    flash=True,
    shine=True,
    loop=False,
    speed=0.01
)
```

| Parameter | Description | Default |
|-----------|-------------|---------|
| typing | Typing animation | True |
| glitch | Glitch effect | True |
| flash | Flash effect | True |
| shine | Shine animation | True |
| loop | Infinite shine loop | False |
| speed | Shine animation speed | 0.01 |

## Example

```python
from artapi import show

banner = """
██╗  ██╗███████╗██╗     ██╗      ██████╗
██║  ██║██╔════╝██║     ██║     ██╔═══██╗
███████║█████╗  ██║     ██║     ██║   ██║
██╔══██║██╔══╝  ██║     ██║     ██║   ██║
██║  ██║███████╗███████╗███████╗╚██████╔╝
╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝ ╚═════╝
"""

show(banner)
```

## Requirements

- Python 3.8+

## License

MIT
