jpx 0.1.0

JMESPath query engine with 460+ functions - Python bindings for jpx-core and jpx-engine

jpx

Python bindings for jpx, a JMESPath query engine with 460+ extended functions on top of the standard JMESPath specification.

The bindings are built in Rust with PyO3 and ship as abi3 wheels, so a single wheel per platform works on CPython 3.9 and newer.

Install

pip install jpx

Quick start

import jpx

data = {"people": [{"name": "Alice", "age": 30}, {"name": "Bob", "age": 25}]}

# Run a query
jpx.search("people[?age > `28`].name", data)
# ['Alice']

# Compile once, reuse many times
expr = jpx.compile("people[*].name")
expr.search(data)
# ['Alice', 'Bob']

# Validate an expression without running it
jpx.validate("people[*].name")
# {'valid': True, ...}

Discovering functions

jpx.list_categories()           # extension categories
jpx.list_functions("string")    # functions in a category
jpx.describe("group_by")        # metadata for a single function

Full engine

JpxEngine exposes the complete engine: batch evaluation, function introspection, JSON utilities (diff, patch, merge, stats, paths), and a session-scoped named query store.

from jpx import JpxEngine

engine = JpxEngine()
engine.evaluate("a.b", {"a": {"b": 1}})
engine.diff({"a": 1}, {"a": 2})        # RFC 6902 patch
engine.stats({"a": [1, 2, 3]})          # structural stats

Links

• Documentation: https://joshrotenberg.github.io/jpx/
• Source and issues: https://github.com/joshrotenberg/jpx

License

MIT OR Apache-2.0