deep=True 在 pyyaml.Loader.construct_mapping 中做什么？

在网上搜索自定义构造函数的用法时，我看到如下内容：

def some_constructor(loader, node):
    value = loader.construct_mapping(node, deep=True)
    return SomeClass(value)

什么是deep=True做？我在中没有看到它pyyaml 文档 http://pyyaml.org/wiki/PyYAMLDocumentation#Loader.

看来我需要它；我有一个由 py​​yaml 表示器生成的 yaml 文件，它包括节点锚点和别名（例如&id003 and *id003）；没有deep=True我得到了包含锚点/别名的那些对象的浅地图。

你看不到的deep=True文档中的 是因为您通常不需要将其用作 PyYAML 包的最终用户。

如果您追踪方法的使用constructor.py那个使用deep=你来construct_mapping() and construct_sequence()在班上BaseConstructor()这两个都调用BaseConstructor.construct_object()。 该方法中要研究的相关代码是：

    if tag_suffix is None:
        data = constructor(self, node)
    else:
        data = constructor(self, tag_suffix, node)
    if isinstance(data, types.GeneratorType):
        generator = data
        data = next(generator)
        if self.deep_construct:
            for dummy in generator:
                pass
        else:
            self.state_generators.append(generator)

特别是for在那里循环，只有在以下情况下才会执行deep=True被传入了。

粗略地说，如果数据来自构造函数是生成器，那么它会遍历该数据（在for循环）直到发电机耗尽。通过该机制，这些构造函数可以包含yield创建一个基础对象，可以在之后填写其详细信息yield。因为他们只是一个人yield在这样的构造函数中，例如用于映射（构造为 Pythondicts):

def construct_yaml_map(self, node):
    data = {}
    yield data
    value = self.construct_mapping(node)
    data.update(value)

我将此称为两步过程（第一步yield方法末尾的旁边。

在这样的两步构造函数中datato be yielded 构造为空，yield 然后填充。之所以如此，是因为您已经注意到了：递归。如果有一个自我引用data下面某处，data无法在其所有子级都构造完成之后再构造，因为它必须等待自身构造完成。

The deep参数间接控制是否递归构建或附加到列表中的潜在生成器的对象self.state_generators稍后再解决。

然后构建 YAML 文档归结为构建顶级对象并循环遍历潜在的递归对象self.state_generators直到没有剩下任何生成器（这一过程可能需要多次传递）。