json-tools
json-tools copied to clipboard
Published
20 hours ago •
Byron
Byron
A zero-copy json-lexer, filters and serializer.
This library contains a collection of tools to help interacting with json encoded data.
Features
-
Simple Json Lexer
- Without any intention of being feature complete, it is able to split ascii json data streams into their lexical tokens, keeping track of the character spans that make them up.
- facilitates writing higher-level parsers and filters
-
Key-Value Filter
- A utility to filter lexical tokens which belong to keys that have values of a given type. This makes it easy to re-assemble json data streams and strip them off their null values, for example.
-
TokenReader
- An adapter to convert a stream of
Tokensinto a stream of bytes, supprting theReadtrait. - Use it to convert filtered and/or manipulated token-streams back into byte-streams.
- Configure the output style, to achieve effects like pretty-printing or strip the output of all whitespace.
- An adapter to convert a stream of
Usage
Add this to your Cargo.toml
[dependencies]
json-tools = "*"
Add this to your lib ...
use json_tools::BufferType;
use json_tools::Lexer;
for token in Lexer::new(r#"{ "face": "😂" }"#.bytes(), BufferType::Span) {
println!("{:?}", token);
}
Motivation
This library may possibly never grow bigger than the two features originally mentioned, as it was created
as a workaround to missing features in serde.
Manual
Run tests with cargo test and benchmarks with cargo bench (works on stable).
License
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Byron