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, or MetadataError::FilterLimitExceeded for oversized trees.

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

where T: Into<Value>,

Appends key == value with logical AND.

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

where T: Into<Value>,

Appends key != value with logical AND.

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

where T: Into<Value>,

Appends key < value with logical AND.

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

where T: Into<Value>,

Appends key <= value with logical AND.

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

where T: Into<Value>,

Appends key > value with logical AND.

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

where T: Into<Value>,

Appends key >= value with logical AND.

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.

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.

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

Appends an existence predicate with logical AND.

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

Appends a non-existence predicate with logical AND.

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

where F: FnOnce(Self) -> Self,

Appends a grouped expression with logical AND.

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.

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) -> FilterExpressionBuilder

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() -> FilterExpressionBuilder

Returns the “default value” for a type.

impl PartialEq for FilterExpressionBuilder

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for FilterExpressionBuilder