aero-jmespath

aero-jsonpath

Native JSONPath engine for Python, powered by an Aero-compiled kernel.

Why

jsonpath-ng is the standard Python JSONPath library, but its pure-Python evaluator can be slow on large documents with complex queries (filters, descendants). aero-jsonpath provides a drop-in native kernel that handles the common JSONPath subset 2–6× faster on filter/descendant workloads.

Performance

Benchmark: 2000-book document, full pipeline (parse JSON → evaluate JSONPath → serialize result).

Install

pip install aero-jsonpath

Usage

import json
from aero_jsonpath import search

data = {"store": {"book": [{"title": "A", "price": 8.95}, {"title": "B", "price": 12.99}]}}

# search returns a list of matched values
results = search("$.store.book[?(@.price < 10)].title", json.dumps(data))
# → ["A"]

Supported JSONPath subset

• $ root, @ current
• .field, ['field'], [*], .*
• [index], [0,1] multi-index
• [start:end:step] slice
• .. descendant
• where / wherenot
• | union, & intersect
• [?(expr)] filter with == != < <= > >= and existence checks

License

MIT