Struct FilterExpressionBuilder 

pub struct FilterExpressionBuilder { /* private fields */ }

Fluent builder for a non-empty FilterExpression.

Predicates without an explicit connector are joined by logical AND. Construction stops at the first invalid operand or resource limit. Later operands are not converted, iterators are not consumed, and group callbacks are not invoked. Argument expressions themselves are still evaluated by Rust.

Examples

use qubit_metadata::FilterExpressionBuilder;

let expression = FilterExpressionBuilder::default()
    .eq("tenant", "acme")
    .build()?;
assert!(matches!(expression.view(), qubit_metadata::FilterExpressionView::Condition(_)));

Implementations

impl FilterExpressionBuilder

pub fn build(self) -> MetadataResult<FilterExpression>

Builds the assembled expression.

Errors

Returns MetadataError::InvalidFilterExpression for empty or invalid groups, MetadataError::FilterLimitExceeded for oversized trees, or MetadataError::InvalidFilterOperand for unset operands or operands that cannot be represented by the V1 wire format, including non-finite floating-point values. Chained construction retains the first error and returns it from this method.

pub fn eq<T>(self, key: &str, value: T) -> Self

where T: Into<Value>,

Appends key == value with logical AND.

Type Parameters

• T - Value type converted into the stored representation.

Parameters

• key - Metadata key used by the condition.
• value - Value supplied for the condition.

pub fn ne<T>(self, key: &str, value: T) -> Self

where T: Into<Value>,

Appends key != value with logical AND.

Type Parameters

• T - Value type converted into the stored representation.

Parameters

• key - Metadata key used by the condition.
• value - Value supplied for the condition.

pub fn lt<T>(self, key: &str, value: T) -> Self

where T: Into<Value>,

Appends key < value with logical AND.

Type Parameters

• T - Value type converted into the stored representation.

Parameters

• key - Metadata key used by the condition.
• value - Value supplied for the condition.

pub fn le<T>(self, key: &str, value: T) -> Self

where T: Into<Value>,

Appends key <= value with logical AND.

Type Parameters

• T - Value type converted into the stored representation.

Parameters

• key - Metadata key used by the condition.
• value - Value supplied for the condition.

pub fn gt<T>(self, key: &str, value: T) -> Self

where T: Into<Value>,

Appends key > value with logical AND.

Type Parameters

• T - Value type converted into the stored representation.

Parameters

• key - Metadata key used by the condition.
• value - Value supplied for the condition.

pub fn ge<T>(self, key: &str, value: T) -> Self

where T: Into<Value>,

Appends key >= value with logical AND.

Type Parameters

• T - Value type converted into the stored representation.

Parameters

• key - Metadata key used by the condition.
• value - Value supplied for the condition.

pub fn in_set<I, T>(self, key: &str, values: I) -> Self

where I: IntoIterator<Item = T>, T: Into<Value>,

Appends a membership predicate with logical AND.

Type Parameters

• I - Iterator that supplies candidate values.
• T - Value type converted into the stored representation.

Parameters

• key - Metadata key used by the condition.
• values - Candidate values used by the condition.

pub fn not_in_set<I, T>(self, key: &str, values: I) -> Self

where I: IntoIterator<Item = T>, T: Into<Value>,

Appends a non-membership predicate with logical AND.

Type Parameters

• I - Iterator that supplies candidate values.
• T - Value type converted into the stored representation.

Parameters

• key - Metadata key used by the condition.
• values - Candidate values used by the condition.

pub fn exists(self, key: &str) -> Self

Appends an existence predicate with logical AND.

Parameters

• key - Metadata key used by the condition.

pub fn not_exists(self, key: &str) -> Self

Appends a non-existence predicate with logical AND.

Parameters

• key - Metadata key used by the condition.

pub fn and_group<F>(self, build: F) -> Self

where F: FnOnce(Self) -> Self,

Appends a grouped expression with logical AND.

Type Parameters

• F - Callback that visits operands or constructs a nested group.

Parameters

• build - Callback that constructs the nested group.

Examples

use qubit_metadata::FilterExpression;

let expression = FilterExpression::builder()
    .eq("tenant", "acme")
    .and_group(|group| group.exists("region").ne("region", "blocked"))
    .build()?;

pub fn or_group<F>(self, build: F) -> Self

where F: FnOnce(Self) -> Self,

Appends a grouped expression with logical OR.

Type Parameters

• F - Callback that visits operands or constructs a nested group.

Parameters

• build - Callback that constructs the nested group.

Examples

use qubit_metadata::{
    FilterExpression,
    Metadata,
    MetadataFilter,
};

let expression = FilterExpression::builder()
    .eq("tenant", "acme")
    .or_group(|group| {
        group
            .eq("priority", 1_i64)
            .or_group(|alternative| alternative.eq("priority", 2_i64))
    })
    .build()?;
let filter = MetadataFilter::builder()
    .expression(expression)
    .build()?;
let metadata = Metadata::new()
    .with("tenant", "other")
    .with("priority", 2_i64);

assert!(filter.matches(&metadata));

pub fn not(self) -> Self

Negates the expression built so far.

Examples

use qubit_metadata::FilterExpression;

let expression = FilterExpression::builder()
    .eq("state", "deleted")
    .not()
    .build()?;

Trait Implementations

impl Clone for FilterExpressionBuilder

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FilterExpressionBuilder

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

Formats the value using the given formatter.

impl Default for FilterExpressionBuilder

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for FilterExpressionBuilder

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for FilterExpressionBuilder