DevGramBuilder

Официальный CLI-сборщик плагинов DevGram. Он создаёт проекты, проверяет исходники и собирает готовые установочные архивы .dgplugin.

Builder охватывает весь процесс разработки: создание проекта, проверку открытых Python-исходников, сборку, watch-режим, ignore-правила, статистику и загрузку через Dev Server. Результат собирается в нативный формат DevGram.

Установка

Из отдельного репозитория:

python -m pip install --upgrade "git+https://github.com/DevGramOfficial/DevGramBuilder.git"
dgb --version

На Windows вместо python можно использовать py -3.

Для локальной разработки Builder:

git clone https://github.com/DevGramOfficial/DevGramBuilder.git
cd DevGramBuilder
python -m pip install -e .

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

mkdir my-plugin
cd my-plugin
dgb new
dgb build -a -v -nf

Готовый пакет появится в builds/<id>-<version>.dgplugin.

Пакет всегда содержит открытые файлы .py: байткод .pyc не собирается и не принимается DevGram.

Остальные команды:

dgb watch 2 --args "-a -v -nf"
dgb add-ignore "assets/source.psd" --all
dgb del-ignore 0 --all
dgb stats files
dgb stats lines
dgb stats size
dgb stats builds
dgb upload --token "ТОКЕН_DEV_SERVER"

Проект хранит настройки в devgram-builder.json, исходники в src/, ресурсы в assets/, переводы в locales/, а локальные wheel-зависимости в wheels/. При сборке Builder создаёт manifest.json в корне архива и проверяет пакет по тем же структурным правилам, которые использует DevGram.

Структура проекта

my-plugin/
├── devgram-builder.json
├── .devgrambuilder/config.json
├── src/main.py
├── assets/
├── locales/
└── wheels/

• devgram-builder.json — имя, ID, версия, автор, точка входа и зависимости.
• src/ — Python-исходники плагина.
• assets/ — изображения и другие ресурсы.
• locales/ — JSON-файлы переводов.
• wheels/ — локальные Python-зависимости в формате .whl.

Полный справочник по API плагинов находится в DevGram Plugin SDK.

Разработка

python -m pip install -e .
python -m unittest discover -s tests -v

Проект распространяется по лицензии MIT.