Struct QueryBuilder 

pub struct QueryBuilder { /* private fields */ }

Modern query builder with type-safe method chaining Provides a clean, Swift-like API for building HTTP query parameters

Implementations

impl QueryBuilder

pub fn new() -> Self

Create a new query parameter builder

pub fn string(self, key: &str, value: impl Into<Option<String>>) -> Self

Add a string parameter (accept both required/optional)

pub fn int(self, key: &str, value: impl Into<Option<i64>>) -> Self

Add an integer parameter (accept both required/optional)

pub fn float(self, key: &str, value: impl Into<Option<f64>>) -> Self

Add a float parameter

pub fn bool(self, key: &str, value: impl Into<Option<bool>>) -> Self

Add a boolean parameter

pub fn datetime( self, key: &str, value: impl Into<Option<DateTime<Utc>>>, ) -> Self

Add a datetime parameter

pub fn uuid(self, key: &str, value: impl Into<Option<Uuid>>) -> Self

Add a UUID parameter (converts to string)

pub fn date(self, key: &str, value: impl Into<Option<NaiveDate>>) -> Self

Add a date parameter (converts NaiveDate to DateTime<Utc>)

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

Add any serializable parameter (for enums and complex types)

pub fn structured_query( self, key: &str, value: impl Into<Option<String>>, ) -> Self

Parse and add a structured query string Handles complex query patterns like:

• “key:value” patterns
• “key:value1,value2” (comma-separated values)
• Quoted values: “key:"value with spaces"”
• Space-separated terms (treated as AND logic)

pub fn build(self) -> Option<Vec<(String, String)>>

Build the final query parameters

Trait Implementations

impl Debug for QueryBuilder

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

Formats the value using the given formatter.

impl Default for QueryBuilder

fn default() -> QueryBuilder

Returns the “default value” for a type.