Использование как библиотеки

Вызов elemctl из кода на Python и формат сборки, который он собирает.

Использование как библиотеки

from elemctl import Config, ElementClient
from elemctl.deploy import deploy_from_sources

client = ElementClient(Config.from_env())
apps = client.list_apps()

report = deploy_from_sources(
    client,
    app_id="...",
    project_id="...",
    project_dir="acme/crm",
    log=print,
)
assert report.ok, report.problems

list_apps() отдаёт живые приложения. Удалённые остаются в перечне платформы со статусом Deleted, и на стенде, живущем не первый месяц, их сотни. За полным перечнем ходят с include_deleted=True. list_apps_counted() возвращает тот же список в поле items и добавляет счётчики, о которых сообщают CLI и инструмент MCP: total, live и shown.

Проверить компиляцию, не трогая рабочее приложение, можно тем же циклом, что выполняет команда probe:

from elemctl.probe import probe_project

report = probe_project(client, project_dir="acme/crm", log=print)
for error in report.errors:
    print(f"{error['file']}:{error['line']}:{error['column']} {error['message']}")
assert report.ok, report.messages

Формат сборки

.xasm для приложения и .xlib для библиотеки – это ZIP-архив:

Assembly.yaml            # манифест: ProjectKind, Vendor, Name, Version, ...
{vendor}/{name}/...      # файлы проекта: .yaml, .xbsl, ресурсы

Каталог проекта должен лежать по схеме {repo}/{vendor}/{name}/Проект.yaml, потому что пути в архиве строятся от корня репозитория. Приложение это или библиотека, говорит поле ВидПроекта в Проект.yaml. Если приложение ссылается на библиотеки, исходные проекты которых лежат под тем же корнем репозитория, их файлы попадают в архив приложения сами, вместе с транзитивными локальными зависимостями. Библиотека, на которую ссылка есть, а локально её нет, остаётся внешней зависимостью платформы.