Struct JetroEngine 

pub struct JetroEngine { /* private fields */ }

Long-lived multi-document query engine with an explicit plan cache. Use when the same process evaluates many expressions over many documents — parse/lower/compile work is amortised by this object, not hidden in thread-local state.

Implementations

impl JetroEngine

pub fn new() -> Self

Create a JetroEngine with the default plan-cache limit of 256 entries.

pub fn with_plan_cache_limit(plan_cache_limit: usize) -> Self

Create a JetroEngine with an explicit plan-cache capacity. Set plan_cache_limit to 0 to disable caching entirely.

pub fn keys(&self) -> &Arc<KeyCache>

Borrow this engine’s JSON key-intern cache.

pub fn clear_cache(&self)

Discard all cached query plans and the engine’s key-intern cache, forcing re-compilation and re-interning on the next call.

pub fn parse_value(&self, document: Value) -> Jetro

Build a Jetro document from a serde_json::Value with object keys interned into this engine’s key cache. Use this in place of Jetro::from(...) / the From<serde_json::Value> impl when per-engine key isolation is required.

pub fn parse_bytes(&self, bytes: Vec<u8>) -> Result<Jetro, JetroEngineError>

Parse raw JSON bytes into a Jetro document with object keys interned into this engine’s key cache. With simd-json, the tape is materialised eagerly so interning happens once at parse time (subsequent collect calls reuse the cached Val tree).

pub fn collect<S: AsRef<str>>( &self, document: &Jetro, expr: S, ) -> Result<Value, EvalError>

Evaluate a Jetro expression against an already-constructed Jetro document, using the engine’s shared plan cache and VM.

pub fn collect_value<S: AsRef<str>>( &self, document: Value, expr: S, ) -> Result<Value, EvalError>

Convenience wrapper: wrap a serde_json::Value in a Jetro and evaluate expr. Routes through JetroEngine::parse_value so the document’s object keys are interned into this engine’s key cache.

pub fn collect_bytes<S: AsRef<str>>( &self, bytes: Vec<u8>, expr: S, ) -> Result<Value, JetroEngineError>

Parse raw JSON bytes into a Jetro document and evaluate expr, returning a JetroEngineError on either parse or evaluation failure. Routes through JetroEngine::parse_bytes so the document’s object keys are interned into this engine’s key cache.

Trait Implementations

impl Default for JetroEngine

fn default() -> Self

Returns the “default value” for a type.