Enum QueryNode 

#[non_exhaustive]
pub enum QueryNode {
    Text(String),
    Exact(String),
    Phrase(String),
    Field {
        field: QueryField,
        value: String,
    },
    Filter(FilterKind),
    Label(String),
    DateRange {
        bound: DateBound,
        date: DateValue,
    },
    Size {
        op: SizeOp,
        bytes: u64,
    },
    Near {
        left: String,
        right: String,
        distance: u32,
    },
    And(Box<QueryNode>, Box<QueryNode>),
    Or(Box<QueryNode>, Box<QueryNode>),
    Not(Box<QueryNode>),
}

Root AST node for a parsed query.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Text(String)

A bare term. Subject to the backend’s tokenizer/stemmer.

Exact(String)

+word — exact-match form, the backend should disable stemming for this term. New in v0.1.0; mirrors Gmail’s +word semantics.

Phrase(String)

"quoted phrase" — multi-word phrase.

Field

field:value — e.g. from:alice, subject:invoice.

Fields

field: QueryField

value: String

Filter(FilterKind)

is:unread, has:attachment, etc. See FilterKind.

Label(String)

label:work, category:promotions (categories normalise to canonical CATEGORY_* labels).

DateRange

after:2024-01-01, older_than:5d, date:today, etc. The Relative variant deliberately is not resolved to a concrete date at parse time — backends call ParserOptions::now_provider to evaluate it. See the README for the rationale.

Fields

bound: DateBound

date: DateValue

Size

size:>5M, larger:200K, etc.

Fields

op: SizeOp

bytes: u64

Near

foo AROUND 3 bar — word proximity.

Fields

left: String

right: String

distance: u32

And(Box<QueryNode>, Box<QueryNode>)

Conjunction. parse builds left-associative trees.

Or(Box<QueryNode>, Box<QueryNode>)

Disjunction. Left-associative.

Not(Box<QueryNode>)

-foo or NOT foo.

Trait Implementations

impl Clone for QueryNode

fn clone(&self) -> QueryNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QueryNode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for QueryNode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for QueryNode

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

Formats the value using the given formatter.

impl PartialEq for QueryNode

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for QueryNode

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for QueryNode

impl StructuralPartialEq for QueryNode