#query-language #graph #object #xpath #json-query #extracting #config

datafu

A Rust library for extracting data from config objects and other arbitrary object graphs

9 releases

0.1.0-alpha.2 Apr 9, 2023
0.0.7 Mar 4, 2021
0.0.6 Feb 27, 2021
0.0.2 Jan 24, 2021

#2269 in Parser implementations

MIT/Apache and AGPL-3.0-or-later

195KB
3.5K SLoC

Datafu

Datafu is a Rust library for extracting data from config objects and other arbitrary object graphs, using a custom query language. As a query language, it takes on aspects of both XPath and jq, but differs significantly in scope. As a library, it attempts to keep things relatively straightforward.

Comparison with XPath

XPath is more-or-less standard. While it is primarily designed for XML, there are implementations of XPath that can work with JSON and other formats. It's also more or less type-aware and can do operations like numeric range checks without the use of user callbacks.

Unlike XPath, Datafu is not primarily designed for XML, but rather as a more general-purpose tool that can also be used for XML. It even supports cyclic graphs, such as those which can be found in Lua tables.

Comparison with jq

jq is first and foremost a CLI tool. It's also Turing-complete. If an undecidable schema isn't your thing, and the previous section of this README didn't convince you to use XPath, then Datafu should be your tool of choice.

Comparison with Serde

As of Datafu 0.1.0, Datafu is powered by Serde. This enables relying on Serde for deserialization and Datafu for efficiency. Note, however, that Datafu is stateful.

Dependencies

~4.5–6MB
~117K SLoC