honexui 0.1.0

Professional CLI UI library for cybersecurity tools and terminal applications

🐝 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

---

📦 Установка

pip install honexui

Или из исходников:

git clone https://github.com/halloweenhonex-art/honexui.git
cd honexui
pip install -e .

---

🚀 Быстрый старт

Базовый пример

from honexui import HonText

HonText(
    text="HONEX CYBER",
    size="5-35",
    color="#AA6677",
    style="bold",
    align="center",
    animate="4"
).render()

Пример с пресетами

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-стиль (каскадные символы)

Примеры использования анимаций

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 цвета

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()

Комбинации стилей

# Bold + Underline
HonText("IMPORTANT", style="bold,underline").render()

# Dim (приглушенный)
HonText("Background process", style="dim").render()

---

🎁 Готовые пресеты

Баннеры

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

from honexui.presets import banner

banner.loader_header("HONEX EXPLOIT KIT", version="3.1.4")

Меню

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()

Прогресс-бары

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

Основной класс для рендеринга текста.

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 для эксплойта

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")

Инструмент для сканирования

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 баннер

from honexui.presets import banner

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

banner.ascii_art(ascii_logo, color="#00FF41")
banner.footer("Professional Cybersecurity Toolkit")

---

🔧 Утилиты

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/honexui

---

🌟 Примеры использования в реальных проектах

HONEXUI идеально подходит для:

• 🔐 Penetration testing tools
• 🛡️ Security scanners
• 💉 Exploit loaders
• 🕵️ OSINT utilities
• 🌐 Network analysis tools
• 🔑 Password crackers
• 📡 Packet sniffers
• 🎯 Vulnerability scanners

---

Сделано с 💚 командой HONEX для security-сообщества