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

pip install Eyad_shawky_anim

For development:

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

Quick Start

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

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

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

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

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

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

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 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.