III.1 Команды
| Команда | Назначение |
|---|---|
oxl new <имя> [--template service|lib|cli] | новый пакет |
oxl build [--profile p] [--target t] [--image ref] [--static] | сборка; --image — OCI-образ; --static — полностью статический бинарник |
oxl run [--profile p] [флаги рантайма] | сборка и запуск одного узла |
oxl dev [--nodes n] [--roles r1,r2] | локальный кластер с перезагрузкой при изменении кода |
oxl test [пути] [флаги отбора] | тесты (§III.9) |
oxl check | проверка типов и анализ без генерации кода |
oxl fmt [--check] | каноническое форматирование |
oxl fix [пути] [--dry-run] [--only коды] [--except коды] | применить пакетом быстрые исправления диагностик (те, что языковой сервер предлагает для диагностики); --dry-run печатает унифицированный diff и завершается кодом 1, если есть что исправлять; 3 — синтаксические ошибки (ничего не изменено) |
oxl doc [--open] | документация из /// |
oxl add <dep>[@версия], oxl remove, oxl update | зависимости |
oxl publish | публикация в реестр с проверкой SemVer и схем |
oxl yank [<имя>@]<версия> [--undo] | пометить опубликованную версию отозванной: резолвер её заново не выбирает, существующие oxl.lock продолжают работать |
oxl export --proto|--openapi | схемы для других языков |
oxl gen --ts|--py|--go|--kotlin|--cpp | клиенты |
oxl db diff|migrate|rollback | миграции ORM |
oxl access diff|who-can <метод> | анализ прав |
oxl config get|set|history|rollback | динамический конфиг кластера |
oxl ab start|stop|status <имя> | A/B-эксперименты |
oxl debug [attach <адрес>|--node <id>] | отладчик (§III.7) |
oxl inspect --cluster <адрес> | веб-интерфейс к работающему кластеру (§III.8) |
oxl trace <traceId>, oxl replay <traceId> | трасса запроса, повтор из журнала |
oxl prof cpu|heap|tasks --node <id> | профилировщик |
oxl keys rotate, oxl storage snapshot|restore | ключи и хранилище |
Коды завершения oxl: 0 — успех, 1 — ошибка программы или упавшие тесты, 2 — неверные аргументы, 3 — ошибка компиляции, 78 — ошибка конфигурации.
Определяется реализацией. Образы и состав команд (D-8056; DIV-045; HANDOFF §3). Таблица команд — требование к набору; фактический состав, флаги и коды возврата реализации выводит
oxl help(иoxl help --json).oxl build --imageв этой реализации строит OCI-образ, но не публикует его в реестр (push нет) (--imageстатическую линковку не включает); полностью статический бинарник строитoxl build --static(glibc, libstdc++ и библиотеки рантайма внутри; разрешение имён иdlopenведут себя так, как документирует glibc) (D-8063; D-7703).
Связанные диагностики
Исходник: docs/spec/oxl-standard.md