Struct JqExpression 

pub struct JqExpression(/* private fields */);

A compiled jq expression for querying JSON bodies.

Wraps a jaq filter that can be compiled once and reused for multiple requests. This avoids the overhead of parsing and compiling the jq expression on each request.

Examples

use hitbox_http::predicates::body::JqExpression;

// Compile a jq expression
let expr = JqExpression::compile(".user.id").unwrap();

// Apply to JSON data
let json = serde_json::json!({"user": {"id": 42}});
let result = expr.apply(json);
assert_eq!(result, Some(serde_json::json!(42)));

Errors

compile returns Err if the jq expression is invalid.

Implementations

impl JqExpression

pub fn compile(expression: &str) -> Result<Self, String>

Compiles a jq expression into a reusable filter.

Arguments

• expression — A jq filter expression (e.g., .user.id, .items[] | .name)

Errors

Returns Err if the expression cannot be parsed or compiled.

pub fn apply(&self, input: Value) -> Option<Value>

Applies the filter to a JSON value and returns the result.

Returns None if the filter produces null or no output. If the filter produces multiple values, they are returned as a JSON array.

Trait Implementations

impl Clone for JqExpression

fn clone(&self) -> JqExpression

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for JqExpression

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.