解析 YAML

import pyrs_yaml

doc = pyrs_yaml.parse("key: value")  # (1)!
print(doc.get("key"))  # value

# 禁用合并键解析（保留 <<: *alias 原样）
doc = pyrs_yaml.parse(yaml_text, resolve_merges=False)

doc = pyrs_yaml.parse_file("config.yaml")
print(doc.get("name"))

# 使用 --- 分隔的 YAML
yaml_text = """
---
name: first
---
name: second
"""

docs = pyrs_yaml.parse_all_docs(yaml_text)
print(len(docs))  # 2
print(docs[0].get("name"))  # first
print(docs[1].get("name"))  # second

# 返回原生 Python 类型（dict, list, str, int 等）
data = pyrs_yaml.safe_load("key: value")
print(data)  # {'key': 'value'}

# 多个文档
docs = pyrs_yaml.safe_loads("a: 1\n---\nb: 2")
print(len(docs))  # 2

try:
    doc = pyrs_yaml.parse("invalid: yaml: [")
except pyrs_yaml.YamlParseError as e:
    print(f"解析错误: {e}")