在 YAML 中引用的唯一方法是使用 &(锚点)和 *(别名)。为了使它们起作用,它们必须在同一个 YAML 文档中。以下将不起作用(这是基于merge key 功能,但普通对象引用具有相同的限制):
import ruamel.yaml
yaml_str = """\
a: &BASE { x: 1, y: 2}
---
b:
<< : *BASE
z: 3
"""
for data in ruamel.yaml.load_all(yaml_str):
print(data)
抛出未找到“BASE”的作曲家错误。删除--- 文档分隔符,一切都很好。
所以原则上连接两个文档是可行的。如果不将其与包含它的文档连接起来,就无法单独加载具有别名的文档。
另外需要注意的是,所有文档都必须在顶层具有映射或序列。如果会组合一个序列:
- &BASE a
- b
带有映射:
c: 1
d: *BASE
结果将无法加载。
如前所述,如果所有文件的顶级类型相同,则无法加载 YAML 文件并将它们组合到内存中。 IE。鉴于合并密钥文档中的示例拆分为1.yaml:
- &CENTER { x: 1, y: 2 }
- &LEFT { x: 0, y: 2 }
- &BIG { r: 10 }
- &SMALL { r: 1 }
2.yaml:
# Explicit keys
-
x: 1
y: 2
r: 10
label: center/big
3.yaml:
# Merge one map
-
<< : *CENTER
r: 10
label: center/big
4.yaml:
# Merge multiple maps
-
<< : [ *CENTER, *BIG ]
label: center/big
5.yaml:
# Override
-
<< : [ *BIG, *LEFT, *SMALL ]
x: 1
label: center/big
您不能在单个 YAML 文件上使用 load() 并将它们组合起来:
import ruamel.yaml
import glob
data = []
for file_name in sorted(glob.glob('*.yaml')):
data.append(ruamel.yaml.load(open(file_name)))
print(ruamel.yaml.dump(data, allow_unicode=True))
(如果2.yaml 等没有别名,上述方法将起作用)
如果您不想在程序之外连接文件,您可以
使用这个类:
class CombinedOpenForReading(object):
def __init__(self, file_names):
self._to_do = file_names[:]
self._fp = None
def __enter__(self):
return self
def __exit__(self, exception_type, exception_value, exception_traceback):
if self._fp:
self._fp.close()
def read(self, size=None):
res = ''
while True:
if self._fp is None:
if not self._to_do:
return res
else:
self._fp = open(self._to_do.pop(0))
if size is None:
data = self._fp.read()
else:
data = self._fp.read(size)
if size is None or not data:
self._fp.close()
self._fp = None
res += data
if size is None:
continue
size -= len(data)
if size == 0:
break
return res
要做的事情:
import ruamel.yaml
import glob
with CombinedOpenForReading(sorted(glob.glob('*.yaml'))) as fp:
data = ruamel.yaml.round_trip_load(fp)
assert data[6]['r'] == 10
print(ruamel.yaml.dump(data, Dumper=ruamel.yaml.RoundTripDumper))
得到:
- &CENTER {x: 1, y: 2}
- &LEFT {x: 0, y: 2}
- &BIG {r: 10}
- &SMALL {r: 1}
# Explicit keys
- x: 1
y: 2
r: 10
label: center/big
# Merge one map
- <<: *CENTER
r: 10
label: center/big
# Merge multiple maps
- <<: [*CENTER, *BIG]
label: center/big
# Override
- <<: [*BIG, *LEFT, *SMALL]
x: 1
label: center/big
(您必须按正确的顺序提交文件,从而进行排序。并确保文件末尾有换行符,否则可能会出现意外错误。)