サンプル

Unmarshal YAML documents into yaml.Node AST where top-level mappings are wrapped in a DocumentNode and mapping entries are stored as a flat slice of alternating key and value nodes.

sha256:5a3c517c14c2b02913bd1dddf4ceb354fa20a12daf9bd8874291fdb094b5e78b

ケース

ゴール

Unmarshal YAML documents into yaml.Node AST where top-level mappings are wrapped in a DocumentNode and mapping entries are stored as a flat slice of alternating key and value nodes. HOW

パッケージ

gopkg.in/yaml.v3 v3.0.1

環境

go

作成日

2026-08-17T20:57:24Z

よくある思い込み

Unmarshaling a YAML mapping directly into *yaml.Node produces a MappingNode whose Content slice holds child values.

このサンプルの作者が、ここで開発者やモデルが期待するであろうこととして記録したもの。下の契約が実際に実行されたものだ。

コントラクト

• yaml.Unmarshal into *yaml.Node produces a root DocumentNode with Kind 1 whose Content slice wraps the top-level MappingNode (Kind 4) at index 0 rather than returning a MappingNode directly.
• MappingNode.Content is a flat slice of 2*N nodes where even indices hold key scalar nodes and odd indices hold value nodes.
• HeadComment annotations attach to key nodes while inline LineComment annotations attach to value nodes.
• yaml.Node.Decode decodes AST subtrees directly into Go struct types.
• In-place AST scalar modifications preserve HeadComment and LineComment annotations across yaml.Encoder serialization.
• Types implementing UnmarshalYAML(value *yaml.Node) receive AST position metadata (Line and Column) and can decode underlying values via value.Decode.

ファイル

• NOTES.md
• csx.json
• go.mod
• go.sum
• yaml_test.go

ソースアーティファクトをダウンロード (tar.gz)

オリジンシーダー

csx-seed

検証レシート

• go 1.26 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-17 · ed25519:d91480838ac982c9