ruyaml 0.91.0

ruyaml

ruyaml 包是基于 ruamel.yaml 的分支，旨在确保库的未来，主要通过拥有一批维护者来实现。

注意

• 当前版本与“ruamel.yaml”包具有相同的API。但是，它将安装 ruyaml Python模块。因此，只需将 from ruamel import yaml 替换为 import ruyaml as yaml（或类似）即可。

• python3.6是支持的Python最小版本

版本：

0.90.1

更新：

2021-06-10

文档：

http://ruyaml.readthedocs.io

仓库：

https://github.com/pycontribs/ruyaml.git

PyPI：

https://pypi.ac.cn/project/ruyaml/

0.16.13版本是最后一个在Python 2.7上测试过的版本。0.17系列将继续在Python 3.5上测试，但0.18将不再测试。0.17系列还将停止支持旧的PyYAML函数，因此需要创建一个 `YAML()` 实例。

0.17系列还将看到在往返过程中附加注释的方式发生变化。这将导致 `.ca` 数据的向后不兼容，甚至可能需要处理注释的文档方法。

如有必要，请相应地调整您的依赖关系。（`ruamel.yaml<0.17`）

从版本0.15.0开始，YAML文件的加载和转储方式已经改变，请参阅API文档以获取详细信息。现有功能在更改/删除之前将抛出警告。对于已经使用预0.16版本的生成系统，如果您无法完全测试升级到新版本，您应该使用 ``ruamel.yaml<=0.15`` 将使用的版本固定。对于新用法，将版本固定到已测试的次要版本（ ruamel.yaml<=0.17）或甚至固定到使用的确切版本。

新功能通常仅通过新API提供，因此请确保您使用它，并停止使用 ruamel.yaml.safe_load()、ruamel.yaml.round_trip_load() 和 ruamel.yaml.load() 函数（及其 ….dump() 对应函数）。

如果您的包使用 ruamel.yaml 并且不在PyPI上列出，请给我发电子邮件，最好提供一些关于您如何使用该包的信息（或链接到存储库），当API的状态足够稳定以进行转换时，我会通知您。

• 概述

• 安装

• 基本用法

• 详细信息

• 示例

• API

• 与PyYAML的差异

变更日志

0.17.17 (2021-10-31):

• 将提取时间戳匹配/创建移至util

0.17.16 (2021-08-28):

• 398还处理了当注释是换行符时的问题397

0.17.15 (2021-08-28):

• 修复问题397，当键和值之间存在注释时，在键之前插入注释（由 Bastien gerard 报告）

0.17.14 (2021-08-25):

• 修复问题396，在合并的字典中插入键/值（由 Bastien gerard 报告）

0.17.13 (2021-08-21):

• 属性处理中的小修复

0.17.12 (2021-08-21):

• 修复了锚点在注册类上不保留以及使用 @attr.s() 的包属性的那些类的问题（都由 ssph 报告）

0.17.11 (2021-08-19):

• 修复了 DuplicateKeyErorr 的错误基类（由 Łukasz Rogalski 报告）

• 修复了在读取器错误消息中的拼写错误，导致在读取器错误期间出现 KeyError（由 MTU 报告）

0.17.10 (2021-06-24):

• 修复了问题388，具有旧注释结构的令牌 != 两个元素（由 Dimitrios Bariamis 报告）

0.17.9 (2021-06-10):

• 修复了更新CommentedMap的问题（由sri在 StackOverflow 上报告）

0.17.8 (2021-06-09):

• 修复了问题387，在标记对象上的模板锚点未正确设置，导致潜在的ID重复使用。（由Artem Ploujnikov报告）

0.17.7 (2021-05-31):

• 问题385也影响了其他已弃用的加载器（由Oren Watson通过电子邮件报告）

0.17.6 (2021-05-31):

• 合并了由Jochen Sprickerhof提供的类型注释更新

• 修复了问题385：已弃用的round_trip_loader函数无法正常工作（由Mike Gouline报告）

• 花了几小时去除mypy警告/错误

0.17.5 (2021-05-30):

• 修复了问题384：使用别名的entry导致的rt上YAML损坏 !!set（由William Kimball报告）

0.17.4 (2021-04-07):

• 防止（空）注释引发断言错误（问题351由William Kimball报告）注释（或空行）将被删除

0.17.3 (2021-04-07):

• 修复了由格式字符串错误引起的问题382（由William Kimball报告）

• 通过设置 yaml.composer.return_alias = lambda s: copy.deepcopy(s) 允许别名展开

  （如Stackoverflow答案所述）

0.17.2 (2021-03-29):

• 将 -py2.py3-none-any.whl 更改为 -py3-none-any.whl，并删除0.17.1

0.17.1 (2021-03-29):

• 添加了‘Programming Language :: Python :: 3 :: Only’，并从PyPI中移除了0.17.0（由Alasdair Nicol报告）

0.17.0 (2021-03-26):

• 由于分类不完整而删除

• 本版本不再支持Python 2.7，大多数（如果不是全部）Python 2特定代码已被删除。0.17.x系列是最后一个支持Python 3.5的系列（这也允许删除对ruamel.std.pathlib的依赖）

• 删除Python2特定代码分支和适配（u-strings）

• 使用_F准备%代码以供f-strings使用

• 允许PyOxidisation（问题324的响应324或171）

• 将Python 2兼容的关键字参数强制执行替换为“*”

• 旧顶级函数load、safe_load、round_trip_load、dump、safe_dump、round_trip_dump、scan、parse、compose、emit、serialize以及它们的_all变体（用于多文档流）现在将发出PendingDeprecationning（例如，当通过pytest运行时，也可以在Python启动时使用-Wd）。使用已扩展的YAML()上的方法。

• 修复了问题376：缩进更改可能导致字面量/折叠标量在后续注释的#列之前开始。有效地使注释部分成为输出中的标量。（由Bence Nagy报告）

0.16.13 (2021-03-05):

• 修复了问题359：无法使用关键字参数更新() CommentedMap（由Steve Franchak报告）

• 修复了问题365：无法导出修改过的TimeStamp对象（由Anton Akmerov https://sourceforge.net/u/akhmerov/报告）

• 修复了问题371：无法在不开始空格的情况下添加注释（由“Mark Grandi https://sourceforge.net/u/mgrandi”报告）

• 修复了问题373：walk_tree的递归调用未保留所有参数（由eulores报告）

• 流式序列中的None值现在作为null而不是!!null ‘’导出（由mcarans在StackOverflow上报告）

0.16.12 (2020-09-04):

• 更新文档中的链接

0.16.11 (2020-09-03):

• 解决与setuptools 0.50和导入pip相关的问题（由jaraco修复 https://github.com/pypa/setuptools/issues/2355#issuecomment-685159580）

0.16.10 (2020-02-12):

• 自动更新README中的图片引用到sourceforge

0.16.9 (2020-02-11):

• 更新CHANGES

0.16.8 (2020-02-11):

• 更新要求，以便在3.8版本中安装ruamel.yaml.clib，因为它已经可用（通过manylinux构建）

0.16.7 (2020-01-30):

• 修复在TaggedScalar上类型检查的问题（由Jens Nielsen报告）

• 修复在序列中输出字面量标量时，在元素之前有注释的错误（由EJ Etherington报告）

0.16.6 (2020-01-20):

• 修复空字符串映射键回绕，保留引号作为? ‘’（通过电子邮件由Tomer Aharoni报告）

• 修复在类构造函数中设置状态不正确（由Douglas Raillard报告）

• 调整对Hashable的弃用警告测试，因为它不再警告（由Jason Montleon报告）

0.16.5 (2019-08-18):

• 允许使用YAML(typ=['unsafe', 'pytypes'])

0.16.4 (2019-08-16):

• 修复带有#的TAG指令的输出（由Thomas Smith报告）

0.16.3 (2019-08-15):

• 拆分construct_object

• 更改内容以使mypy满意

• 将基于YAML指令的版本设置移动到扫描器，允许在扫描TAG指令时检查文件版本

0.16.2 (2019-08-15):

• 在回程中保留YAML和TAG指令，正确输出YAML 1.2的URL中的#（由Thomas Smith报告）

0.16.1 (2019-08-08):

• 强制使用ruamel.yaml.clib的新版本（由Alex Joz报告）

• 允许在标签URI中使用#，因为YAML 1.2允许这些（由Thomas Smith报告）

0.16.0 (2019-07-25):

• 将生成.so文件的C源代码拆分到ruamel.yaml.clib

• 在旧API中，重复键现在是错误

有关旧更改，请参阅文件CHANGES