なぜPyYAMLはジェネレータを使ってオブジェクトを構築しますか？

Question

私はadd_constructorで追加できる適切なコンストラクタ関数を定義する方法を理解するために、PyYAMLソースコードを読んできました。私はそのコードが今どのように動作しているかをよく理解していますが、なぜSafeConstructorのデフォルトのYAMLコンストラクタがジェネレータであるのか理解できません。例えば、方法SafeConstructorのconstruct_yaml_map：

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

私はオブジェクトをスタブのみdeep=Falseがconstruct_mappingに渡された場合、ノードからデータを移入するために次のように発電機がBaseConstructor.construct_objectに使用される方法を理解する。

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

BaseConstructor.construct_documentのデータはdeep=Falseの場合、construct_mappingの場合はどのように生成されるのか分かります。私は理解していない何

def construct_document(self, node): 
    data = self.construct_object(node) 
    while self.state_generators: 
     state_generators = self.state_generators 
     self.state_generators = [] 
     for generator in state_generators: 
      for dummy in generator: 
       pass 

は、データオブジェクトをスタブとconstruct_documentに発電機を反復して、オブジェクトを下に作業の利益です。これはYAML仕様の中で何かをサポートするために行わなければならないのですか、それともパフォーマンス上の利点をもたらしますか？

This answer on another questionはやや役立ったが、私はその答えは、このない理由を理解していない。これに代えて

def foo_constructor(loader, node): 
    instance = Foo.__new__(Foo) 
    yield instance 
    state = loader.construct_mapping(node, deep=True) 
    instance.__init__(**state) 

：

def foo_constructor(loader, node): 
    state = loader.construct_mapping(node, deep=True) 
    return Foo(**state) 

を、私は後者の形式は、のために働くことをテストしてみました例はその他の答えに掲載されていますが、おそらく私はいくつかの端の場合がありません。

PyYAMLのバージョン3.10を使用していますが、問題のコードがPyYAMLの最新バージョン（3.12）で同じであるようです。

Answer 1

YAMLにはanchors and aliasesがあります。これにより、直接的または間接的に自己参照構造を作ることができます。

YAMLにこのような自己参照の可能性がない場合は、最初にすべての子を構築してから、一度に親構造を作成することができます。しかし、自己参照のために、作成している構造をまだ "記入"していない可能性があります。ジェネレータの2ステッププロセスを使用すると（メソッドの最後に来る前に1歩だけしかないので、この2つのステップを呼び出します）、オブジェクトを部分的に作成し、自己参照オブジェクトが存在する（すなわち、メモリ内の場所が定義されている）ためです。

利点はスピードではなく、純粋に自己参照を可能にするためです。

あなたがビットを参照してください答えは、以下の負荷からの例を簡素化する場合：

import sys 
import ruamel.yaml as yaml 


class Foo(object): 
    def __init__(self, s, l=None, d=None): 
     self.s = s 
     self.l1, self.l2 = l 
     self.d = d 


def foo_constructor(loader, node): 
    instance = Foo.__new__(Foo) 
    yield instance 
    state = loader.construct_mapping(node, deep=True) 
    instance.__init__(**state) 

yaml.add_constructor(u'!Foo', foo_constructor) 

x = yaml.load(''' 
&fooref 
!Foo 
s: *fooref 
l: [1, 2] 
d: {try: this} 
''', Loader=yaml.Loader) 

yaml.dump(x, sys.stdout) 

しかし、あなたがfoo_constructor()を変更した場合：

def foo_constructor(loader, node): 
    instance = Foo.__new__(Foo) 
    state = loader.construct_mapping(node, deep=True) 
    instance.__init__(**state) 
    return instance 

（収率は削除、最後のを追加しました返信）、ConstructorError：メッセージとして

found unconstructable recursive node 
    in "<unicode string>", line 2, column 1: 
    &fooref 

PyYAMLにも同様のメッセージが表示されます。そのエラーのトレースバックを調べると、ruamel.yaml/PyYAMLがソースコードのエイリアスを解決しようとしている場所がわかります。