Struct FluentFilterBuilder 

pub struct FluentFilterBuilder { /* private fields */ }

A fluent builder for constructing filters with a convenient API.

This builder collects conditions and can produce either an AND or OR filter.

Examples

use prax_query::filter::Filter;

// Build an AND filter
let filter = Filter::builder()
    .eq("active", true)
    .gt("score", 100)
    .contains("email", "@example.com")
    .build_and();

// Build an OR filter with capacity hint
let filter = Filter::builder()
    .with_capacity(3)
    .eq("role", "admin")
    .eq("role", "moderator")
    .eq("role", "owner")
    .build_or();

Implementations

impl FluentFilterBuilder

pub fn new() -> Self

Create a new fluent builder.

pub fn with_capacity(self, capacity: usize) -> Self

Set the capacity hint for the internal vector.

pub fn eq<F, V>(self, field: F, value: V) -> Self

where F: Into<FieldName>, V: Into<FilterValue>,

Add an equals filter.

pub fn ne<F, V>(self, field: F, value: V) -> Self

where F: Into<FieldName>, V: Into<FilterValue>,

Add a not equals filter.

pub fn lt<F, V>(self, field: F, value: V) -> Self

where F: Into<FieldName>, V: Into<FilterValue>,

Add a less than filter.

pub fn lte<F, V>(self, field: F, value: V) -> Self

where F: Into<FieldName>, V: Into<FilterValue>,

Add a less than or equal filter.

pub fn gt<F, V>(self, field: F, value: V) -> Self

where F: Into<FieldName>, V: Into<FilterValue>,

Add a greater than filter.

pub fn gte<F, V>(self, field: F, value: V) -> Self

where F: Into<FieldName>, V: Into<FilterValue>,

Add a greater than or equal filter.

pub fn is_in<F, I, V>(self, field: F, values: I) -> Self

where F: Into<FieldName>, I: IntoIterator<Item = V>, V: Into<FilterValue>,

Add an IN filter.

pub fn not_in<F, I, V>(self, field: F, values: I) -> Self

where F: Into<FieldName>, I: IntoIterator<Item = V>, V: Into<FilterValue>,

Add a NOT IN filter.

pub fn contains<F, V>(self, field: F, value: V) -> Self

where F: Into<FieldName>, V: Into<FilterValue>,

Add a contains filter (LIKE %value%).

pub fn starts_with<F, V>(self, field: F, value: V) -> Self

where F: Into<FieldName>, V: Into<FilterValue>,

Add a starts with filter (LIKE value%).

pub fn ends_with<F, V>(self, field: F, value: V) -> Self

where F: Into<FieldName>, V: Into<FilterValue>,

Add an ends with filter (LIKE %value).

pub fn is_null<F>(self, field: F) -> Self

where F: Into<FieldName>,

Add an IS NULL filter.

pub fn is_not_null<F>(self, field: F) -> Self

where F: Into<FieldName>,

Add an IS NOT NULL filter.

pub fn filter(self, filter: Filter) -> Self

Add a raw filter directly.

pub fn filter_if(self, condition: bool, filter: Filter) -> Self

Add a filter conditionally.

pub fn filter_if_some<F>(self, opt: Option<F>) -> Self

where F: Into<Filter>,

Add a filter conditionally if the option is Some.

pub fn build_and(self) -> Filter

Build an AND filter from all collected conditions.

pub fn build_or(self) -> Filter

Build an OR filter from all collected conditions.

pub fn len(&self) -> usize

Get the current number of filters.

pub fn is_empty(&self) -> bool

Check if the builder is empty.

Trait Implementations

impl Clone for FluentFilterBuilder

fn clone(&self) -> FluentFilterBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FluentFilterBuilder

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

Formats the value using the given formatter.

impl Default for FluentFilterBuilder

fn default() -> Self

Returns the “default value” for a type.