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

Схема сокета парсера Aggrega Wasm

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

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

Формы данных, которые сокет плагина-парсера принимает (ParseInput) и выдаёт (ParseOutput). Парсер — это преобразователь без состояния и без побочных эффектов, который превращает стороннее текстовое представление в каноническое структурированное дерево JSON, так что любой потребитель на любом языке может прочитать дерево, не имея собственного парсера этого языка. Парсер объявляет поддерживаемые форматы как возможности parse: в своём дескрипторе; хост передаёт ему байты для разбора и имя формата, а парсер возвращает дерево, а также необязательные диагностики и диапазоны исходного текста. Парсер не придаёт дереву никакого смысла сверх его синтаксиса — компилятор передаёт дерево дальше непрозрачно.

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

  • ParseInput
  • ParseOutput

Определения

ParseInput

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

СвойствоТипОбязательноОписание
formatstringдаИмя исходного формата для разбора, соответствующее одной из заявленных парсером возможностей parse: (например, hcl, toml, yaml или json). Парсер читает байты в этом формате.
bytesstringдаИсходные байты для разбора. Каждый набор хранит их в поле собственного типа — в сыром виде, если этот тип байтовый, и в кодировке base64, если это строка, которую парсер декодирует, чтобы восстановить байты, — а сгенерированный кодировщик выполняет преобразование между полем и формой, в которой байты передаются по проводу. Парсер читает восстановленные байты в указанном формате.
optionsлюбойнетНепрозрачный документ параметров, который потребитель передаёт для поведения, специфичного для парсера. Хост передаёт его дальше, не интерпретируя; парсер читает ту форму, которую он документирует. Отсутствует, если потребитель не передаёт параметров.

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

ParseOutput

Полезная нагрузка, которую возвращает гостевой модуль парсера: каноническое структурированное дерево разобранного исходного текста, а также все диагностики, возникшие при разборе, и все диапазоны исходного текста, связывающие узлы дерева с исходными байтами.

СвойствоТипОбязательноОписание
treeлюбойдаКаноническое структурированное представление разобранного исходного текста в виде документа JSON. Здесь «документ JSON» обозначает форму значения, которое выдаёт парсер, — в этом и состоит суть разбора, — а не кодировку, в которой значение передаётся: дерево является документом JSON независимо от того, по какому проводу его передаёт этот сокет. Верхний уровень может быть объектом, массивом или скаляром в соответствии с собственной формой разобранного документа (например, файл JSON может разбираться в любой из них). Хост передаёт дерево дальше непрозрачно, дословно и не интерпретируя его содержимое.
diagnosticsDiagnostic[]нетДиагностики, возникшие при разборе, — например, синтаксическая ошибка или предупреждение. Отсутствует, если разбор не дал ни одной.
spansNodeSpan[]нетДиапазоны исходного текста, связывающие узлы дерева с их положением в исходных байтах, чтобы потребитель мог сопоставить находку в узле дерева с местом в исходном тексте. Отсутствует, если парсер не сообщает диапазонов.
errorstringнетСообщение о сбое, задаваемое, когда гостевой модуль выполнился, но не смог завершить операцию; отсутствует при успехе. Оно отличается от любых диагностик, которые несёт вывод: диагностики сообщают о проблемах, найденных во время выполнения, которое всё же дало результат, а error сообщает, что сама операция не завершилась. Присутствующую ошибку хост представляет как неудачный вызов плагина.

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

NodeSpan

Диапазон исходного текста для одного узла дерева: JSON Pointer по RFC 6901, адресующий узел в дереве, в паре с диапазоном, указывающим его место в исходных байтах.

СвойствоТипОбязательноОписание
pointerstringдаJSON Pointer по RFC 6901 в дерево, адресующий узел, местоположение которого указывает этот диапазон.
spanSourceSpanдаДиапазон, указывающий место адресуемого узла в исходных байтах.

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

SourceSpan

Диапазон исходных байтов: смещения в байтах — основное, точное местоположение, а номера строки и столбца сопровождают их для понятной человеку диагностики.

СвойствоТипОбязательноОписание
start_offsetintegerдаСмещение первого байта диапазона в исходных данных в байтах, отсчёт с нуля.
end_offsetintegerдаСмещение в байтах на единицу дальше последнего байта диапазона в исходных данных, так что end_offset минус start_offset — длина диапазона в байтах.
start_lineintegerдаНомер строки начала диапазона, отсчёт с единицы, для понятной человеку диагностики.
start_columnintegerдаНомер столбца начала диапазона, отсчёт с единицы, для понятной человеку диагностики.
end_lineintegerдаНомер строки конца диапазона, отсчёт с единицы, для понятной человеку диагностики.
end_columnintegerдаНомер столбца конца диапазона, отсчёт с единицы, для понятной человеку диагностики.

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

ParseSourceResponse

Ответ хост-функции parse-source: при успехе — каноническое структурированное дерево, созданное выбранным парсером, при сбое — сообщение об ошибке. Заполнено ровно одно из двух полей. Сбой передаётся внутри ответа, а не через ловушку, так что гостевой модуль-потребитель переносит отсутствие парсера или сбой разбора в собственные диагностики как детерминированный сбой. Это оболочка, которую получает сокет-потребитель, когда просит хост запустить производителя через хост; полезная нагрузка запроса — ParseInput.

СвойствоТипОбязательноОписание
treeлюбойнетКаноническое структурированное дерево, созданное выбранным парсером при успехе, в виде документа JSON, передаваемого дословно; отсутствует при сбое. Как и для собственного дерева вывода разбора, «документ JSON» обозначает форму значения, а не кодировку, в которой оно передаётся.
errorstringнетСообщение о сбое при сбое, указывающее формат и причину; отсутствует при успехе.
hostfunc_error_codestring (enum)нетМашинно сопоставимый идентификатор сбоя при сбое, взятый из закрытого каталога кодов ошибок хост-функций и задаваемый рядом с понятным человеку сообщением об ошибке; отсутствует при успехе. Этот каталог — фиксированный словарь, называющий способы, которыми может завершиться сбоем хост-функция, и он отличается от словаря условий остановки, регистрируемых компилятором, идентификаторы которых гостевой модуль сообщает в выводе сокета как condition_code и condition_short_code, — имя ключа указывает, к какому из двух относится значение, поэтому они никогда не читаются как один набор. Гостевой модуль выбирает ветвь по этому коду, не разбирая сообщение, а при отсутствии кода (более старый хост) или неизвестном коде (более новый хост) возвращается к сообщению. Допустимые значения: "fetch_request_unreadable", "fetch_input_unavailable", "fetch_failed", "request_unreadable", "request_undecodable", "source_root_unavailable", "source_read_failed", "unknown_selection_op", "source_escape", "producer_consumption_reentry", "no_source_parser", "no_parser_for_format", "parse_failed"

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