Skip to content

Low Level API Reference

jsonpath.token.Token

A token, as returned from lex.Lexer.tokenize().

ATTRIBUTE DESCRIPTION
kind

The token's type. It is always one of the constants defined in jsonpath.token.py.

TYPE: str

value

The path substring containing text for the token.

TYPE: str

index

The index at which value starts in path.

TYPE: str

path

A reference to the complete JSONPath string from which this token derives.

TYPE: str

position

position() -> Tuple[int, int]

Return the line and column number for the start of this token.

jsonpath.filter.FilterExpression

Bases: ABC

Base class for all filter expression nodes.

children abstractmethod

children() -> List[FilterExpression]

Return a list of direct child expressions.

evaluate abstractmethod

evaluate(context: FilterContext) -> object

Resolve the filter expression in the given context.

PARAMETER DESCRIPTION
context

Contextual information the expression might choose use during evaluation.

TYPE: FilterContext

RETURNS DESCRIPTION
object

The result of evaluating the expression.

evaluate_async abstractmethod async

evaluate_async(context: FilterContext) -> object

An async version of evaluate.

set_children abstractmethod

set_children(children: List[FilterExpression]) -> None

Update this expression's child expressions.

children is assumed to have the same number of items as is returned by self.children, and in the same order.

jsonpath.lex.Lexer

Tokenize a JSONPath string.

Some customization can be achieved by subclassing Lexer and setting class attributes. Then setting lexer_class on a JSONPathEnvironment.

ATTRIBUTE DESCRIPTION
key_pattern

The regular expression pattern used to match mapping keys/properties.

logical_not_pattern

The regular expression pattern used to match logical negation tokens. By default, not and ! are equivalent.

logical_and_pattern

The regular expression pattern used to match logical and tokens. By default, and and && are equivalent.

logical_or_pattern

The regular expression pattern used to match logical or tokens. By default, or and || are equivalent.

compile_rules

compile_rules() -> Pattern[str]

Prepare regular expression rules.

tokenize

tokenize(path: str) -> Iterator[Token]

Generate a sequence of tokens from a JSONPath string.

jsonpath.parse.Parser

TODO:

jsonpath.selectors.JSONPathSelector

TODO:

jsonpath.stream.TokenStream

TODO: