#json #serialization #events #json-event

json-event-parser

A JSON event parser and serializer

7 releases

0.2.2 Mar 8, 2025
0.2.1 Feb 23, 2025
0.2.0 Mar 23, 2024
0.2.0-alpha.2 Nov 13, 2023
0.1.0 May 30, 2021

#193 in Encoding

Download history 1150/week @ 2025-02-02 1444/week @ 2025-02-09 1420/week @ 2025-02-16 1803/week @ 2025-02-23 1337/week @ 2025-03-02 1612/week @ 2025-03-09 1208/week @ 2025-03-16 1559/week @ 2025-03-23 931/week @ 2025-03-30 893/week @ 2025-04-06 913/week @ 2025-04-13 865/week @ 2025-04-20 1056/week @ 2025-04-27 1402/week @ 2025-05-04 1942/week @ 2025-05-11 1313/week @ 2025-05-18

5,792 downloads per month
Used in 56 crates (6 directly)

MIT/Apache

67KB
1.5K SLoC

JSON streaming parser and serializer

actions status Latest Version Released API docs

JSON event parser is a simple streaming JSON parser and serializer implementation in Rust.

It does not aims to be the fastest JSON parser possible but to be a simple implementation allowing to parse larger than memory files.

If you want fast and battle-tested code you might prefer to use json, serde_json or simd-json.

Parser example:

use json_event_parser::{ReaderJsonParser, JsonEvent};

let json = b"{\"foo\": 1}";
let mut reader = ReaderJsonParser::new(json.as_slice());
assert_eq!(reader.parse_next()?, JsonEvent::StartObject);
assert_eq!(reader.parse_next()?, JsonEvent::ObjectKey("foo".into()));
assert_eq!(reader.parse_next()?, JsonEvent::Number("1".into()));
assert_eq!(reader.parse_next()?, JsonEvent::EndObject);
assert_eq!(reader.parse_next()?, JsonEvent::Eof);
# std::io::Result::Ok(())

Serializer example:

use json_event_parser::{WriterJsonSerializer, JsonEvent};

let mut writer = WriterJsonSerializer::new(Vec::new());
writer.write_event(JsonEvent::StartObject) ?;
writer.write_event(JsonEvent::ObjectKey("foo".into())) ?;
writer.write_event(JsonEvent::Number("1".into())) ?;
writer.write_event(JsonEvent::EndObject) ?;

assert_eq!(writer.finish()?.as_slice(), b"{\"foo\":1}");
# std::io::Result::Ok(())

License

This project is 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 json-event-parser by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0–5.5MB
~19K SLoC