XQ

JQ reimplemented purely in Rust.

Caution

This program is under development. You probably want to use the original implementation of jq, or pure Go implementation of it called gojq built by itchyny instead.

Current state

• Most of the jq components that require syntactical support are, hmm, implemented and tested against queries taken from the jq user manual. Exceptions are imports and module headers.
• Many builtin functions are missing, include those require intrinsic implementation.
• Need more unit tests. Most of the CLI options are missing.
• JSON and YAML formats are supported.

Goals

• Learn jq.

Ideas

• Since we use serde to deserialize input / serialize output, we should be able to support any format which has serde implementation (and has multi-document support) without too much effort, except those require scheme (protobuf, thrift, etc.).

• As a library, we should be able to make anything that implements Serialize as the input type, and anything implements Deserialize as the output type. So in theory, we should be able to write a library that can handle following; ```rust

  [derive(Serialize)]

  struct GitHubRepo { username: String, reponame: String, stars: usize, }

  [derive(Deserialize)]

  struct User { name: String, totalstars: usize, } let repos: Vec = fetchrepos(); let users: Vec = xq::somefunctionslurp(repos, r#" groupby(.username)[] | { name: .[0].username, total_stars: ([.[].stars] | add) } "#).collect(); ``` I mean, it's not something that one should really use. It's just something possible and interesting... isn't it?

Install and run

Are you sure you want to use this??? It's not a daily-usable stage. Though if you want to try, you can install it via shell $ cargo install xq $ cat whatever.json | xq 'query goes here' . Or to get the latet version, please clone this repository to your local, and run shell $ cargo install --path path-to-cloned-dir $ cat whatever.json | xq 'query goes here' . Alternatively, shell $ cat whatever.json | cargo run -- 'query goes here' in the cloned directory to try out them without installing.

Uninstall

shell $ cargo uninstall xq if you've installed via cargo install. Also remove the cloned directory if you've cloned the repository.

Pubilsh new version

Note for myself. TL;DR: Bump the version, reflect it to the lock file, commit changes and cargo publish. shell $ cargo set-version --bump patch # or just edit Cargo.toml to bump the version $ cargo build # to generate Cargo.lock $ git commit -am "Bump version" # so that there's no uncommited changes $ git push # and it's synced with the remote repo $ cargo publish

Acknowledgements

• Although this isn't a direct translation at all, I referred to jq built by Stephen Dolan and gojq built by itchyny. Thank you for the interesting product!

Credits

• Test cases in tests/from_manual are taken from the jq user manual, distributed under CC BY 3.0, Copyright (C) 2012 Stephen Dolan. Please refer to mod.rs there for more detail.

Author

Mi_Sawa

LICENSE

MIT. Please refer to LICENSE file.