Module json 

JSON parsing and typed decoding for the OCPI CDR pricing/generating and CDR/Tariff linting pipeline.

Parsing vs decoding

Parsing and decoding are intentionally separated so the linter can emit actionable warnings rather than hard parse errors.

Parsing (parse_object) converts a raw JSON &str into an Element tree. The parser is deliberately lenient about string content: it only verifies structural correctness (balanced delimiters, valid top-level values) and leaves escape sequences and control characters untouched inside RawStr.

Decoding (decode) interprets the raw JSON String as a &str. Calling RawStr::decode_escapes validates escape sequences and rejects control characters, returning decode::Warning values instead of hard errors. This lets the linter pinpoint the exact field, report what is wrong, and suggest a corrected encoding. The price and generate mods can choose to hard fail on specific Warnings.

Modules

decode

String decoding for JSON values parsed by super.

write

Tools for writing JSON.

Structs

Components

Iterator over the Components of a Path; see Path::components.

Document

The output of parse_object: the element tree with path resolution embedded in each element.

ElemId

Unique sequential index of a JSON Element within a document.

Element

A JSON Element with identity, source span, and value.

Error

A parse error produced when the input is not well-formed JSON.

EscapeStr

A &str with escape chars.

Field

An object field; upholds the invariant that the inner Element’s path ends with a key.

LexicalIssues

The lexical issues a RawStr may contain, discovered in a single pass by RawStr::lexical_issues.

Location

A file location expressed as line and column.

Path

The RFC 9535 path locating an Element in its Document, such as $.charging_periods[0].dimensions.

PathSet

Set of path with a common issue.

RawStr

A &str with surrounding quotes removed; escape sequences are not decoded.

Span

Byte range of a JSON token within the source string.

Enums

Component

A single Path component: an object member or an array index.

ParseError

Why a raw JSON &str could not be turned into a Document.

ParseErrorKind

The specific reason a crate::json::parse_object call failed.

PendingStr

Marks a &str as having escapes or not.

RemovalError

Why a set of elements could not be resolved to removal spans.

Value

A JSON value that borrows its content from the source JSON &str.

ValueKind

Which of the six JSON kinds a Value is, without its content.

Functions

line_col

Return the line and column indices of the end of the slice.

parse_object

Parse a raw JSON &str into a Document and require the root value to be a JSON object.

Type Aliases

RawMap

An object’s fields keyed by their undecoded name, for looking a field up by key.

RawRefMap

A RawMap that borrows its elements instead of owning them.