![Gitter](https://badges.gitter.im/Join Chat.svg)
Rust implementation of JMESPath, a query language for JSON.
This crate is on crates.io and can be used
by adding jmespath
to the dependencies in your project's Cargo.toml
.
[dependencies]
jmespath = "^0.1.1"
If you are using a nightly compiler, or reading this when specialization in Rust
is stable (see rust#31844), then
enable the specialized
feature to switch on usage of specialization to get more
efficient code:
[dependencies.jmespath]
version = "^0.1.1"
features = ["specialized"]
extern crate jmespath;
let expr = jmespath::compile("foo.bar").unwrap();
// Parse some JSON data into a JMESPath variable
let json_str = r#"{"foo": {"bar": true}}"#;
let data = jmespath::Variable::from_json(json_str).unwrap();
// Search the data with the compiled expression
let result = expr.search(data).unwrap();
assert_eq!(true, result.as_boolean().unwrap());
The jmespath-macros
crate provides the jmespath!
macro used to
statically compile JMESPath expressions.
By statically compiling JMESPath expressions, you pay the cost of parsing and compiling JMESPath expressions at compile time rather than at runtime, and you can be sure that the expression is valid if your program compiles.
Note: This only works with a nightly compiler.
#![feature(plugin)]
#![plugin(jmespath_macros)]
extern crate jmespath;
fn main() {
// Create our statically compiled expression. The build will fail
// if the expression is invalid.
let expr = jmespath!("foo.bar");
// Parse some JSON data into a JMESPath variable
let json_str = r#"{"foo": {"bar": true}}"#;
let data = jmespath::Variable::from_json(json_str).unwrap();
let result = expr.search(data).unwrap();
assert_eq!(true, result.as_boolean().unwrap());
}