Aggrega Wasm 파서 소켓 스키마
자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.
스키마 ID: https://aggrega.ai/schemas/wasm-parse-v1beta1.schema.json
파서 플러그인 소켓이 소비하는(ParseInput) 와이어 형태와 내보내는(ParseOutput) 와이어 형태입니다. 파서는 상태가 없고 부작용이 없는 변환기로, 외부 텍스트 표현을 정규화된 구조적 JSON 트리로 변환하므로 어떤 언어의 어떤 소비자든 자체 언어 파서 없이 트리를 읽을 수 있습니다. 파서는 처리하는 형식을 디스크립터에 parse:
다음 형태 중 하나
ParseInputParseOutput
정의
ParseInput
파서 게스트가 받는 페이로드입니다. 바이트를 읽는 방식을 선택하는 형식 이름, 파싱할 소스 바이트, 그리고 소비자가 파서별 동작을 위해 제공하는 선택적 불투명 옵션 문서로 구성됩니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
format | string | 예 | 파싱할 소스 형식의 이름으로, 파서가 알린 parse: |
bytes | string | 예 | 파싱할 소스 바이트입니다. 각 키트는 이를 자체 필드 타입으로 담습니다. 그 타입이 바이트 타입이면 원시 형태로, 문자열이면 base64로 인코딩되어 파서가 디코딩해 복원합니다. 생성된 인코더는 필드와 와이어가 바이트를 담는 형태 사이를 변환합니다. 파서는 복원된 바이트를 지정된 형식으로 읽습니다. |
options | any | 아니요 | 소비자가 파서별 동작을 위해 제공하는 불투명 옵션 문서입니다. 호스트는 이를 해석하지 않고 그대로 전달하며, 파서는 자신이 문서화한 형태를 읽습니다. 소비자가 옵션을 제공하지 않으면 없습니다. |
추가 속성은 허용되지 않습니다.
ParseOutput
파서 게스트가 반환하는 페이로드입니다. 파싱된 소스의 정규화된 구조적 트리와 함께, 파싱 중 발생한 진단과 트리 노드를 원본 바이트 위치로 연결하는 소스 범위를 담습니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
tree | any | 예 | 파싱된 소스의 정규화된 구조적 뷰로, JSON 문서입니다. 여기서 “JSON 문서”는 파서가 생성하는 값의 형태, 즉 파싱의 본질을 가리키며, 값이 전송되는 인코딩을 가리키지 않습니다. 이 소켓이 어떤 와이어로 트리를 전달하든 트리는 JSON 문서입니다. 최상위는 파싱된 문서 자체의 형태에 따라 객체, 배열, 스칼라 중 하나일 수 있습니다(예를 들어 JSON 파일은 이 중 어느 것으로든 파싱될 수 있습니다). 호스트는 트리를 불투명하게 전달하며, 내용을 해석하지 않고 그대로 담습니다. |
diagnostics | Diagnostic[] | 아니요 | 파싱 중 발생한 진단입니다(예: 구문 오류 또는 경고). 파싱이 진단을 생성하지 않았으면 없습니다. |
spans | NodeSpan[] | 아니요 | 트리 노드를 원본 바이트에서의 위치로 연결하는 소스 범위로, 소비자가 트리 노드에 대한 결과를 소스 위치에 대응시킬 수 있게 합니다. 파서가 범위를 보고하지 않으면 없습니다. |
error | string | 아니요 | 게스트가 실행되었지만 작업을 완료하지 못했을 때 설정되는 실패 메시지이며, 성공 시에는 없습니다. 출력이 담는 진단과는 구별됩니다. 진단은 결과를 생성한 실행 중에 발견된 문제를 보고하는 반면, error는 작업 자체가 완료되지 않았음을 보고합니다. 호스트는 error가 있으면 플러그인 호출 실패로 표시합니다. |
추가 속성은 허용되지 않습니다.
NodeSpan
하나의 트리 노드에 대한 소스 범위입니다. 트리 안에서 노드를 가리키는 RFC 6901 JSON Pointer와, 원본 바이트에서 노드의 위치를 나타내는 범위로 구성됩니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
pointer | string | 예 | 트리를 가리키는 RFC 6901 JSON Pointer로, 이 범위가 위치를 나타내는 노드를 지정합니다. |
span | SourceSpan | 예 | 지정된 노드의 원본 바이트 내 위치를 나타내는 범위입니다. |
추가 속성은 허용되지 않습니다.
SourceSpan
원본 소스 바이트의 범위입니다. 바이트 오프셋이 기본이자 정확한 위치이며, 줄 번호와 열 번호는 사람이 읽을 수 있는 진단을 위해 함께 제공됩니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
start_offset | integer | 예 | 원본 소스에서 범위의 첫 바이트의 바이트 오프셋으로, 0부터 시작합니다. |
end_offset | integer | 예 | 원본 소스에서 범위의 마지막 바이트 바로 다음의 바이트 오프셋으로, end_offset에서 start_offset을 뺀 값이 범위의 바이트 길이입니다. |
start_line | integer | 예 | 사람이 읽을 수 있는 진단을 위한, 범위 시작의 줄 번호로, 1부터 시작합니다. |
start_column | integer | 예 | 사람이 읽을 수 있는 진단을 위한, 범위 시작의 열 번호로, 1부터 시작합니다. |
end_line | integer | 예 | 사람이 읽을 수 있는 진단을 위한, 범위 끝의 줄 번호로, 1부터 시작합니다. |
end_column | integer | 예 | 사람이 읽을 수 있는 진단을 위한, 범위 끝의 열 번호로, 1부터 시작합니다. |
추가 속성은 허용되지 않습니다.
ParseSourceResponse
parse-source 호스트 함수의 응답입니다. 성공 시에는 확인된 파서가 생성한 정규화된 구조적 트리를, 실패 시에는 오류 메시지를 담습니다. 두 필드 중 정확히 하나만 채워집니다. 실패는 트랩이 아니라 대역 내로 전달되므로, 소비자 게스트는 파서 없음이나 파싱 실패를 결정적 실패로서 자체 진단에 반영합니다. 이는 소비자 소켓이 호스트를 통해 생산자를 실행하도록 호스트에 요청할 때 받는 봉투이며, 요청 페이로드는 ParseInput입니다.
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
tree | any | 아니요 | 성공 시 확인된 파서가 생성한 정규화된 구조적 트리로, 그대로 담긴 JSON 문서입니다. 실패 시에는 없습니다. 파싱 출력 자체의 트리와 마찬가지로 “JSON 문서”는 값이 전송되는 인코딩이 아니라 값의 형태를 가리킵니다. |
error | string | 아니요 | 실패 시의 실패 메시지로, 형식과 원인을 명시합니다. 성공 시에는 없습니다. |
hostfunc_error_code | string (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" |
추가 속성은 허용되지 않습니다.