Module path 

JSONPath parsing and typed construction.

Rama targets RFC 9535 JSONPath. This module implements the selectors that can be matched efficiently from the concrete path of a value observed by a forward streaming parser.

RFC 9535 support matrix

Feature	Status	Notes
Root selector $	supported	Always the implicit path root.
Dot member .name	supported	RFC identifier shorthand.
Bracket member ['name'] / ["name"]	supported	JSON string escapes, including surrogate pairs.
Wildcard *	supported	Child and descendant forms.
Array index [0]	supported	Non-negative indexes.
Array slice [start:end:step]	supported	Non-negative bounds and non-negative step. A zero step matches no elements.
Selector lists / unions [0,'name',*]	supported	Child and descendant forms.
Descendant segment ..	supported	Member, index, wildcard, slice, and union selectors.
Negative indexes / slices	unsupported	RFC semantics require array length, which a pure forward matcher does not know.
Filter selectors [?(...)]	unsupported	Requires an expression evaluator and possibly buffered subtrees.

Example

use rama_json::path::JsonPath;

let path = JsonPath::builder()
    .member("store")
    .member("book")
    .wildcard()
    .member("author")
    .build();

assert_eq!(path.to_string(), "$.store.book[*].author");

Structs

JsonPath

A compiled JSONPath expression.

JsonPathBuilder

Typed builder for JsonPath.

Slice

RFC 9535 array slice selector with streaming-compatible semantics.

Enums

PathElement

One concrete location segment for a value encountered in a JSON document.

Segment

One JSONPath selector segment after the root.