ruamel.yaml.base 0.3.2

具有保存、延迟加载和可选版本支持的YAMLBase类

YAMLBase类使用基于文件名的路径（pathlib.Path）或字符串初始化，该文件包含一个YAML文件。除非提供了< span class="docutils literal">create_ok参数，否则此文件必须存在，否则将创建参数的实例（通常是类似列表或字典的对象）作为数据结构中的根。如果参数为True，则创建一个空的ruamel.yaml.CommentedMap()实例作为根。

通过.data属性访问根对象，如果指定了现有文件，则在首次访问.data时读取它。

from ruamel.yaml.base import YAMLBase

file_name = '/data0/talks/meta.yaml'

base = YAMLBase(file_name, create_ok=True)
base.data['PyCon 2006'] = dict(location='Dallas, TX, USA', title='Extending the life of CVS with Python')
base.data['EuroPython 2016'] = dict(location='Bilbao, Spain', title='Beyond scraping')
base.changed = True
base.save()
print(open(file_name).read())

打印内容

PyCon 2006:
  location: Dallas, TX, USA
  title: Extending the life of CVS with Python
EuroPython 2016:
  location: Bilbao, Spain
  title: Beyond scraping

文档通常使用ruamel.yaml的默认往返模式加载。如果通过.fast_data访问现有文档，则通过较快的C加载器（不完全是YAML 1.2兼容）进行加载。在这种情况下，不应保存生成的文件。

除非.changed设置为True，否则save实际上不会转储YAML文档文件。将文件保存到文件会将.changed重置为False。使用force=True将独立于changed写入文件。您还可以添加额外的out参数，例如，在上面的示例的最后两行中，您可以这样做：

import sys
base.save(out=sys.stdout)  # not changing `.changed`
base.save()

class X(YAMLBase):
    def __init__(self, path):
        self._create_ok = True
        self._auto_save = True
        super().__init__(path=path)