Ruby Nodes模块用法及代码示例

概述

当使用 Psych.load 反序列化 YAML 文档时，该文档被转换为中间 AST。然后将该中间 AST 转换为 Ruby 对象图。

在相反的方向上，当使用 Psych.dump 时，Ruby 对象图被转换为中间 AST，然后转换为 YAML 文档。

Psych::Nodes 包含构成 YAML AST 节点的所有类。您可以手动构建 AST 并使用其中一个访问者(请参阅 Psych::Visitors )将该 AST 转换为 YAML 文档或 Ruby 对象图。

下面是一个构建 AST 的示例，该 AST 表示具有一个标量的列表：

# Create our nodes
stream = Psych::Nodes::Stream.new
doc    = Psych::Nodes::Document.new
seq    = Psych::Nodes::Sequence.new
scalar = Psych::Nodes::Scalar.new('foo')

# Build up our tree
stream.children << doc
doc.children    << seq
seq.children    << scalar

流是树的根。然后我们可以将树转换为 YAML：

stream.to_yaml => "---\n- foo\n"

或者将其转换为 Ruby：

stream.to_ruby => [["foo"]]

YAML AST 要求

一个有效的 YAML AST 必须在根中有一个 Psych::Nodes::Stream 。 Psych::Nodes::Stream 节点必须有 1 个或多个 Psych::Nodes::Document 节点作为子节点。

Psych::Nodes::Document 节点必须有一个且只有一个子节点。那个孩子可能是以下之一：

• Psych::Nodes::Sequence

• Psych::Nodes::Mapping

• Psych::Nodes::Scalar

Psych::Nodes::Sequence 和 Psych::Nodes::Mapping 节点可能有很多子节点，但 Psych::Nodes::Mapping 节点应该有偶数个子节点。

所有这些都是 Psych::Nodes::Sequence 和 Psych::Nodes::Mapping 节点的有效子节点：

• Psych::Nodes::Sequence

• Psych::Nodes::Mapping

• Psych::Nodes::Scalar

• Psych::Nodes::Alias

Psych::Nodes::Scalar 和 Psych::Nodes::Alias 都是终端节点，不应有任何子节点。