Перейти к содержимому
AggregaAggrega
Выберите язык: Русский
Эта страница переведена машинным способом. Читать оригинал на английском.

Схема сокета Aggrega Wasm CLI

Сгенерированный справочник. Не редактируйте вручную — сгенерируйте заново из опубликованной JSON Schema.

Идентификатор схемы: https://aggrega.ai/schemas/wasm-cli-v1beta1.schema.json

Формат передачи данных, который принимает CLI-плагин (CLIRunInput). CLI-плагин расширяет набор команд инструмента командной строки aggrega: хост сопоставляет подкоманду с гостевым модулем Wasm и передаёт ему вектор аргументов вызова; гостевой модуль выполняется и возвращает код завершения процесса в качестве своего целочисленного возвращаемого значения. Стандартный вывод и стандартный поток ошибок передаются через функции хоста, а не через полезную нагрузку, поэтому этот сокет объявляет только формат входных данных. Тип полезной нагрузки для Go, Rust и TypeScript генерируется из этой схемы в пакеты plugin-ABI, поэтому все три языка читают и записывают одни и те же передаваемые данные; гостевой модуль импортирует его из этих пакетов или через свой набор для разработки плагинов, который его реэкспортирует.

Одна из следующих форм

  • CLIRunInput

Определения

CLIRunInput

Полезная нагрузка, которую хост передаёт CLI-плагину при каждом вызове: вектор аргументов, следующих за именем найденной подкоманды. Гостевой модуль разбирает эти токены как собственные флаги и позиционные аргументы — точно так же, как отдельная программа командной строки читает аргументы, следующие за её именем.

СвойствоТипОбязательноОписание
commandstringдаИмя найденной подкоманды, которой хост передал этот вызов. Плагин, добавляющий несколько команд, выбирает по этому имени нужное поведение; плагин с одной командой получает здесь имя своей команды. Хост определяет имя по командной строке до вызова гостевого модуля и передаёт его без изменений.
argsstring[]даВектор аргументов, который получает гостевой модуль, в порядке вызова — токены, следующие в командной строке за именем найденной подкоманды. Порядок сохраняется, поэтому полезная нагрузка побайтно идентична между запусками с одинаковыми входными данными.

Дополнительные свойства не допускаются.