Struct SearchFilter 

pub struct SearchFilter {

    pub filters: Vec<FilterExpr>,
    pub sort_field: Option<String>,
    pub sort_desc: bool,
    pub callsign: Option<String>,
    pub name: Option<String>,
    pub city: Option<String>,
    pub state: Option<String>,
    pub zip_code: Option<String>,
    pub radio_service: Option<Vec<String>>,
    pub status: Option<char>,
    pub operator_class: Option<char>,
    pub active_only: bool,
    pub frn: Option<String>,
    pub limit: Option<usize>,
    pub offset: Option<usize>,
    pub sort: SortOrder,
    pub granted_after: Option<String>,
    pub granted_before: Option<String>,
    pub expires_before: Option<String>,
}

Filter criteria for license searches.

Fields

filters: Vec<FilterExpr>

Generic filter expressions (e.g., “grant_date>2025-01-01”, “state=TX”).

sort_field: Option<String>

Sort by field name (prefix with - for descending).

sort_desc: bool

Sort direction (true = descending).

callsign: Option<String>

Filter by callsign pattern (supports wildcards).

name: Option<String>

Filter by name (partial match).

city: Option<String>

Filter by city.

state: Option<String>

Filter by state (2-letter code).

zip_code: Option<String>

Filter by ZIP code.

radio_service: Option<Vec<String>>

Filter by radio service code(s).

status: Option<char>

Filter by license status (A=Active, E=Expired, etc.).

operator_class: Option<char>

Filter by operator class (for amateur).

active_only: bool

Only include active licenses.

frn: Option<String>

FRN filter.

limit: Option<usize>

Maximum results to return.

offset: Option<usize>

Number of results to skip (for pagination).

sort: SortOrder

Sort order (legacy enum, use sort_field for generic).

granted_after: Option<String>

Filter by grant date (licenses granted on or after this date).

granted_before: Option<String>

Filter by grant date (licenses granted on or before this date).

expires_before: Option<String>

Filter by expiration date (licenses expiring on or before this date).

Implementations

impl SearchFilter

pub fn new() -> Self

Create an empty filter.

pub fn callsign(callsign: impl Into<String>) -> Self

Create a filter for callsign lookup.

pub fn name(name: impl Into<String>) -> Self

Create a filter for name search.

pub fn location(city: Option<String>, state: Option<String>) -> Self

Create a filter for location search.

pub fn with_limit(self, limit: usize) -> Self

Set the maximum results.

pub fn with_offset(self, offset: usize) -> Self

Set pagination offset.

pub fn active_only(self) -> Self

Only include active licenses.

pub fn with_state(self, state: impl Into<String>) -> Self

Filter by state.

pub fn with_operator_class(self, class: char) -> Self

Filter by operator class.

pub fn with_sort(self, sort: SortOrder) -> Self

Set sort order.

pub fn with_filter(self, expr: impl AsRef<str>) -> Self

Add a generic filter expression (e.g., “grant_date>2025-01-01”).

pub fn with_sort_field(self, field: impl Into<String>) -> Self

Set sort field by name (prefix with - for descending).

pub fn to_where_clause(&self) -> (String, Vec<String>)

Build the SQL WHERE clause for this filter.

pub fn order_clause(&self) -> String

Get the ORDER BY clause.

pub fn limit_clause(&self) -> String

Get the LIMIT clause.

Trait Implementations

impl Clone for SearchFilter

fn clone(&self) -> SearchFilter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SearchFilter

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

Formats the value using the given formatter.

impl Default for SearchFilter

fn default() -> SearchFilter

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SearchFilter

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SearchFilter

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.