From e1037c38925da66a15a386ac252fd40d098deec4 Mon Sep 17 00:00:00 2001 From: shile <13051960278@163.com> Date: Thu, 10 Dec 2020 16:10:14 +0800 Subject: [PATCH] Add command jq usage --- command/jq.md | 188 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 188 insertions(+) create mode 100644 command/jq.md diff --git a/command/jq.md b/command/jq.md new file mode 100644 index 0000000000..e0784ac362 --- /dev/null +++ b/command/jq.md @@ -0,0 +1,188 @@ + +jq +=== + +一个轻量级的和灵活的命令行JSON处理器 + +## 补充说明 + +jq是用于处理JSON输入，将给定过滤器应用于其JSON文本输入并在标准输出上将过滤器的结果生成为JSON的工具。 + +最简单的过滤器是., 它将jq的输入未经修改地复制到其输出中（格式设置除外，但请注意，IEEE754在内部用于数字表示，这意味着所有含义）。 + +## 语法 + +```bash +jq [options] [file...] +jq [options] --args [strings...] +jq [options] --jsonargs [JSON_TEXTS...] +``` + +## 选项 + +```bash +-c 紧凑而不是漂亮的输出; +-n 使用`null`作为单个输入值; +-e 根据输出设置退出状态代码; +-s 将所有输入读取（吸取）到数组中；应用过滤器; +-r 输出原始字符串，而不是JSON文本; +-R 读取原始字符串，而不是JSON文本; +-C 为JSON着色; +-M 单色（不要为JSON着色）; +-S 在输出上排序对象的键; +--tab 使用制表符进行缩进; +--arg a v 将变量$a设置为value; +--argjson a v 将变量$a设置为JSON value; +--slurpfile a f 将变量$a设置为从读取的JSON文本数组; +--rawfile a f 将变量$a设置为包含内容的字符串; +--args 其余参数是字符串参数，而不是文件; +--jsonargs 其余的参数是JSON参数，而不是文件; +-- 终止参数处理; +``` + +## 例子 + +`.`: 改变输入 + +```bash +$ echo '{ "foo": { "bar": { "baz": 123 } } }' | jq '.' +{ + "foo": { + "bar": { + "baz": 123 + } + } +} + +``` + +`.foo, .foo.bar, .foo?`: 获取一个键的值 + +```bash +$ echo '{"foo": 42, "bar": "less interesting data"}' | jq '.foo' +42 +``` + +`.[], .[]?, .[2], .[10:15]`: 数组运算 + +```bash +$ echo '[{"name":"JSON", "good":true}, {"name":"XML", "good":false}]' | jq '.[1]' +{ + "name": "XML", + "good": false +} + +``` + +`[], {}`: 构造一个数组/对象 + +```bash +$ echo '{"user":"stedolan","titles":["JQ Primer", "More JQ"]}' | jq '{user, title: .titles[]}' + +{ + "user": "stedolan", + "title": "JQ Primer" +} +{ + "user": "stedolan", + "title": "More JQ" +} + +``` + +`length`: 计算一个值的长度 + +```bash +$ echo '[[1,2], "string", {"a":2}, null]' | jq '.[] | length' +2 +6 +1 +0 + +``` + +`keys`: 取出数组中的键 + +```bash +$ echo '{"abc": 1, "abcd": 2, "Foo": 3}' | jq 'keys' +[ + "Foo", + "abc", + "abcd" +] + +``` + +`,`: 使用多个过滤器 + +```bash +$ echo '{ "foo": 42, "bar": "something else", "baz": true}' | jq '.foo, .bar' +42 +"something else" + +``` + +`|`: 通过管道将一个过滤器的输出当做下一个过滤器的输入 + +```bash +$ echo '[{"name":"JSON", "good":true}, {"name":"XML", "good":false}]' | jq '.[] | .name' +"JSON" +"XML" + +``` + +`select(foo)`: 如果foo返回true，则输入保持不变 + +```bash +$ echo '[1,5,3,0,7]' | jq 'map(select(. >= 2))' +[ + 5, + 3, + 7 +] + +``` + +`map(foo)`: 每个输入调用过滤器 + +```bash +$ echo '[1,2,3]' | jq 'map(.+1)' +[ + 2, + 3, + 4 +] + +``` + +`if-then-else-end`: 条件判断 + +```bash + $ echo '2' | jq 'if . == 0 then "zero" elif . == 1 then "one" else "many" end' + +"many" + +``` + +`\(foo)`: 在字符串中插入值并进行运算 + +```bash +$ echo '42' | jq '"The input was \(.), which is one less than \(.+1)"' + +"The input was 42, which is one less than 43" + +``` + + +### 注意 + +1. 该命令需要单独安装，相关的信息请查看[github主页](https://github.com/stedolan/jq)。 + +