콘텐츠로 이동
AggregaAggrega
언어 선택: 한국어
이 페이지는 기계 번역되었습니다. 영어 원문 읽기.

Aggrega Wasm 파서 소켓 스키마

자동 생성된 레퍼런스입니다. 직접 편집하지 말고 게시된 JSON Schema에서 다시 생성하십시오.

스키마 ID: https://aggrega.ai/schemas/wasm-parse-v1beta1.schema.json

파서 플러그인 소켓이 소비하는(ParseInput) 와이어 형태와 내보내는(ParseOutput) 와이어 형태입니다. 파서는 상태가 없고 부작용이 없는 변환기로, 외부 텍스트 표현을 정규화된 구조적 JSON 트리로 변환하므로 어떤 언어의 어떤 소비자든 자체 언어 파서 없이 트리를 읽을 수 있습니다. 파서는 처리하는 형식을 디스크립터에 parse: 기능으로 선언합니다. 호스트는 파싱할 바이트와 형식 이름을 파서에 전달하고, 파서는 트리와 함께 선택적으로 진단과 소스 범위를 반환합니다. 파서는 트리에 구문 이상의 의미를 부여하지 않으며, 컴파일러는 트리를 불투명하게 그대로 전달합니다.

다음 형태 중 하나

  • ParseInput
  • ParseOutput

정의

ParseInput

파서 게스트가 받는 페이로드입니다. 바이트를 읽는 방식을 선택하는 형식 이름, 파싱할 소스 바이트, 그리고 소비자가 파서별 동작을 위해 제공하는 선택적 불투명 옵션 문서로 구성됩니다.

속성타입필수설명
formatstring예파싱할 소스 형식의 이름으로, 파서가 알린 parse: 기능 중 하나와 일치합니다(예: hcl, toml, yaml, json). 파서는 바이트를 이 형식으로 읽습니다.
bytesstring예파싱할 소스 바이트입니다. 각 키트는 이를 자체 필드 타입으로 담습니다. 그 타입이 바이트 타입이면 원시 형태로, 문자열이면 base64로 인코딩되어 파서가 디코딩해 복원합니다. 생성된 인코더는 필드와 와이어가 바이트를 담는 형태 사이를 변환합니다. 파서는 복원된 바이트를 지정된 형식으로 읽습니다.
optionsany아니요소비자가 파서별 동작을 위해 제공하는 불투명 옵션 문서입니다. 호스트는 이를 해석하지 않고 그대로 전달하며, 파서는 자신이 문서화한 형태를 읽습니다. 소비자가 옵션을 제공하지 않으면 없습니다.

추가 속성은 허용되지 않습니다.

ParseOutput

파서 게스트가 반환하는 페이로드입니다. 파싱된 소스의 정규화된 구조적 트리와 함께, 파싱 중 발생한 진단과 트리 노드를 원본 바이트 위치로 연결하는 소스 범위를 담습니다.

속성타입필수설명
treeany예파싱된 소스의 정규화된 구조적 뷰로, JSON 문서입니다. 여기서 “JSON 문서”는 파서가 생성하는 값의 형태, 즉 파싱의 본질을 가리키며, 값이 전송되는 인코딩을 가리키지 않습니다. 이 소켓이 어떤 와이어로 트리를 전달하든 트리는 JSON 문서입니다. 최상위는 파싱된 문서 자체의 형태에 따라 객체, 배열, 스칼라 중 하나일 수 있습니다(예를 들어 JSON 파일은 이 중 어느 것으로든 파싱될 수 있습니다). 호스트는 트리를 불투명하게 전달하며, 내용을 해석하지 않고 그대로 담습니다.
diagnosticsDiagnostic[]아니요파싱 중 발생한 진단입니다(예: 구문 오류 또는 경고). 파싱이 진단을 생성하지 않았으면 없습니다.
spansNodeSpan[]아니요트리 노드를 원본 바이트에서의 위치로 연결하는 소스 범위로, 소비자가 트리 노드에 대한 결과를 소스 위치에 대응시킬 수 있게 합니다. 파서가 범위를 보고하지 않으면 없습니다.
errorstring아니요게스트가 실행되었지만 작업을 완료하지 못했을 때 설정되는 실패 메시지이며, 성공 시에는 없습니다. 출력이 담는 진단과는 구별됩니다. 진단은 결과를 생성한 실행 중에 발견된 문제를 보고하는 반면, error는 작업 자체가 완료되지 않았음을 보고합니다. 호스트는 error가 있으면 플러그인 호출 실패로 표시합니다.

추가 속성은 허용되지 않습니다.

NodeSpan

하나의 트리 노드에 대한 소스 범위입니다. 트리 안에서 노드를 가리키는 RFC 6901 JSON Pointer와, 원본 바이트에서 노드의 위치를 나타내는 범위로 구성됩니다.

속성타입필수설명
pointerstring예트리를 가리키는 RFC 6901 JSON Pointer로, 이 범위가 위치를 나타내는 노드를 지정합니다.
spanSourceSpan예지정된 노드의 원본 바이트 내 위치를 나타내는 범위입니다.

추가 속성은 허용되지 않습니다.

SourceSpan

원본 소스 바이트의 범위입니다. 바이트 오프셋이 기본이자 정확한 위치이며, 줄 번호와 열 번호는 사람이 읽을 수 있는 진단을 위해 함께 제공됩니다.

속성타입필수설명
start_offsetinteger예원본 소스에서 범위의 첫 바이트의 바이트 오프셋으로, 0부터 시작합니다.
end_offsetinteger예원본 소스에서 범위의 마지막 바이트 바로 다음의 바이트 오프셋으로, end_offset에서 start_offset을 뺀 값이 범위의 바이트 길이입니다.
start_lineinteger예사람이 읽을 수 있는 진단을 위한, 범위 시작의 줄 번호로, 1부터 시작합니다.
start_columninteger예사람이 읽을 수 있는 진단을 위한, 범위 시작의 열 번호로, 1부터 시작합니다.
end_lineinteger예사람이 읽을 수 있는 진단을 위한, 범위 끝의 줄 번호로, 1부터 시작합니다.
end_columninteger예사람이 읽을 수 있는 진단을 위한, 범위 끝의 열 번호로, 1부터 시작합니다.

추가 속성은 허용되지 않습니다.

ParseSourceResponse

parse-source 호스트 함수의 응답입니다. 성공 시에는 확인된 파서가 생성한 정규화된 구조적 트리를, 실패 시에는 오류 메시지를 담습니다. 두 필드 중 정확히 하나만 채워집니다. 실패는 트랩이 아니라 대역 내로 전달되므로, 소비자 게스트는 파서 없음이나 파싱 실패를 결정적 실패로서 자체 진단에 반영합니다. 이는 소비자 소켓이 호스트를 통해 생산자를 실행하도록 호스트에 요청할 때 받는 봉투이며, 요청 페이로드는 ParseInput입니다.

속성타입필수설명
treeany아니요성공 시 확인된 파서가 생성한 정규화된 구조적 트리로, 그대로 담긴 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"

추가 속성은 허용되지 않습니다.