Openclaw용 go-asyncapi

1. Go 도구 체인이 설치되어 있는지 확인합니다.

go version

2. 현재 Go 모듈에 라이브러리를 추가합니다.

go get github.com/psyb0t/go-asyncapi

3. 패키지를 가져오고 AsyncAPI 3 문서를 로드합니다.

import (
    "fmt"

    asyncapi "github.com/psyb0t/go-asyncapi"
)

document, err := asyncapi.Load("asyncapi.yaml")
if err != nil {
    return err
}

for _, server := range document.Servers {
    fmt.Println(server.Name, server.URL())
}

4. 통합을 빌드하고 테스트합니다.

go build ./...
go test ./...

5. 참조 파일을 사양에 지정된 상대 경로에 유지합니다. 이 라이브러리는 진입 문서와 로컬 상대 $ref 대상을 읽고 아무것도 쓰지 않으며, 원격 http(s) 참조는 가져오지 않고 거부합니다. AsyncAPI 2.x 문서는 지원되지 않으며 거부됩니다.

로드된 문서는 다음 주요 구조를 중심으로 구성됩니다.

Schema 데이터는 정렬된 *asyncapi.Object 트리로 보존됩니다. 페이로드 및 헤더 schema는 객체, 기본형, 불리언, oneOf, allOf 및 기타 schema 형식을 나타낼 수 있습니다. Object("properties")와 같은 객체 헬퍼를 사용해 탐색할 때는 각 schema의 Location을 보존합니다.

일반적인 schema 탐색 흐름은 다음과 같습니다.

• document.Resolver.Deref(message.Payload, message.PayloadAt)을 호출합니다.
• 결과가 *asyncapi.Object인지 확인합니다. 불리언 schema일 수도 있습니다.
• 객체 트리에서 정렬된 속성을 가져옵니다.
• 속성 값과 at.Child("properties").Child(name)으로 만든 하위 위치를 사용해 각 속성을 해석합니다.
• 올바른 소스 파일을 기준으로 중첩 $ref 값을 해석할 수 있도록 위치를 계속 전달합니다.

이 라이브러리는 생성된 파일을 쓰지 않고, 전체 JSON Schema 유효성 검사를 수행하지 않으며, 원격 참조를 가져오지 않습니다. 오류는 안정적으로 분류할 수 있도록 ctxerrors/commerr sentinel 값을 래핑합니다.