x-cmd pkg | yq - 命令行 YAML处理工具
目录
- 简介
- 首次用户
- 支持格式转换
- 友好的显示和操作
- 语法与 jq 类似
- 竞品和相关作品
- 进一步阅读
简介
yq (YAML Query) 是一个轻量级的 YAML、JSON、XML 处理器，主要用于查询和提取 YAML 数据。
本 yq 的包来自 mikefarah/yq 项目，语法类似于 jq 。相比 kislyuk/yq ，它不依赖 jq，能处理多种数据格式，包括 YAML、JSON、XML、Properties、CSV 和 TSV。
首次用户
-
使用
x yq即可自动下载并使用- 在终端运行
eval "$(curl https://get.x-cmd.com)"即可完成 x 命令安装, 详情参考 x-cmd 官网
- 在终端运行
-
x-cmd 提供1分钟教程，其中包含了 yq 命令常用功能的 demo 示例，可以帮你快速上手 yq 。
-
使用案例:
# 格式化输出 YAML 数据 x yq '.' file.yml x ascii --yml | x yq '.'# 从 YAML 数据中获取 "Description" 属性的值 x ascii --yml | x yq '.[1].Description'# 修改 YAML 中 "Description" 属性的值 x ascii --yml | x yq '.[1].Description = "x-cmd" | .[1]'# 将前 5 个 ascii 码的 "Oct" 属性值加 1 x ascii --yml | x yq '(.[] | select(.Dec <5)|.Oct + 1)'# 检测 JSON 中是否含有 `Description` 属性 x ascii --json | x yq '.[1] | has("Description")'# 将 YAML 转化为 JSON 格式 x ascii --yml | x yq -o json
支持格式转换
yq 可以把 YAML 数据转为 JSON，ndJSON，CSV 和 TSV 的数据格式；也可以与 XML 数据互相转换。
友好的显示和操作
- 提供通用 shell (bash/zsh/fish/powershell) 的补全脚本，可以帮您在使用
yq命令时自动补全参数和选项。 - 可以输出彩色化的 YAML，并保留 YAML 的格式、注释、样式、标签、锚点和别名。
- 可以用于自动化流水线的 GitHub Action
语法与 jq 类似
- 支持深层次的数据结构：可以使用类似于
jq的语法来访问和修改 YAML、JSON 和 XML 数据中的任意深度的元素。 - 可以查询、修改、合并、排序、编码/解码、加载和计算 YAML、JSON 和 XML 数据，能解析和格式化日期和时间，支持不同时区。
竞品和相关作品
-
kislyuk/yq
-
jq：轻量级的 JSON 处理工具，由 Stephen Dolan 于 2012 年使用 C 语言开发。yq 的很大一部分灵感就来源于 jq.
-
dasel：一个支持众多格式（JSON，CSV，YAML，XML）的命令行方案，我们认为其功能稍逊于 jq，但胜在简单易用，能胜任大多数场景。
进一步阅读
- jq 源代码 - jq 项目的源代码托管在 GitHub，你可以在这里找到最新版本的 jq 和参与社区贡献。
- Getting started: jq - 官方提供的 jq 快速上手文档。
- My Cheatsheet for the “yq” Tool - 其中讲解了如何使用 yq 解析 Kubernetes YAML 文件
- yq : Mastering YAML Processing in Command Line - 其中讲解了如何使用命令行更有效地解析和操作 YAML 文件