#json5 #parse-json #json #parse #input-file #parser

json5_nodes

Parse JSON5 into nodes that retain both JSON value and input file location

3 releases (stable)

2.0.1 Mar 6, 2022
2.0.0 Mar 5, 2022
0.1.3 Nov 27, 2021

#2388 in Parser implementations

33 downloads per month
Used in stampver

Unlicense

21KB
538 lines

json5_nodes

This Rust library parses JSON5 into JsonNode structures that contain both the JSON value and the location of the data in the original string. This allows you to use JSON5 as a configuration format and refer back to the location of semantic errors in the original JSON5 as opposed to just reporting syntactic errors when reading the file.

See the stampver-rs tool for an example of how to use the library.

Implementation

We use IndexHashMap instead of a plain HashMap because JavaScript mostly preserves the order of insertion into objects. This libraries JSON5 parser currently only allows string based keys, so the rules are simplified.

All JSON breaks down into nodes of different types, JsonNode::Null, JsonNode::String, JsonNode::Bool, JsonNode::Integer, JsonNode::Float, JsonNode::Array and JsonNode::Object. We define and parse two types of numbers because it's more important in statically typed languages to specifically pick one or the other.

To Do

This library is a work in progress. The following are some things that still need to be done:

  • Get closer to 100% code coverage with the unit tests.
  • Rewrite the hex conversions to avoid the pathological Err cases; the values are already parsed to be valid input.
  • Maybe ensure that what's read by parse can be written back out in stringify with full fidelity. In particular escape codes are not handled at all and hex numbers don't round-trip.
  • A better README!

Dependencies

~4MB
~76K SLoC