3个不稳定版本

0.4.1	2019年8月17日
0.4.0	2019年7月7日
0.0.0-alpha	2019年6月28日

#1380 in 解析器实现

每月339次下载
在 6 个crate中使用了（5个直接使用）

Apache-2.0/MIT

33KB
434 行

jq-rs

概述

在v0.4.0之前，这个crate名为json-query。

此Rust crate通过libjq C API（而不是“外壳”）提供对jq 1.6的访问。

通过利用jq，我们可以使用jq的dsl从json字符串中提取数据。

此crate需要Rust 1.32 或更高版本。

用法

此crate提供的基本接口。您提供jq程序字符串和要运行程序的字符串。

use jq_rs;
// ...

let res = jq_rs::run(".name", r#"{"name": "test"}"#);
assert_eq!(res.unwrap(), "\"test\"\n".to_string());

除了使用jq_rs::run()运行一次性程序外，您还可以使用jq_rs::compile()编译jq程序并使用不同的输入重用它。

use jq_rs;

let tv_shows = r#"[
 {"title": "Twilight Zone"},
 {"title": "X-Files"},
 {"title": "The Outer Limits"}
]"#;

let movies = r#"[
 {"title": "The Omen"},
 {"title": "Amityville Horror"},
 {"title": "The Thing"}
]"#;

let mut program = jq_rs::compile("[.[].title] | sort").unwrap();

assert_eq!(
 &program.run(tv_shows).unwrap(),
 "[\"The Outer Limits\",\"Twilight Zone\",\"X-Files\"]\n"
);

assert_eq!(
 &program.run(movies).unwrap(),
 "[\"Amityville Horror\",\"The Omen\",\"The Thing\"]\n",
);

关于性能的说明

虽然这些基准测试远非详尽无遗，但它们表明简单的jq程序的大部分运行时间都花在编译上。事实上，编译是非常昂贵的。

run one off             time:   [48.594 ms 48.689 ms 48.800 ms]
Found 6 outliers among 100 measurements (6.00%)
3 (3.00%) high mild
3 (3.00%) high severe

run pre-compiled        time:   [4.0351 us 4.0708 us 4.1223 us]
Found 15 outliers among 100 measurements (15.00%)
6 (6.00%) high mild
9 (9.00%) high severe

如果您需要多次运行相同的jq程序，强烈建议保留预编译的JqProgram并重用它。

处理输出

由于输出不一定是有效的json，jq的返回值是字符串。因此，如果您想处理表示的实际数据类型，则需要解析输出。

在这种情况下，您可能希望与此crate搭配使用serde_json或类似库。

例如，我们想从这个对象的集合中提取数字

use jq_rs;
use serde_json::{self, json};

// ...

let data = json!({
 "movies": [
     { "title": "Coraline", "year": 2009 },
     { "title": "ParaNorman", "year": 2012 },
     { "title": "Boxtrolls", "year": 2014 },
     { "title": "Kubo and the Two Strings", "year": 2016 },
     { "title": "Missing Link", "year": 2019 }
 ]
});

let query = "[.movies[].year]";
// program output as a json string...
let output = jq_rs::run(query, &data.to_string()).unwrap();
// ... parse via serde
let parsed: Vec<i64> = serde_json::from_str(&output).unwrap();

assert_eq!(vec![2009, 2012, 2014, 2016, 2019], parsed);