be1lnash3/heroku_userbot_dock
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
6 commits 1 branch 0 tags 92 KiB
Find a file
Exact
Belnash3 f4afeec755 Updated README to reflect Guide v5.1 and 10 modules
2025-12-10 01:39:26 +03:00
примеры модулей Full Restoration of Guide + 10x Module Analysis 2025-12-10 01:37:57 +03:00
calculator_example.py Initial commit: Documentation and Module Examples 2025-12-10 01:10:07 +03:00
grafana_exporter.py Initial commit: Documentation and Module Examples 2025-12-10 01:10:07 +03:00
MODULE_DEV_GUIDE.md Full Restoration of Guide + 10x Module Analysis 2025-12-10 01:37:57 +03:00
README.md Updated README to reflect Guide v5.1 and 10 modules 2025-12-10 01:39:26 +03:00
template.py Initial commit: Documentation and Module Examples 2025-12-10 01:10:07 +03:00
whois_example.py Initial commit: Documentation and Module Examples 2025-12-10 01:10:07 +03:00

README.md

🚀 Heroku & Hikka Userbot Modules Development Hub

The Ultimate Encyclopedia & Pattern Collection

Добро пожаловать в крупнейший ресурс по разработке модулей для юзерботов Friendly-Telegram (FTG) и Hikka. Репозиторий содержит фундаментальную документацию («Библию Разработчика») и эталонные примеры кода.

📚 Документация: Grandmaster Edition (v5.1)

Файл MODULE_DEV_GUIDE.md обновлен до версии 5.1 и теперь содержит более 2500 строк знаний.

Что внутри?

  1. Фундамент: Архитектура Loader, Dependency Injection, жизненный цикл и безопасность.
  2. Data Engineering: CLI, Argparse, сложная конфигурация и JSON-базы данных.
  3. Telethon Deep Dive: Работа с потоками (Streams), Entities, Inline-ботами и Raw TL-функциями.
  4. DevOps: Интеграция с Heroku API, самообновление через Git, мониторинг через Grafana.
  5. Алхимия: Monkey Patching, Middleware, Watchers и оптимизация.
  6. Full Analysis: Построчный разбор архитектуры 10 реальных production-модулей.

🛠 Полная Коллекция Примеров (10 Модулей)

В папке примеры модулей/ и корне репозитория находятся исходники, разобранные в документации. Это "Золотой стандарт" кода.

Модуль Сложность Ключевые паттерны и технологии
Terminal.py 🔴 Elite asyncio.subprocess, Realtime-вывод в Telegram, буферизация сообщений.
Executor.py 🔴 Elite Безопасный eval с поддержкой await (meval), перехват sys.stdout.
HerokuConfig.py 🟠 Hard Динамическая генерация Inline-меню, валидаторы конфигов, пагинация.
Loader.py 🔴 Core Динамический импорт (importlib), управление зависимостями (pip), безопасность.
APILimiter.py 🔴 Elite Monkey Patching: перехват методов Telethon для защиты от спама.
Tester.py 🟡 Middle Интеграция logging в Telegram-чат, Hot-reload (Watchdog) файлов.
Updater.py 🟡 Middle Работа с git из кода, само-перезапуск процесса (os.execl).
Help.py 🟡 Middle Интроспекция объектов, генерация документации на лету из docstrings.
herokuinfo.py 🟢 Easy Работа с графикой (Pillow), системные метрики (psutil), инфо-баннеры.
settings.py 🟢 Easy Управление БД (Blacklist), Алиасы команд, Смена префикса.

👨‍💻 Авторы и Контакты

Энциклопедия и анализ модулей подготовлены пользователем Belnash3.

💬 Вопросы и поддержка: @go_minetik

Код — это поэзия, а хороший Userbot — это магия.