APIDev

APIDev — CLI-инструмент для контрактной разработки API. Он помогает держать YAML-контракты, сгенерированный transport layer и OpenAPI-описание в синхронном состоянии.

Установка

npm i -g @ai-devtools/apidev

После установки доступна команда:

apidev --help

Для чего нужен APIDev

• описывать API-операции в едином contract format;
• проверять контракты перед генерацией;
• смотреть план изменений без записи файлов;
• генерировать предсказуемые Python-артефакты transport layer;
• использовать apidev gen --check как CI-gate против drift между контрактами и сгенерированным кодом.

Основные команды

apidev init
apidev validate
apidev diff
apidev gen
apidev gen --check

Как устроена npm-установка

Пакет @ai-devtools/apidev устанавливает команду apidev и автоматически подтягивает platform package для текущей ОС и архитектуры.

Поддерживаемые runtime packages:

• @ai-devtools/apidev-linux-x64;
• @ai-devtools/apidev-macos-arm64;
• @ai-devtools/apidev-windows-x64.

Пакет @ai-devtools/apidev-macos-arm64-onedir публикуется отдельно как дополнительный release target и не выбирается root shim по умолчанию.