honexui 0.1.0
Professional CLI UI library for cybersecurity tools and terminal applications
Requires Python: >=3.9
Keywords: cli, terminal, ui, color, ansi, cybersecurity, hacking, tools, animation, text-formatting, console, truecolor

# 🐝 HONEXUI

[![Python Version](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Version](https://img.shields.io/badge/version-0.1.0-orange.svg)](https://pypi.org/project/honexui/)

**HONEXUI** — профессиональная Python-библиотека для создания красивого CLI UI в кибербезопасности, loader'ах и консольных утилитах.

Минималистичный API (1-2 строки вместо 5-15) для вывода стилизованного текста с поддержкой TrueColor, анимаций и выравнивания.

---

## ✨ Основные возможности

- 🎨 **HEX-цвета** — полная поддержка TrueColor ANSI (24-bit)
- 🎭 **Стилизация текста** — bold, dim, underline и их комбинации
- 📐 **Выравнивание** — left, center, right
- 🎬 **10 режимов анимации** — от typewriter до matrix-style
- 🎁 **Готовые пресеты** — баннеры для cyber-инструментов
- 🖥️ **Кросс-платформенность** — Windows, Linux, macOS
- 🚫 **Без зависимостей** — только стандартная библиотека Python

---

## 📦 Установка

```bash
pip install honexui
```

Или из исходников:

```bash
git clone https://github.com/halloweenhonex-art/honexui.git
cd honexui
pip install -e .
```

---

## 🚀 Быстрый старт

### Базовый пример

```python
from honexui import HonText

HonText(
    text="HONEX CYBER",
    size="5-35",
    color="#AA6677",
    style="bold",
    align="center",
    animate="4"
).render()
```

### Пример с пресетами

```python
from honexui.presets import banner

# Cyber-баннер с анимацией
banner.cyber("HONEX SECURITY TOOL", animate="matrix")

# Хедер
banner.header("SCANNING MODULE")

# Футер
banner.footer("Developed by HONEX")
```

---

## 🎬 Режимы анимации

HONEXUI включает **10 встроенных анимаций**:

| Номер | Название | Описание |
|-------|----------|----------|
| `1` | `typewriter` | Посимвольный вывод текста |
| `2` | `blink` | Мигание текста |
| `3` | `fade` | Плавное появление/исчезновение |
| `4` | `slide` | Скольжение влево/вправо |
| `5` | `glitch` | Эффект глитча с заменой символов |
| `6` | `wave` | Волновое движение |
| `7` | `loading` | Анимация загрузки с спиннером |
| `8` | `pulse` / `cyberpulse` | Пульсация яркости |
| `9` | `scramble` | Случайная перестановка с раскрытием |
| `10` | `matrix` | Matrix-стиль (каскадные символы) |

### Примеры использования анимаций

```python
from honexui import HonText

# Typewriter эффект
HonText("Loading system...", color="#00FF41", animate="typewriter").render()

# Matrix-style
HonText("BREACH DETECTED", color="#FF0000", animate="matrix").render()

# Glitch эффект
HonText("ENCRYPTION ACTIVE", color="#00D9FF", animate="glitch").render()
```

---

## 🎨 Работа с цветами

### HEX цвета

```python
from honexui import HonText

# Cyber green
HonText("ACCESS GRANTED", color="#00FF41", style="bold").render()

# Cyber blue
HonText("INITIALIZING...", color="#00D9FF").render()

# Warning red
HonText("CRITICAL ERROR", color="#FF3333", style="bold,underline").render()
```

### Комбинации стилей

```python
# Bold + Underline
HonText("IMPORTANT", style="bold,underline").render()

# Dim (приглушенный)
HonText("Background process", style="dim").render()
```

---

## 🎁 Готовые пресеты

### Баннеры

```python
from honexui.presets import banner

# Cyber-themed баннер
banner.cyber("HONEX TOOL")

# Хедер с разделителями
banner.header("NETWORK SCANNER v2.0")

# Футер
banner.footer("© 2026 HONEX Security")

# Warning
banner.warning("Unauthorized access detected")

# Success
banner.success("Connection established")

# Error
banner.error("Authentication failed")

# Info
banner.info("Scanning 192.168.1.0/24")
```

### Loader Header

```python
from honexui.presets import banner

banner.loader_header("HONEX EXPLOIT KIT", version="3.1.4")
```

### Меню

```python
from honexui.presets import menu

menu.option(1, "Scan Network", color="#00FF41")
menu.option(2, "Exploit Database", color="#00D9FF")
menu.option(3, "Exit", color="#FF3333")
menu.separator()
```

### Прогресс-бары

```python
from honexui.presets import progress
import time

# Прогресс-бар
for i in range(101):
    progress.bar(i, 100, width=50, color="#00FF41")
    time.sleep(0.05)

# Шаги процесса
progress.step(1, 5, "Loading modules...")
progress.step(2, 5, "Connecting to target...")
```

---

## 📚 Полная документация API

### HonText

Основной класс для рендеринга текста.

```python
HonText(
    text: str,                    # Текст для вывода
    size: str | None = "5-35",    # Диапазон размера (будущая функция)
    color: str | None = "#FFFFFF", # HEX цвет
    style: str | None = "bold",   # Стиль(и) текста
    align: str | None = "center", # Выравнивание
    animate: str | None = None,   # Режим анимации (1-10 или название)
    duration: float = 2.0,        # Длительность анимации (секунды)
    padding: int = 0              # Вертикальные отступы
)
```

#### Методы:

- **`render()`** — вывод в терминал с анимацией (если задана)
- **`build()`** — возвращает отформатированную строку без вывода
- **`preview()`** — отладочный режим с деталями форматирования

---

## 💼 Примеры для Cybersecurity Tools

### Loader для эксплойта

```python
from honexui import HonText
from honexui.presets import banner, progress
import time

# Заголовок
banner.loader_header("HONEX EXPLOIT LOADER", "2.5.1")

# Этапы загрузки
stages = [
    "Initializing kernel interface...",
    "Loading exploit modules...",
    "Bypassing security measures...",
    "Injecting payload...",
    "Establishing connection..."
]

for i, stage in enumerate(stages, 1):
    progress.step(i, len(stages), stage)
    time.sleep(0.8)
    
    # Прогресс-бар для текущего этапа
    for p in range(0, 101, 10):
        progress.bar(p, 100, width=40)
        time.sleep(0.1)

banner.success("EXPLOITATION COMPLETE")
```

### Инструмент для сканирования

```python
from honexui import HonText
from honexui.presets import banner, menu

banner.cyber("PORT SCANNER PRO", animate="matrix")
banner.header("MAIN MENU")

menu.option(1, "Quick Scan (Top 100 ports)", "#00FF41")
menu.option(2, "Full Scan (All 65535 ports)", "#FFaa00")
menu.option(3, "Stealth Scan (SYN)", "#00D9FF")
menu.option(4, "Configuration", "#888888")
menu.separator()
menu.option(0, "Exit", "#FF3333")

HonText(
    "Select option: ",
    color="#FFFFFF",
    align="left"
).render()
```

### ASCII Art баннер

```python
from honexui.presets import banner

ascii_logo = """
██╗  ██╗ ██████╗ ███╗   ██╗███████╗██╗  ██╗
██║  ██║██╔═══██╗████╗  ██║██╔════╝╚██╗██╔╝
███████║██║   ██║██╔██╗ ██║█████╗   ╚███╔╝ 
██╔══██║██║   ██║██║╚██╗██║██╔══╝   ██╔██╗ 
██║  ██║╚██████╔╝██║ ╚████║███████╗██╔╝ ██╗
╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝
"""

banner.ascii_art(ascii_logo, color="#00FF41")
banner.footer("Professional Cybersecurity Toolkit")
```

---

## 🔧 Утилиты

```python
from honexui import (
    get_terminal_size,
    clear_screen,
    hide_cursor,
    show_cursor
)

# Получить размер терминала
width, height = get_terminal_size()
print(f"Terminal: {width}x{height}")

# Очистить экран
clear_screen()

# Скрыть/показать курсор
hide_cursor()
# ... ваш код ...
show_cursor()
```

---

## 🛠️ Требования

- **Python** 3.9+
- Без внешних зависимостей
- Терминал с поддержкой ANSI escape codes
- Рекомендуется TrueColor-терминал для корректного отображения HEX-цветов

### Поддерживаемые терминалы:

✅ Windows Terminal  
✅ Windows PowerShell (с поддержкой ANSI)  
✅ Linux TTY  
✅ macOS Terminal  
✅ iTerm2  
✅ VS Code встроенный терминал  
✅ Любой терминал с COLORTERM=truecolor

---

## 📄 Лицензия

MIT License — свободно для коммерческого и некоммерческого использования.

---

## 🤝 Вклад в проект

Contributions приветствуются! Создавайте issues и pull requests.

1. Fork проекта
2. Создайте feature branch (`git checkout -b feature/amazing-feature`)
3. Commit изменения (`git commit -m 'Add amazing feature'`)
4. Push в branch (`git push origin feature/amazing-feature`)
5. Откройте Pull Request

---

## 📧 Контакты

**HONEX** — автор библиотеки  
Проекты: [https://github.com/halloweenhonex-art](https://github.com/halloweenhonex-art)  
Репозиторий: [https://github.com/halloweenhonex-art/honexui](https://github.com/halloweenhonex-art/honexui)

---

## 🌟 Примеры использования в реальных проектах

HONEXUI идеально подходит для:

- 🔐 Penetration testing tools
- 🛡️ Security scanners
- 💉 Exploit loaders
- 🕵️ OSINT utilities
- 🌐 Network analysis tools
- 🔑 Password crackers
- 📡 Packet sniffers
- 🎯 Vulnerability scanners

---

**Сделано с 💚 командой HONEX для security-сообщества**