Metadata-Version: 2.4
Name: Eyad_shawky_anim
Version: 1.0.0
Summary: Modern terminal animations library with loading bars, colors, and futuristic CLI visuals
Home-page: https://github.com/eyadshawky/Eyad_shawky_anim
Author: Eyad Shawky
Author-email: Eyad Shawky <eyad.shawky@example.com>
License: MIT
Project-URL: Homepage, https://github.com/eyadshawky/Eyad_shawky_anim
Project-URL: Repository, https://github.com/eyadshawky/Eyad_shawky_anim.git
Project-URL: Issues, https://github.com/eyadshawky/Eyad_shawky_anim/issues
Keywords: terminal,animation,loading-bar,progress-bar,colors,typing-effect,spinner,cli,cyberpunk,hacker
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
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 :: Terminals :: Terminal Emulators/X Terminals
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Eyad_shawky_anim

[![PyPI version](https://badge.fury.io/py/Eyad_shawky_anim.svg)](https://pypi.org/project/Eyad_shawky_anim/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python Versions](https://img.shields.io/pypi/pyversions/Eyad_shawky_anim.svg)](https://pypi.org/project/Eyad_shawky_anim/)

A professional Python library for creating beautiful terminal animations, loading bars, colorful console output, and futuristic CLI visuals. Transform your terminal programs with modern, hacker-style aesthetics.

## Features

- **Animated Loading Bars** - Smooth progress bars with multiple styles and color themes
- **Typing Animation** - Hacker-style text typing effects with adjustable speed
- **Terminal Colors** - Easy colorful text, gradients, and RGB support
- **Spinner Animations** - Loading spinners with smooth animations
- **ASCII Effects** - Matrix rain, glitch effects, and animated banners
- **Notification System** - success(), error(), warning(), info() with beautiful formatting
- **Cross-Platform** - Compatible with Windows, Linux, and macOS
- **Zero Dependencies** - Lightweight and fast, no external packages required
- **Async Support** - Thread-safe animations with FPS limiting
- **Type Hints** - Full type hint coverage for great IDE support

## Installation

```bash
pip install Eyad_shawky_anim
```

For development:

```bash
git clone https://github.com/eyadshawky/Eyad_shawky_anim.git
cd Eyad_shawky_anim
pip install -e ".[dev]"
```

## Quick Start

```python
from Eyad_shawky_anim import (
    loading_bar, spinner, type_text,
    color_text, gradient_text,
    success, error, warning, info,
    matrix_rain, glitch_text
)

# Typing effect
type_text("Access Granted", speed=0.03, theme="matrix")

# Loading bar
loading_bar(total=100, style="cyber", theme="cyber")

# Spinner
from Eyad_shawky_anim import spinner
spinner("Connecting...", spinner_type="cyber", theme="cyber")

# Colors
print(color_text("Hello World", theme="neon"))
print(gradient_text("Gradient Text", (0, 255, 255), (255, 0, 255)))

# Notifications
success("Connected Successfully")
error("Connection Failed")
warning("Low Disk Space")
info("System Ready")

# ASCII Effects
matrix_rain(duration=3.0)
glitch_text("SYSTEM BREACH", iterations=15)
```

## Detailed Usage

### Loading Bars

```python
from Eyad_shawky_anim import loading_bar

# Basic usage
loading_bar(total=100)

# With custom style and theme
loading_bar(total=100, style="cyber", theme="cyber", speed=0.02)

# Available styles: classic, cyber, minimal, blocks, arrow, dots, matrix, neon
```

### Typing Animation

```python
from Eyad_shawky_anim import type_text

# Basic typing
type_text("Hello, World!", speed=0.05)

# With theme
type_text("Access Granted", speed=0.03, theme="matrix")

# With sound simulation
type_text("Hacking...", speed=0.02, sound=True)
```

### Terminal Colors

```python
from Eyad_shawky_anim import color_text, gradient_text, rgb_text

# Preset colors
print(color_text("Red Text", color="red"))
print(color_text("Blue Text", color="blue"))

# Themes
print(color_text("Cyber Text", theme="cyber"))
print(color_text("Matrix Text", theme="matrix"))
print(color_text("Neon Text", theme="neon"))

# Gradient
print(gradient_text("Rainbow Text", (255, 0, 0), (0, 0, 255)))

# RGB
print(rgb_text("Custom Color", 128, 0, 255))
```

### Spinner Animations

```python
from Eyad_shawky_anim import spinner

# Basic spinner
spinner("Loading...", spinner_type="dots")

# Cyber spinner
spinner("Connecting...", spinner_type="cyber", theme="cyber")

# Available spinner types: dots, line, arrow, pulse, bounce, cyber, matrix, blocks
```

### Notifications

```python
from Eyad_shawky_anim import success, error, warning, info

success("Operation completed successfully!")
error("An error occurred!")
warning("This action cannot be undone!")
info("System is ready.")
```

### ASCII Effects

```python
from Eyad_shawky_anim import matrix_rain, glitch_text, ascii_banner

# Matrix rain
matrix_rain(duration=5.0, theme="matrix")

# Glitch effect
glitch_text("SYSTEM BREACH", iterations=10, theme="cyber")

# ASCII banner
ascii_banner("EYAD SHAWKY", style="cyber", theme="cyber")
```

## Color Themes

- **cyber** - Cyan and magenta futuristic theme
- **matrix** - Green hacker theme
- **neon** - Bright neon colors
- **fire** - Red and yellow fire theme
- **ocean** - Blue and cyan ocean theme

## Requirements

- Python 3.8+
- No external dependencies!

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Author

**Eyad Shawky**

## Acknowledgments

- Inspired by the cyberpunk and hacker aesthetics
- Built for developers who want beautiful terminal applications

## Support

If you find this library useful, please consider giving it a star on GitHub!

---

Made with ❤️ for the terminal enthusiast community.
