Module tracing 

Allocation-free source-location tracking (“backtraces”) for JsonValue.

Pairs a value or error with a precise position in a JSON document, or across several documents, without allocating until a location is actually needed:

• JsonBacktraceBuilder incrementally builds a location as a borrow-chain stack while walking a document; call JsonBacktraceBuilder::build to turn it into an owned JsonBacktraceBuf.
• A JsonBacktraceBuf/JsonBacktrace is a sequence of JsonBacktraceFrames, one per file crossed, each holding a JsonFragmentPathBuf/JsonFragmentPath of JsonFragmentPathSegment/JsonFragmentPathItemRef navigation steps within that file.
• JsonLocated (and the JsonAt/JsonErrorAt helper traits) pairs a value or error with its JsonBacktraceBuf.
• JsonValue::locate_fragment resolves a path back to a byte offset, given the JsonCodeMap produced when the document was parsed.

Structs

JsonBacktraceFrame

A single frame of a JsonBacktraceBuf: the file a fragment was found in, and the path to that fragment within it.

JsonLocated

A value paired with a source location.

Enums

JsonBacktraceBuilder

Incrementally builds a JsonBacktraceBuf as a borrow-chain stack, without allocating until Self::build is called.

JsonFragmentPathItemRef

Borrowed form of JsonFragmentPathSegment, used while building a backtrace to avoid allocating until JsonBacktraceBuilder::build is called.

JsonFragmentPathSegment

Owned form of a single path navigation step, as recorded in a JsonBacktraceFrame.

JsonObjectEntryPart

Which part of an object entry a JsonFragmentPathSegment::ObjectEntry (or JsonFragmentPathItemRef::ObjectEntry) targets.

Traits

JsonAt

Pairs any value with a location, producing a JsonLocated.

JsonErrorAt

Pairs the error of a Result, if any, with a location.

Type Aliases

JsonBacktrace

Borrowed form of a JsonBacktraceBuf.

JsonBacktraceBuf

Describes the exact location of a JSON fragment within a document, or across several documents.

JsonFragmentPath

Borrowed form of a JsonFragmentPathBuf.

JsonFragmentPathBuf

Owned sequence of path segments, from outermost to innermost.