jsonata-core + jsonatapy

High-performance JSONata implementation in Rust, with Python bindings.

Much of this project was built using Claude Code with significant human oversight. There was no performant JSONata implementation in Python, so the goal was to port JSONata to Rust (with a PyO3 wrapper for Python) and see how fast it could go. The answer: faster than V8 for most expression workloads, and faster than the next pure-Rust implementation. The rust versions are published on crates.io, and the python wheels on pypi.

Many, many thanks to the incredible work of all the maintainers of the JSONata reference library. JSONata is a very powerful, well-designed, and useful language that has made an impact on many projects. This project leverages their outstanding work to extend that capability to Python and Rust and would not be possible without that project. The implementation in Rust was strongly influenced by their implementation. The 1600+ tests they created provided the scaffolding and validation for all of this project. This project will continue to follow and be a derivative of the reference project as the JSONata reference library evolves.

Release versions will follow the reference jsonata-js project major and minor release numbers, but not necessarily patches. This will make it easier for adopters of this library to understand each release's JSONata API compatibility. As an example, 2.1.7 should be compliant with 2.1.x jsonata-js tests, but may have fixes specific to this library. If a patch release for jsonata-js is relevant for this project, it will be included in a patch release that may or may not follow the patch numbers of the upstream project.

Two packages, one implementation

	jsonata-core	jsonatapy
Language	Rust	Python
Published on	crates.io	PyPI
Install	`cargo add jsonata-core`	`pip install jsonatapy`
Use when	You're writing Rust	You're writing Python

jsonatapy is a thin PyO3 wrapper around jsonata-core. Both live in this repo.

Rust quick start

use jsonata_core::evaluator::Evaluator;
use jsonata_core::parser;
use jsonata_core::value::JValue;

let ast = parser::parse("orders[price > 100].product")?;
let data = JValue::from_json_str(r#"{"orders":[
    {"product":"Laptop","price":1200},
    {"product":"Mouse","price":25}
]}"#)?;

let result = Evaluator::new().evaluate(&ast, &data)?;

# Cargo.toml
[dependencies]
jsonata-core = "2.1.6"          # pure Rust, no Python dependency

# Optional: disable SIMD for constrained targets
jsonata-core = { version = "2.1.6", default-features = false }

Python quick start

pip install jsonatapy

import jsonatapy

# One-off evaluation
result = jsonatapy.evaluate('"Hello, " & name', {"name": "World"})
print(result)  # "Hello, World"

# Compile once, evaluate many times (10–1000x faster for repeated use)
expr = jsonatapy.compile("$sum(orders.(quantity * price))")
result = expr.evaluate({
    "orders": [
        {"product": "Laptop", "quantity": 2, "price": 1200},
        {"product": "Mouse",  "quantity": 5, "price": 25},
    ]
})
print(result)  # 2450

# Pre-convert data once for maximum throughput
data = jsonatapy.JsonataData(large_dataset)
result = expr.evaluate_with_data(data)   # 3–15x faster than evaluate(dict)

Supports Python 3.10, 3.11, 3.12, 3.13, 3.14 on Linux, macOS (Intel & ARM), and Windows.

Command-line quick start

Both packages also ship a CLI, jq-shaped, with an identical contract:

pip install jsonatapy
echo '{"orders":[{"product":"Laptop","price":1200}]}' | jsonatapy 'orders[price > 100].product'
# "Laptop"

See CLI Reference for the full flag/exit-code contract.

C / C++ quick start

The engine exposes a small C ABI (8 functions, JSON text in/out), usable from C, C++, or any language with C interop:

JsonataExpr *expr = jsonata_compile("$sum(items.price)");
char *result = jsonata_evaluate(expr, "{\"items\":[{\"price\":2},{\"price\":3}]}");
// result: "5"
jsonata_free_string(result);
jsonata_free_expr(expr);

Build with cargo build --release --features capi and include bindings/c/jsonata.h. See the C API guide for linking (gcc/clang, Makefile, CMake), the memory/threading contract, and error handling.

What is JSONata?

JSONata is a query and transformation language for JSON data:

Query — person.name
Filter — products[price > 50]
Transform — items.{"name": title, "cost": price}
Aggregate — $sum(orders.total)
Conditionals — price > 100 ? "expensive" : "affordable"

See official JSONata docs for the full language reference.

Performance

jsonata-core passes 1682/1682 JSONata reference tests and is the fastest JSONata implementation available in either Rust or Python:

~6x faster on average than the JavaScript reference implementation (V8), across all benchmark categories — up to ~16x for complex transformations and string operations
~40x faster than jsonata-rs (the next pure-Rust JSONata implementation) on pure-Rust Criterion benchmarks with no Python overhead on either side (cargo bench)
hundreds of times faster than jsonata-python, even when it reuses its fastest (Context-based) repeated-evaluation path

For large array workloads, pre-convert data once with jsonatapy.JsonataData and reuse it across queries — this avoids the Python↔Rust conversion cost that otherwise dominates:

data = jsonatapy.JsonataData(large_dataset)
result = expr.evaluate_with_data(data)   # 3–15x faster than evaluate(dict)

See Performance docs for the full category-by-category breakdown and benchmark methodology.

Features

1682/1682 JSONata reference tests passing
Pure Rust core — no JavaScript runtime, no Node.js dependency
Optional Python bindings — PyO3/maturin, zero-copy where possible
Cross-platform — Linux, macOS (Intel & ARM), Windows; Python 3.10–3.14
SIMD-accelerated JSON parsing — via simd-json, enabled by default (disable with --no-default-features)

Documentation

Building from source

# Install Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Clone
git clone https://github.com/txjmb/jsonata-core.git
cd jsonata-core

# Build and install Python extension
pip install maturin
maturin develop --release

# Run Python tests
pytest tests/python/ -v

# Run Rust benchmarks (no Python required)
cargo bench --no-default-features --features simd

License

MIT — see LICENSE.

This project implements the JSONata specification. jsonata-js (the reference implementation) is also MIT licensed.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jsonatapy-2.2.5.tar.gz (315.1 kB view details)

Uploaded Jul 14, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

jsonatapy-2.2.5-cp313-cp313-win_amd64.whl (1.3 MB view details)

Uploaded Jul 14, 2026 CPython 3.13Windows x86-64

jsonatapy-2.2.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.4 MB view details)

Uploaded Jul 14, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64

jsonatapy-2.2.5-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.3 MB view details)

Uploaded Jul 14, 2026 CPython 3.13manylinux: glibc 2.17+ ARM64

jsonatapy-2.2.5-cp313-cp313-macosx_11_0_arm64.whl (1.2 MB view details)

Uploaded Jul 14, 2026 CPython 3.13macOS 11.0+ ARM64

jsonatapy-2.2.5-cp312-cp312-win_amd64.whl (1.3 MB view details)

Uploaded Jul 14, 2026 CPython 3.12Windows x86-64

jsonatapy-2.2.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.4 MB view details)

Uploaded Jul 14, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64

jsonatapy-2.2.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.3 MB view details)

Uploaded Jul 14, 2026 CPython 3.12manylinux: glibc 2.17+ ARM64

jsonatapy-2.2.5-cp312-cp312-macosx_11_0_arm64.whl (1.2 MB view details)

Uploaded Jul 14, 2026 CPython 3.12macOS 11.0+ ARM64

jsonatapy-2.2.5-cp311-cp311-win_amd64.whl (1.3 MB view details)

Uploaded Jul 14, 2026 CPython 3.11Windows x86-64

jsonatapy-2.2.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.4 MB view details)

Uploaded Jul 14, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64

jsonatapy-2.2.5-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.3 MB view details)

Uploaded Jul 14, 2026 CPython 3.11manylinux: glibc 2.17+ ARM64

jsonatapy-2.2.5-cp311-cp311-macosx_11_0_arm64.whl (1.2 MB view details)

Uploaded Jul 14, 2026 CPython 3.11macOS 11.0+ ARM64

jsonatapy-2.2.5-cp310-cp310-win_amd64.whl (1.3 MB view details)

Uploaded Jul 14, 2026 CPython 3.10Windows x86-64

jsonatapy-2.2.5-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (1.4 MB view details)

Uploaded Jul 14, 2026 CPython 3.10manylinux: glibc 2.17+ x86-64

jsonatapy-2.2.5-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (1.3 MB view details)

Uploaded Jul 14, 2026 CPython 3.10manylinux: glibc 2.17+ ARM64

jsonatapy-2.2.5-cp310-cp310-macosx_11_0_arm64.whl (1.2 MB view details)

Uploaded Jul 14, 2026 CPython 3.10macOS 11.0+ ARM64

File details

Details for the file jsonatapy-2.2.5.tar.gz.

File metadata

Download URL: jsonatapy-2.2.5.tar.gz
Upload date: Jul 14, 2026
Size: 315.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for jsonatapy-2.2.5.tar.gz
Algorithm	Hash digest
SHA256	`c1fab8cba5fe990befd65a9cebb5888bbbfd7b3478ad763a2dd2896d85c4d4da`
MD5	`3b1e27d4df0fbde43b1c0d9171b26ef1`
BLAKE2b-256	`ac461ffb24ba83b7230266f2e5cbb193265f24d3cafb257753d49274d979b11d`

Algorithm	Hash digest
SHA256	`638d3dfa72cb553660048117f62ce3da5992406ff03e1e3a8ffade2fe0496ed3`
MD5	`aca4750a511378979253362f1f55a78e`
BLAKE2b-256	`338ff71757f1fc839e643bc49d66da28f981a0410c2c3134b6c6a6b25aa57358`

Algorithm	Hash digest
SHA256	`b778930db14b826028211ac813f13c8b93dd986026253f7b0c625ce374d0947c`
MD5	`65ef53755331d290160676d80f679916`
BLAKE2b-256	`3c02f8ca46554566690ff519707252c35fee6d80673e5218dd98fe4abfc0ba2e`

Algorithm	Hash digest
SHA256	`7620ff26e3fc91dd1f4b373673ae386e8ac0b1adbccab797403b7b1e01af1306`
MD5	`1323892138cff9ad700de864e65689de`
BLAKE2b-256	`8a6d58b706128ce8a7d27c826a72854ffeb252ec45391a4b4ab0f7b12c348491`

Algorithm	Hash digest
SHA256	`f8d760cbd145f2551d4e88a382c49bd049d2ef3d7d21546caa8cc8340012e085`
MD5	`980a6d011bcdf1210da9982526da048b`
BLAKE2b-256	`4f6072d9b6aaff5b0836a54d2f63108048d3a76a32b575de59628f9db560150c`

Algorithm	Hash digest
SHA256	`6753b26b3c5baf50f07f7a43ec69ebfcfb71dbf655af7722b913534ec15d60c1`
MD5	`7f9c6e5772f3f3e7525b9330a3311de6`
BLAKE2b-256	`3d72dc17f87a800d3cbef7a00f6a69c0d6504e13b160bce26a61315a6b20d274`

Algorithm	Hash digest
SHA256	`7718f44297a1f4887eaec695961b0371186f9cd788a4ea0b70f2bdf9d4e3caa7`
MD5	`6898a23c5e60992747b66d4af7419fee`
BLAKE2b-256	`70f53ce97c9d4775ba868bda5e4c59a2c40c8ca696aeba684f1e8f3c1d2259f2`

Algorithm	Hash digest
SHA256	`cf071ba6a1601d74b2ecd3d1345e5a4184741eb38738280b9f640619e2337556`
MD5	`4a56218a1b9c1017a5690738544595dd`
BLAKE2b-256	`d2add5cc94aa7db66a940be7eb2e508f27183b749ad068eeab2208cdfa8b183b`

Algorithm	Hash digest
SHA256	`045d53c0dda64ea95bb4faf2e1134aab0ad3a02daf86247939f7a3b00c8926f2`
MD5	`6aed7c20596136c512143f5ab5737820`
BLAKE2b-256	`13d2d6311ea1882a8850cd7da443dd40d661e53dfd20700c66fd2d64f2f8108d`

Algorithm	Hash digest
SHA256	`0bd368103273fef16e6445bd30060956087e8c7e9fb434eaba63601e63bed8cc`
MD5	`e5f3ac6de2ac07607bdbe2294e45f4d8`
BLAKE2b-256	`9a22cf90b69b5b1923b331bbdbc72c4b5b09cb36a28308cdef1c863f56f8f7f2`

Algorithm	Hash digest
SHA256	`b4b6b99a147d8069c05ada9c2779848b6f20c6cf2586d423c53a12a2f3a581da`
MD5	`51cb6ff2817eb27825946760f5922bfe`
BLAKE2b-256	`c075f4d6bef1b9e1c9ee39d7dc738e4fbddaeafccf27b9e1d467061e6a0bc5ea`

Algorithm	Hash digest
SHA256	`e5f74f1496bd37437d1179a48538f556fefef0db045611bfa099b7ed4dfd9ee8`
MD5	`913b8d1a2ec295b122de98560d55ff03`
BLAKE2b-256	`b6ce7eb0bf2c28a6965746016b611d88a562371e953ff9f837722859d1ddda9f`

Algorithm	Hash digest
SHA256	`e58c5dcb59232ad2c92b8bd2454ca1420d0e75512f351c59bb955c938df62655`
MD5	`d2b611a38fbf5a42ea48f8509509616c`
BLAKE2b-256	`e67ed67a082b7748842c4d400cd70104b8e379f29aebc4d28e3473855ffa3d12`

Algorithm	Hash digest
SHA256	`d465ba6501d5d03b52315da0b974e9ac20b529799821fb705927e0eee6be3b87`
MD5	`c5194f01f06ce8535f74d3bc92986ea7`
BLAKE2b-256	`da71791b6394b72a0ebb83985b43525d50356e0f47b14f8766a08d21747c0bbb`

Algorithm	Hash digest
SHA256	`34ee8eaac64ca6f73cff26f18dbfb750b154c2bd57aa2d17a2e1146a71725643`
MD5	`4abe18a84454d0728ae2adb53ad3256c`
BLAKE2b-256	`5a6c2372ba1fb41834a3a0b46df7978f0addaa5787d8fbdc8f8b9a79d7a19b00`

Algorithm	Hash digest
SHA256	`a50e2efede607032ecb75b17520b0bf5040d9e1dcdd3d8194c73f853e35bbe3a`
MD5	`f7b595fc759e58046ad812af45ae93f9`
BLAKE2b-256	`3b4b76f76ee65cc5da6a8dc4c0378d477c8adf77178c76cf1547313ee17c7450`

Algorithm	Hash digest
SHA256	`96e2c3d08e88cb60e70920f14b02d2ce8b85ce87100d868fe6fe353e5e5a5265`
MD5	`4c9220364a955c7f636abcc2d192d69e`
BLAKE2b-256	`7a06f36334af14edd1266d08ff6157efc619cd396cadb00a9720840042a65b57`

jsonatapy 2.2.5

jsonata-core + jsonatapy

Two packages, one implementation

Rust quick start

Python quick start

Command-line quick start

C / C++ quick start

What is JSONata?

Performance

Features

Documentation

Building from source

License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata