catalib

Документация: raito-kyokai.gitbook.io/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: https://raito-kyokai.gitbook.io/catalib — установка, быстрый старт, руководство, CLI, деплой, внутреннее устройство, примеры, решение проблем, публикация в PyPI и настройка GitBook.

Исходники документации — в каталоге book/ (синхронизируются с GitBook через Git Sync).

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

Автор

catalyst. Плагины и новости — Telegram-канал @catalystdevplugins.

Лицензия

MIT. См. файл LICENSE.

Metadata

Release files for catalib 0.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for catalib 0.3.3
File	Size	Uploaded
catalib-0.3.3.tar.gz	141.0 kB	May 19, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for catalib 0.3.3
File	Interpreter	ABI	Platform	Reset
catalib-0.3.3-py3-none-any.whl 117.2 kB May 19, 2026	Python 3	none	any	Details

Total release size: 258.2 kB

Release files / catalib-0.3.3.tar.gz

Download URL	catalib-0.3.3.tar.gz
Size	141.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`464539847861ff841b33055049eaffdbc46e0a8d530e936d7ae99eebe28f9ed6`
BLAKE2b-256 checksum How to use checksums	`8478eb2c91f97f823b7df56e83e1bcba248ef88002e7141d269da1680581c703`
Upload date	May 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.12`

Release files / catalib-0.3.3-py3-none-any.whl

Download URL	catalib-0.3.3-py3-none-any.whl
Size	117.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`877b997810d52d51c137e24899c1753e3881d9486b05dde440c53bf04e106d68`
BLAKE2b-256 checksum How to use checksums	`1aa89838327a92090c85733090b9784a18282d1e558997cd091d8dd874cccf1a`
Upload date	May 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.12`