rusty-jq 0.1.0__tar.gz

rusty_jq-0.1.0/.gitignore

@@ -0,0 +1,31 @@
+/target
+Cargo.lock
+
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+.venv/
+venv/
+ENV/
+env/
+.env

rusty_jq-0.1.0/Cargo.lock

@@ -0,0 +1,439 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "allocator-api2"
+version = "0.2.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "683d7910e743518b0e34f1186f92494becacb047c7b6bf616c96772180fef923"
+
+[[package]]
+name = "autocfg"
+version = "1.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c08606f8c3cbf4ce6ec8e28fb0014a2c086708fe954eaa885384a6165172e7e8"
+
+[[package]]
+name = "bitflags"
+version = "2.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "843867be96c8daad0d758b57df9392b6d8d271134fce549de6ce169ff98a92af"
+
+[[package]]
+name = "cfg-if"
+version = "1.0.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9330f8b2ff13f34540b44e946ef35111825727b38d33286ef986142615121801"
+
+[[package]]
+name = "equivalent"
+version = "1.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
+
+[[package]]
+name = "float-cmp"
+version = "0.10.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b09cf3155332e944990140d967ff5eceb70df778b34f77d8075db46e4704e6d8"
+dependencies = [
+ "num-traits",
+]
+
+[[package]]
+name = "foldhash"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "77ce24cb58228fbb8aa041425bb1050850ac19177686ea6e0f41a70416f56fdb"
+
+[[package]]
+name = "halfbrown"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c7ed2f2edad8a14c8186b847909a41fbb9c3eafa44f88bd891114ed5019da09"
+dependencies = [
+ "hashbrown",
+ "serde",
+]
+
+[[package]]
+name = "hashbrown"
+version = "0.16.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "841d1cc9bed7f9236f321df977030373f4a4163ae1a7dbfe1a51a2c1a51d9100"
+dependencies = [
+ "allocator-api2",
+ "equivalent",
+ "foldhash",
+]
+
+[[package]]
+name = "heck"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "95505c38b4572b2d910cecb0281560f54b440a19336cbbcb27bf6ce6adc6f5a8"
+
+[[package]]
+name = "indoc"
+version = "2.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "79cf5c93f93228cf8efb3ba362535fb11199ac548a09ce117c9b1adc3030d706"
+dependencies = [
+ "rustversion",
+]
+
+[[package]]
+name = "itoa"
+version = "1.0.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "92ecc6618181def0457392ccd0ee51198e065e016d1d527a7ac1b6dc7c1f09d2"
+
+[[package]]
+name = "libc"
+version = "0.2.182"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6800badb6cb2082ffd7b6a67e6125bb39f18782f793520caee8cb8846be06112"
+
+[[package]]
+name = "lock_api"
+version = "0.4.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "224399e74b87b5f3557511d98dff8b14089b3dadafcab6bb93eab67d3aace965"
+dependencies = [
+ "scopeguard",
+]
+
+[[package]]
+name = "memchr"
+version = "2.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8ca58f447f06ed17d5fc4043ce1b10dd205e060fb3ce5b979b8ed8e59ff3f79"
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "minimal-lexical"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "68354c5c6bd36d73ff3feceb05efa59b6acb7626617f4962be322a825e61f79a"
+
+[[package]]
+name = "nom"
+version = "7.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d273983c5a657a70a3e8f2a01329822f3b8c8172b73826411a55751e404a0a4a"
+dependencies = [
+ "memchr",
+ "minimal-lexical",
+]
+
+[[package]]
+name = "num-traits"
+version = "0.2.19"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "42f5e15c9953c5e4ccceeb2e7382a716482c34515315f7b03532b8b4e8393d2d"
+
+[[package]]
+name = "parking_lot"
+version = "0.12.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "93857453250e3077bd71ff98b6a65ea6621a19bb0f559a85248955ac12c45a1a"
+dependencies = [
+ "lock_api",
+ "parking_lot_core",
+]
+
+[[package]]
+name = "parking_lot_core"
+version = "0.9.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2621685985a2ebf1c516881c026032ac7deafcda1a2c9b7850dc81e3dfcb64c1"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "redox_syscall",
+ "smallvec",
+ "windows-link",
+]
+
+[[package]]
+name = "portable-atomic"
+version = "1.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c33a9471896f1c69cecef8d20cbe2f7accd12527ce60845ff44c153bb2a21b49"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.106"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "53bdbb96d49157e65d45cc287af5f32ffadd5f4761438b527b055fb0d4bb8233"
+dependencies = [
+ "cfg-if",
+ "indoc",
+ "libc",
+ "memoffset",
+ "parking_lot",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "deaa5745de3f5231ce10517a1f5dd97d53e5a2fd77aa6b5842292085831d48d7"
+dependencies = [
+ "once_cell",
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "62b42531d03e08d4ef1f6e85a2ed422eb678b8cd62b762e53891c05faf0d4afa"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7305c720fa01b8055ec95e484a6eca7a83c841267f0dd5280f0c8b8551d2c158"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7c7e9b68bb9c3149c5b0cade5d07f953d6d125eb4337723c4ccdb665f1f96185"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.44"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "21b2ebcf727b7760c461f091f9f0f539b77b8e87f2fd88131e7f1b433b3cece4"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "redox_syscall"
+version = "0.5.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ed2bf2547551a7053d6fdfafda3f938979645c44812fbfcda098faae3f1a362d"
+dependencies = [
+ "bitflags",
+]
+
+[[package]]
+name = "ref-cast"
+version = "1.0.25"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f354300ae66f76f1c85c5f84693f0ce81d747e2c3f21a45fef496d89c960bf7d"
+dependencies = [
+ "ref-cast-impl",
+]
+
+[[package]]
+name = "ref-cast-impl"
+version = "1.0.25"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b7186006dcb21920990093f30e3dea63b7d6e977bf1256be20c3563a5db070da"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "rustversion"
+version = "1.0.22"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
+
+[[package]]
+name = "rusty-jq"
+version = "0.1.0"
+dependencies = [
+ "nom",
+ "pyo3",
+ "simd-json",
+]
+
+[[package]]
+name = "ryu"
+version = "1.0.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9774ba4a74de5f7b1c1451ed6cd5285a32eddb5cccb8cc655a4e50009e06477f"
+
+[[package]]
+name = "scopeguard"
+version = "1.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
+
+[[package]]
+name = "serde"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
+dependencies = [
+ "serde_core",
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_core"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.228"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.149"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "83fc039473c5595ace860d8c4fafa220ff474b3fc6bfdb4293327f1a37e94d86"
+dependencies = [
+ "itoa",
+ "memchr",
+ "serde",
+ "serde_core",
+ "zmij",
+]
+
+[[package]]
+name = "simd-json"
+version = "0.17.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4255126f310d2ba20048db6321c81ab376f6a6735608bf11f0785c41f01f64e3"
+dependencies = [
+ "halfbrown",
+ "ref-cast",
+ "serde",
+ "serde_json",
+ "simdutf8",
+ "value-trait",
+]
+
+[[package]]
+name = "simdutf8"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e3a9fe34e3e7a50316060351f37187a3f546bce95496156754b601a5fa71b76e"
+
+[[package]]
+name = "smallvec"
+version = "1.15.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "67b1b7a3b5fe4f1376887184045fcf45c69e92af734b7aaddc05fb777b6fbd03"
+
+[[package]]
+name = "syn"
+version = "2.0.116"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3df424c70518695237746f84cede799c9c58fcb37450d7b23716568cc8bc69cb"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.12.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "61c41af27dd6d1e27b1b16b489db798443478cef1f06a660c96db617ba5de3b1"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.24"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"
+
+[[package]]
+name = "value-trait"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8e80f0c733af0720a501b3905d22e2f97662d8eacfe082a75ed7ffb5ab08cb59"
+dependencies = [
+ "float-cmp",
+ "halfbrown",
+ "itoa",
+ "ryu",
+]
+
+[[package]]
+name = "windows-link"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f0805222e57f7521d6a62e36fa9163bc891acd422f971defe97d64e70d0a4fe5"
+
+[[package]]
+name = "zmij"
+version = "1.0.21"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b8848ee67ecc8aedbaf3e4122217aff892639231befc6a1b58d29fff4c2cabaa"

rusty_jq-0.1.0/Cargo.toml

@@ -0,0 +1,15 @@
+[package]
+name = "rusty-jq"
+version = "0.1.0"
+edition = "2021"
+readme = "README.md"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+[lib]
+name = "rusty_jq"
+crate-type = ["cdylib"]
+
+[dependencies]
+pyo3 = { version = "0.20.0", features = ["extension-module"] }
+nom = "7.1.3"
+simd-json = "0.17"

rusty_jq-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: rusty-jq
+Version: 0.1.0
+Classifier: Programming Language :: Rust
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.7

rusty_jq-0.1.0/README.md

@@ -0,0 +1,51 @@
+# 🦀 rusty-jq
+
+A **blazing-fast** jq-like JSON query engine for Python, written in Rust.
+
+`rusty-jq` compiles jq filter expressions into an optimized Rust pipeline and processes JSON using [simd-json](https://github.com/simd-lite/simd-json) for SIMD-accelerated parsing — delivering **lower latency** than the standard `jq` Python bindings.
+
+---
+
+## ✨ Features
+
+- **jq-compatible syntax** — familiar `.field`, `.[n]`, `.[]`, pipe `|`, and object construction `{}`
+- **Zero-copy where possible** — uses `Cow` semantics to avoid unnecessary allocations
+- **Compile-once, run-many** — pre-compile queries and reuse them across inputs
+- **Native Python types** — results are returned as plain `dict`, `list`, `str`, `int`, `float`, etc.
+
+---
+
+## 🚀 Installation
+
+### Prerequisites
+
+- Python ≥ 3.7
+- Rust toolchain (for building from source)
+- [Maturin](https://github.com/PyO3/maturin)
+
+### Supported Filters
+
+| Filter | Syntax | Description |
+|---|---|---|
+| **Identity** | `.` | Returns the input unchanged |
+| **Field access** | `.field` | Select a key from an object |
+| **Index** | `.[n]` | Access an array element (supports negative indices) |
+| **Iterator** | `.[]` | Iterate over all elements of an array |
+| **Pipe** | `\|` | Chain filters together |
+| **Object construction** | `{key: .field}` | Build a new object from selected fields |
+
+---
+
+## 🏗️ Architecture
+
+| Module | Role |
+|---|---|
+| `lib.rs` | PyO3 bindings — exposes `compile()` and `JqProgram.input()` to Python |
+| `parser.rs` | Query parser built with [nom](https://github.com/rust-bakery/nom) — tokenizes jq expressions into a `Vec<JrFilter>` |
+| `engine.rs` | Execution engine — walks the parsed filter chain over `simd_json::BorrowedValue` using `Cow` for zero-copy traversal |
+
+---
+
+## 📄 License
+
+MIT

rusty_jq-0.1.0/pyproject.toml

@@ -0,0 +1,15 @@
+[build-system]
+requires = ["maturin>=1.0,<2.0"]
+build-backend = "maturin"
+
+[project]
+name = "rusty-jq"
+version = "0.1.0"
+requires-python = ">=3.7"
+classifiers = [
+    "Programming Language :: Rust",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+]
+
+[tool.maturin]

rusty_jq-0.1.0/src/engine.rs

@@ -0,0 +1,115 @@
+use std::borrow::Cow;
+use simd_json::BorrowedValue;
+use simd_json::borrowed::Object; 
+use simd_json::prelude::*;
+     
+use crate::parser::RustyFilter;
+
+// applies a chain of RustyFilter to a JSON value and returns all matching results
+pub fn process_rust_value<'a>(root: Cow<'a, BorrowedValue<'a>>, filters: &[RustyFilter]) -> Vec<Cow<'a, BorrowedValue<'a>>> {
+    // seed the pipeline with the root value
+    let mut current_results: Vec<Cow<'a, BorrowedValue<'a>>> = vec![root];
+
+    for filter in filters {
+        let mut next_results = Vec::new();
+
+        for value in current_results {
+            match filter {
+                RustyFilter::Identity => {
+                    next_results.push(value);
+                },
+                RustyFilter::Select(key) => {
+                    match value {
+                        // borrowed path, hand out a sub-reference without cloning
+                        Cow::Borrowed(b_val) => {
+                            if let Some(obj) = b_val.as_object() {
+                                if let Some(child) = obj.get(key.as_str()) {
+                                    next_results.push(Cow::Borrowed(child));
+                                }
+                            }
+                        },
+                        // owned path, the child must be cloned out of the owned object
+                        Cow::Owned(o_val) => {
+                            if let Some(obj) = o_val.as_object() {
+                                if let Some(child) = obj.get(key.as_str()) {
+                                    next_results.push(Cow::Owned(child.clone()));
+                                }
+                            }
+                        }
+                    }
+                },
+                RustyFilter::Index(idx) => {
+                    match value {
+                        Cow::Borrowed(b_val) => {
+                            if let Some(arr) = b_val.as_array() {
+                                let len = arr.len() as isize;
+                                let abs_idx = if *idx < 0 { len + *idx as isize } else { *idx as isize };
+                                if abs_idx >= 0 && (abs_idx as usize) < (len as usize) {
+                                    next_results.push(Cow::Borrowed(&arr[abs_idx as usize]));
+                                }
+                            }
+                        },
+                        Cow::Owned(o_val) => {
+                             if let Some(arr) = o_val.as_array() {
+                                let len = arr.len() as isize;
+                                let abs_idx = if *idx < 0 { len + *idx as isize } else { *idx as isize };
+                                if abs_idx >= 0 && (abs_idx as usize) < (len as usize) {
+                                    next_results.push(Cow::Owned(arr[abs_idx as usize].clone()));
+                                }
+                            }
+                        }
+                    }
+                },
+                RustyFilter::Iterator => {
+                    match value {
+                        // borrows from the parse buffer
+                        Cow::Borrowed(b_val) => {
+                            if let Some(arr) = b_val.as_array() {
+                                next_results.extend(arr.iter().map(|v| Cow::Borrowed(v)));
+                            }
+                        },
+                        // the parent is an owned temporary
+                        Cow::Owned(o_val) => {
+                            if let Some(arr) = o_val.as_array() {
+                                next_results.extend(arr.iter().cloned().map(|v| Cow::Owned(v)));
+                            }
+                        }
+                    }
+                },
+                RustyFilter::Object(pairs) => {
+                    let mut product_objects: Vec<Object> = vec![Object::new()];
+
+                    for (key, sub_query) in pairs {
+                        // recursively evaluate the sub-query for this field.
+                        let field_results = process_rust_value(value.clone(), sub_query);
+
+                        // if any field yields no results the whole object is dropped
+                        if field_results.is_empty() {
+                            product_objects.clear();
+                            break; 
+                        }
+
+                        let mut new_product_objects = Vec::new();
+                        for partial_obj in &product_objects {
+                            for field_val in &field_results {
+                                let mut new_obj: Object = partial_obj.clone();
+                                new_obj.insert(
+                                    Cow::Owned(key.clone()), 
+                                    field_val.clone().into_owned()
+                                );
+                                new_product_objects.push(new_obj);
+                            }
+                        }
+                        product_objects = new_product_objects;
+                    }
+
+                    for obj in product_objects {
+                        next_results.push(Cow::Owned(BorrowedValue::Object(Box::new(obj))));
+                    }
+                }
+            }
+        }
+        current_results = next_results;
+    }
+    current_results
+}

rusty_jq-0.1.0/src/lib.rs

@@ -0,0 +1,94 @@
+use pyo3::prelude::*;
+use pyo3::types::{PyDict, PyList};
+use simd_json::{BorrowedValue, StaticNode};
+use std::borrow::Cow;
+
+mod parser;
+use parser::{parse_query, RustyFilter};
+
+mod engine;
+use engine::process_rust_value;
+
+// converts a simd-json BorrowedValue into a native Python object
+// operates on zero-copy references
+// Python allocation happens at the end, so hot path stays allocation-free
+fn value_to_py(py: Python, val: &BorrowedValue) -> PyResult<PyObject> {
+    match val {
+        BorrowedValue::Static(StaticNode::Null) => Ok(py.None()),
+        BorrowedValue::Static(StaticNode::Bool(b)) => Ok(b.into_py(py)),
+        BorrowedValue::Static(StaticNode::I64(i)) => Ok(i.into_py(py)),
+        BorrowedValue::Static(StaticNode::U64(u)) => Ok(u.into_py(py)),
+        BorrowedValue::Static(StaticNode::F64(f)) => Ok(f.into_py(py)),
+        
+        BorrowedValue::String(s) => Ok(s.as_ref().into_py(py)),
+        
+        BorrowedValue::Array(arr) => {
+            let list = PyList::new(py, arr.iter().map(|item| {
+                value_to_py(py, item).unwrap()
+            }));
+            Ok(list.into())
+        },
+        BorrowedValue::Object(map) => {
+            let dict = PyDict::new(py);
+            for (k, v) in map.iter() {
+                dict.set_item(k.as_ref(), value_to_py(py, v)?)?;
+            }
+            Ok(dict.into())
+        }
+    }
+}
+
+// compiled jq-style query, exposed to Python as RustyProgram
+#[pyclass]
+struct RustyProgram {
+    filters: Vec<RustyFilter>,
+}
+
+#[pymethods]
+impl RustyProgram {
+    // execute compiled query against given JSON text
+    fn input(&self, py: Python, json_text: &str) -> PyResult<PyObject> {
+        // converts string into a mutable buffer of bytes
+        let mut bytes = json_text.as_bytes().to_vec();
+        // parse the buffer in place and returns a BorrowedValue
+        let json_data = simd_json::to_borrowed_value(&mut bytes)
+             .map_err(|e| PyErr::new::<pyo3::exceptions::PyValueError, _>(e.to_string()))?;
+        // run filter pipeline
+        let result = process_rust_value(Cow::Borrowed(&json_data), &self.filters);
+        // unwrapping the result
+        match result.as_slice() {
+            [] => Ok(py.None()),
+            [val] => value_to_py(py, &*val),
+            _ => {
+                let items: PyResult<Vec<PyObject>> = result.iter()
+                    .map(|v| value_to_py(py, &*v))
+                    .collect();
+                Ok(PyList::new(py, items?).into_py(py))
+            }
+        }
+    }
+}
+
+#[pyfunction]
+fn compile(query: &str) -> PyResult<RustyProgram> {
+    // returns IResult<&str, Vec<RustyFilter>>
+    let (remaining, filters) = match parse_query(query) {
+        Ok(x) => x,
+        Err(e) => return Err(PyErr::new::<pyo3::exceptions::PyValueError, _>(format!("Invalid query syntax: {}", e))),
+    };
+
+    // ensure the parser consumed the entire query string
+    if !remaining.trim().is_empty() {
+        return Err(PyErr::new::<pyo3::exceptions::PyValueError, _>("Extra chars"));
+    }
+
+    Ok(RustyProgram { filters })
+}
+
+// PyO3 module initialisation (entry-point)
+#[pymodule]
+fn rusty_jq(_py: Python, m: &PyModule) -> PyResult<()> {
+    m.add_function(wrap_pyfunction!(compile, m)?)?;
+    m.add_class::<RustyProgram>()?;
+    Ok(())
+}

rusty_jq-0.1.0/src/parser.rs

@@ -0,0 +1,115 @@
+use nom::{
+    branch::alt,
+    bytes::complete::tag,
+    character::complete::{alphanumeric1, char, digit1, multispace0},
+    combinator::{map, map_res, opt, recognize},
+    multi::{separated_list1, many0},
+    sequence::{delimited, pair, preceded, separated_pair},
+    IResult,
+};
+
+// Represents filters operation in a jq-style query
+#[derive(Debug, Clone)]
+pub enum RustyFilter {
+    Identity,
+    Select(String),
+    Index(i32),
+    Iterator,
+    Object(Vec<(String, Vec<RustyFilter>)>),
+}
+
+fn parse_dot(input: &str) -> IResult<&str, &str> {
+    tag(".")(input)
+}
+
+fn parse_word(input: &str) -> IResult<&str, &str> {
+    recognize(pair(
+        alt((alphanumeric1, tag("_"))),
+        opt(recognize(many0(alt((alphanumeric1, tag("_"), tag("-"))))))
+    ))(input)
+}
+fn parse_select(input: &str) -> IResult<&str, RustyFilter> {
+    map(
+        preceded(
+            parse_dot, 
+            parse_word
+        ), 
+        |s: &str| RustyFilter::Select(s.to_string())
+    )(input)
+}
+
+fn parse_index(input: &str) -> IResult<&str, RustyFilter> {
+    map(
+        preceded(
+            parse_dot,
+            delimited(
+                char('['),
+                map_res(
+                    recognize(pair(opt(char('-')), digit1)),
+                    |s: &str| s.parse::<i32>()
+                ),
+                char(']')
+            )
+        ),
+        RustyFilter::Index
+    )(input)
+}
+
+fn parse_iterator(input: &str) -> IResult<&str, RustyFilter> {
+    map(
+        preceded(parse_dot, tag("[]")),
+        |_| RustyFilter::Iterator
+    )(input)
+}
+
+fn parse_identity(input: &str) -> IResult<&str, RustyFilter> {
+    map(parse_dot, |_| RustyFilter::Identity)(input)
+}
+
+fn parse_key_value_pair(input: &str) -> IResult<&str, (String, Vec<RustyFilter>)> {
+    map(
+        separated_pair(
+            parse_word,
+            delimited(multispace0, char(':'), multispace0),
+            parse_query,
+        ),
+        |(k, v)| (k.to_string(), v),
+    )(input)
+}
+
+fn parse_object(input: &str) -> IResult<&str, RustyFilter> {
+    map(
+        delimited(
+            char('{'),
+            delimited(
+                multispace0,
+                separated_list1(
+                    delimited(multispace0, char(','), multispace0),
+                    parse_key_value_pair
+                ),
+                multispace0
+            ),
+            char('}')
+        ),
+        RustyFilter::Object
+    )(input)
+}
+
+// parses any single filter token
+fn parse_single_filter(input: &str) -> IResult<&str, RustyFilter> {
+    alt((
+        parse_iterator,
+        parse_index,
+        parse_select,
+        parse_object,
+        parse_identity
+    ))(input)
+}
+
+// parses a full jq-style query string into a list of RustyFilter
+pub fn parse_query(input: &str) -> IResult<&str, Vec<RustyFilter>> {
+    separated_list1(
+        delimited(multispace0, char('|'), multispace0), 
+        parse_single_filter
+    )(input)
+}

rusty_jq-0.1.0/test/benchmark.py

@@ -0,0 +1,125 @@
+import json
+import time
+import statistics
+import subprocess
+import jq
+import rusty-jq
+
+DATA = {
+    "metadata": {"source": "payment_gateway", "timestamp": 1700000000},
+    "users": [
+        {
+            "id": 1,
+            "name": "John",
+            "profile": {"title": "Data Engineer", "location": "Hong Kong"},
+            "transactions": [
+                {"id": 101, "amount": 500, "currency": "HKD"},
+                {"id": 102, "amount": 1200, "currency": "USD"},
+            ],
+        },
+        {
+            "id": 2,
+            "name": "Bob",
+            "profile": {"title": "Manager", "location": "London"},
+            "transactions": [],
+        },
+    ] * 5000,
+}
+
+JSON_TEXT = json.dumps(DATA)
+
+QUERIES = [
+    # Simple Access
+    ".metadata | .timestamp",
+    # Deep Access
+    ".users | .[0] | .profile | .location",
+    # Array Slicing + Object Access
+    ".users | .[0] | .transactions | .[-1] | .amount",
+    # Iterator
+    ".users | .[] | .id",
+    # Constructor
+    ".users | .[] | {user_id: .id, city: .profile | .location}",
+]
+
+def run_jaq_cli(query, json_str):
+    """
+    Runs jaq binary AND parses the result back to Python.
+    """
+    process = subprocess.run(
+        ["jaq", "-c", query],
+        input=json_str,
+        text=True,
+        capture_output=True
+    )
+    if process.returncode != 0:
+        raise Exception(process.stderr)
+    
+    output_str = process.stdout.strip()
+    if not output_str:
+        return None
+    
+    try:
+        return json.loads(output_str) 
+    except json.JSONDecodeError:
+        return [json.loads(line) for line in output_str.splitlines()]
+
+def bench(name, fn, iters=1000):
+    for _ in range(100):
+        fn()
+        
+    times = []
+    for _ in range(iters):
+        t0 = time.perf_counter()
+        fn()
+        t1 = time.perf_counter()
+        times.append((t1 - t0) * 1000.0) 
+
+    return {
+        "mean": statistics.mean(times),
+        "median": statistics.median(times),
+        "stdev": statistics.stdev(times)
+    }
+
+def run_comparison():
+    print(f"--- BENCHMARK START ---")
+    print(f"Data Size: {len(JSON_TEXT) / 1024:.2f} KB")
+    print(f"Users: {len(DATA['users'])}")
+    print("-" * 60)
+
+    for query in QUERIES:
+        print(f"\nQuery: {query}")
+
+        def run_jq():
+            return list(jq.compile(query).input(text=JSON_TEXT))
+
+        def run_jaq():
+            return run_jaq_cli(query, JSON_TEXT)
+
+        def run_rusty():
+            return rusty.compile(query).input(JSON_TEXT)
+
+        res_jq = run_jq()
+        res_jaq = run_jaq()
+        res_rust = run_rusty()
+            
+        stats_jq = bench("jq", run_jq)
+        stats_jaq = bench("jaq", run_jaq)
+        stats_rust = bench("rusty", run_rusty)
+
+        print(f"  jq (official): {stats_jq['median']:.4f} ms")
+        print(f"  jaq (binary) : {stats_jaq['median']:.4f} ms")
+        print(f"  rusty_jq     : {stats_rust['median']:.4f} ms")
+        
+        speedup = stats_jq['median'] / stats_rust['median']
+        speedup_jaq = stats_jaq['median'] / stats_rust['median']
+        if speedup > 1:
+            print(f"  🚀 RESULT: Rusty is {speedup:.2f}x FASTER")
+        else:
+            print(f"  🐢 RESULT: Rusty is {1/speedup:.2f}x SLOWER")
+        if speedup_jaq > 1:
+            print(f"  🚀 RESULT: Rusty is {speedup_jaq:.2f}x FASTER")
+        else:
+            print(f"  🐢 RESULT: Rusty is {1/speedup_jaq:.2f}x SLOWER")
+
+if __name__ == "__main__":
+    run_comparison()

rusty_jq-0.1.0/test/test_lib.py

@@ -0,0 +1,76 @@
+import pytest
+import json
+import rusty-jq
+import jq
+
+@pytest.fixture
+def complex_data():
+    return {
+        "metadata": {
+            "source": "payment_gateway",
+            "timestamp": 1700000000
+        },
+        "users": [
+            {
+                "id": 1,
+                "name": "John",
+                "profile": {"title": "Data Engineer", "location": "Hong Kong"},
+                "transactions": [
+                    {"id": 101, "amount": 500, "currency": "HKD"},
+                    {"id": 102, "amount": 1200, "currency": "USD"}
+                ]
+            },
+            {
+                "id": 2,
+                "name": "Bob",
+                "profile": {"title": "Manager", "location": "London"},
+                "transactions": []
+            }
+        ]
+    }
+
+@pytest.fixture
+def json_string(complex_data):
+    return json.dumps(complex_data)
+
+@pytest.mark.parametrize("query,expected", [
+    # 1. Deep Dive
+    (".users | .[0] | .profile | .location", "Hong Kong"),
+    
+    # 2. Negative Indexing + Pipe
+    (".users | .[0] | .transactions | .[-1] | .amount", 1200),
+    
+    # 3. Empty Array Handling
+    (".users | .[1] | .transactions | .[0]", None),
+    
+    # 4. Safety Check
+    (".metadata | .source | .something", None),
+    
+    # 5. Root Object Access
+    (".metadata | .timestamp", 1700000000),
+
+    # 6. Iterator
+    (".users | .[] | .id", [1, 2]),
+])
+def test_jq_queries(complex_data, json_string, query, expected):
+    assert rusty.compile(query).input(json_string) == expected
+
+@pytest.mark.parametrize("query,expected", [
+    # 7. smaller object out of each user
+    (".users | .[] | {id: .id, loc: .profile | .location}", [
+        {"id": 1, "loc": "Hong Kong"},
+        {"id": 2, "loc": "London"},
+    ]),
+
+    # 8. nested constructor + selecting fields
+    (".users | .[0] | {name: .name, profile: {title: .profile | .title}}", {
+        "name": "John",
+        "profile": {"title": "Data Engineer"},
+    }),
+
+    # 9. constructor from root
+    (".metadata | {src: .source, ts: .timestamp}", {"src": "payment_gateway", "ts": 1700000000}),
+])
+
+def test_object_constructor_json_only(json_string, query, expected):
+    assert rusty.compile(query).input(json_string) == expected