catalib 0.1.0

Инструмент сборки модульных плагинов для exteraGram в один файл

catalib

Инструмент сборки модульных плагинов для exteraGram.

exteraGram загружает плагин как ровно один файл <plugin_id>.py. catalib позволяет разрабатывать плагин в виде нормального дерева пакетов (папки, подпапки, несколько модулей) и собирать его в один самодостаточный .py, пригодный для штатной установки и распространения. Внутрь собранного файла встраивается компактный загрузчик на основе sys.meta_path, благодаря которому обычные import между модулями плагина работают без изменений, а трейсбеки указывают на исходные файлы.

Состав

• CLI catalib с командами build, watch, init.
• Ядро сборки (bundler) и встраиваемый рантайм-загрузчик.
• Валидация метаданных плагина по правилам exteraGram (статический разбор через AST).
• Рантайм-хелперы, импортируемые из плагина: безопасные импорты SDK с заглушками для офлайн-тестов, утилиты потоков, хуков и настроек.
• Деплой на устройство через ADB и перезагрузка плагина.

Требования

• Python 3.11 и новее (соответствует среде Chaquopy внутри exteraGram).

Установка

pip install catalib

Документация

Полное руководство пользователя (GitBook) — в каталоге book/, точка входа book/README.md: установка, быстрый старт, руководство, CLI, деплой, внутреннее устройство, примеры, решение проблем, публикация в PyPI и настройка GitBook.

Внутренняя проектная документация (архитектура, ADR, планы) — в каталоге docs/.

Лицензия

MIT. См. файл LICENSE.