fx工具新增多文档YAML解析支持

背景介绍

fx是一个流行的命令行JSON处理工具，它允许用户通过管道快速处理和转换JSON数据。随着YAML在配置管理和Kubernetes等领域的广泛应用，fx也添加了对YAML格式的支持。然而，在处理包含多个YAML文档的文件时，fx遇到了解析问题。

问题描述

YAML规范允许在单个文件中包含多个文档，这些文档通过---分隔符隔开。例如：

---
ha: 1
---
hu: 2

当用户尝试使用fx处理这类多文档YAML时，工具会抛出错误："Source contains multiple documents; please use YAML.parseAllDocuments()"。这是因为底层使用的YAML解析器默认只处理单文档，遇到多文档时会报错。

技术实现

fx的维护者通过修改代码，将原来的单文档解析逻辑升级为支持多文档解析。主要变更包括：

1. 将YAML.parse()替换为YAML.parseAllDocuments()
2. 正确处理解析后返回的文档数组
3. 保持与现有单文档YAML的兼容性

使用场景

这一改进特别适用于以下场景：

1. Kubernetes配置管理：Helm模板经常生成包含多个Kubernetes资源的多文档YAML
2. 批量配置处理：需要同时处理多个相关但独立的配置文档
3. CI/CD管道：在自动化流程中处理复合YAML输出

实际应用示例

现在用户可以这样使用fx处理多文档YAML：

echo -e "---\nha: 1\n---\nhu: 2" | fx --yaml

或者处理Helm模板输出：

helm template . | fx --yaml

工具会正确解析所有文档，并提供一致的交互式体验。

总结

fx对多文档YAML的支持增强了其在现代云原生工具链中的实用性。这一改进使得开发者和运维人员能够更流畅地处理复杂的YAML配置，特别是在Kubernetes和基础设施即代码(IaC)场景中。随着YAML在DevOps领域的持续普及，这类功能改进将帮助fx保持其作为高效数据处理工具的地位。