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 string_array<I, T>(self, key: &str, values: I) -> Self

where I: IntoIterator<Item = T>, T: Into<Option<String>>,

Add multiple string parameters with the same key (for allow-multiple query params) Accepts both Vec and Vec<Option>, adding each non-None value as a separate query parameter

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

Add an integer parameter (accept both required/optional)

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

where I: IntoIterator<Item = T>, T: Into<Option<i64>>,

Add multiple integer parameters with the same key (for allow-multiple query params) Accepts both Vec and Vec<Option>, adding each non-None value as a separate query parameter

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

Add a float parameter

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

where I: IntoIterator<Item = T>, T: Into<Option<f64>>,

Add multiple float parameters with the same key (for allow-multiple query params) Accepts both Vec and Vec<Option>, adding each non-None value as a separate query parameter

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

Add a boolean parameter

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

where I: IntoIterator<Item = T>, T: Into<Option<bool>>,

Add multiple boolean parameters with the same key (for allow-multiple query params) Accepts both Vec and Vec<Option>, adding each non-None value as a separate query parameter

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

where Tz::Offset: Display,

Add a datetime parameter (any DateTime timezone)

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

Add a date parameter (converts NaiveDate to DateTime)

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

Add any serializable parameter (for enums and complex types)

pub fn serialize_array<T: Serialize>( self, key: &str, values: impl IntoIterator<Item = T>, ) -> Self

Add multiple serializable parameters with the same key (for allow-multiple query params with enums) Accepts both Vec and Vec<Option>, adding each non-None value as a separate query parameter

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.