python - PyYAML 不解析所有示例

Question

我正在尝试理解关于 https://pyyaml.org/wiki/PyYAML 的声明那:

PyYAML features

- a complete YAML 1.1 parser. In particular, PyYAML can parse all 
  examples from the specification. 

如果您转到使用 PyYAML (http://yaml-online-parser.appspot.com/) 的在线 YAML 解析器，那么从规范中获取的几个示例不起作用。

我知道您需要为其中一些失败定义标签，并且在线解析器只能处理单个文档 YAML，我知道在使用 PyYAML 时如何“修复”这个问题。

但是示例 11 也失败了，它没有特殊标签并且是单个文档。 PyYAML 怎么能声称它可以解析所有示例，而它显然不能解析？这是因为 PyYAML 适用于 YAML 1.1 而示例来自 YAML 1.2 规范吗？

Answer 1

从你的最后一个问题开始:这不是因为例子来自后来的规范。假设你限制自己规范中的预览章节/部分(在线解析器也是如此)，考虑到我只比较了例子视觉上(即不是基于字符的字符)，示例在第 2 章/第 2 节的 1.2 和 1.1 规范中是相同的。

您的误解来自于在在线解析器的标题。它实际上试图做的是加载YAML，然后转储到 JSON、Python 或规范的 YAML。 正在加载PyYAML 由 ProcessingOverview 中提到的阶段组成YAML 中的图片规范(1.1 和 1.2 相同)，以字符为基础文档:解析、组合和构造步骤。

PyYAML 不会在解析步骤上失败，它会在构造上失败步骤，因为(正如@torek 指出的那样)PyYAML 构造了一个 list 和不能用作 Python dict 的键。这是一个Python 的 dict 实现和 IMO 的限制是 PyYAML 的缺陷之一。

import sys
import yaml as pyyaml

yaml_1_1_example_2_11 = """\
? - Detroit Tigers
  - Chicago cubs
:
  - 2001-07-23

? [ New York Yankees,
    Atlanta Braves ]
: [ 2001-07-02, 2001-08-12,
    2001-08-14 ]
"""

for event in pyyaml.parse(yaml_1_1_example_2_11):
    print(event)

给出:

StreamStartEvent()
DocumentStartEvent()
MappingStartEvent(anchor=None, tag=None, implicit=True)
SequenceStartEvent(anchor=None, tag=None, implicit=True)
ScalarEvent(anchor=None, tag=None, implicit=(True, False), value='Detroit Tigers')
ScalarEvent(anchor=None, tag=None, implicit=(True, False), value='Chicago cubs')
SequenceEndEvent()
SequenceStartEvent(anchor=None, tag=None, implicit=True)
ScalarEvent(anchor=None, tag=None, implicit=(True, False), value='2001-07-23')
SequenceEndEvent()
SequenceStartEvent(anchor=None, tag=None, implicit=True)
ScalarEvent(anchor=None, tag=None, implicit=(True, False), value='New York Yankees')
ScalarEvent(anchor=None, tag=None, implicit=(True, False), value='Atlanta Braves')
SequenceEndEvent()
SequenceStartEvent(anchor=None, tag=None, implicit=True)
ScalarEvent(anchor=None, tag=None, implicit=(True, False), value='2001-07-02')
ScalarEvent(anchor=None, tag=None, implicit=(True, False), value='2001-08-12')
ScalarEvent(anchor=None, tag=None, implicit=(True, False), value='2001-08-14')
SequenceEndEvent()
MappingEndEvent()
DocumentEndEvent()
StreamEndEvent()

因此 PyYAML 可以正确解析它。不仅如此，如果在线“解析器”不会尝试加载，然后转储，当发出规范的 YAML 时，它可以处理这个例子(替换上面的最后两行代码):

pyyaml.emit(pyyaml.parse(yaml_1_1_example_2_11), stream=sys.stdout, canonical=True)

如下所示:

---
{
  ? [
    ! "Detroit Tigers",
    ! "Chicago cubs",
  ]
  : [
    ! "2001-07-23",
  ],
  ? [
    ! "New York Yankees",
    ! "Atlanta Braves",
  ]
  : [
    ! "2001-07-02",
    ! "2001-08-12",
    ! "2001-08-14",
  ],
}

声明 PyYAML 解析所有示例，就像我声明我可以读希腊文。我在 70 年代学过希腊字母表，所以我可以阅读 (the) Greek (characters)，但我不理解它们组成的单词。

---

在 ruamel.yaml(免责声明:我是那个包的作者)你可以加载这个例子，你甚至可以使用 PyYAML 来转储加载的数据。

from pprint import pprint
import ruamel.yaml
import yaml as pyyaml

yaml = ruamel.yaml.YAML(typ='safe')
data = yaml.load(yaml_1_1_example_2_11)
pprint(data)
print('*' * 50)
yaml.dump(data, sys.stdout)
print('*' * 50)
pyyaml.safe_dump(data, sys.stdout)

如上所示:

{('Detroit Tigers', 'Chicago cubs'): [datetime.date(2001, 7, 23)],
 ('New York Yankees', 'Atlanta Braves'): [datetime.date(2001, 7, 2),
                                          datetime.date(2001, 8, 12),
                                          datetime.date(2001, 8, 14)]}
**************************************************
? [Detroit Tigers, Chicago cubs]
: [2001-07-23]
? [New York Yankees, Atlanta Braves]
: [2001-07-02, 2001-08-12, 2001-08-14]
**************************************************
? [Detroit Tigers, Chicago cubs]
: [2001-07-23]
? [New York Yankees, Atlanta Braves]
: [2001-07-02, 2001-08-12, 2001-08-14]