Struct CalQuery 

pub struct CalQuery {
    pub version: CalVersion,
    pub statement: CalStatement,
    pub pipeline: Vec<PipelineStage>,
    pub with_options: Vec<WithOption>,
    pub format: Option<FormatClause>,
    pub let_bindings: Vec<LetBinding>,
    pub user_vars: HashMap<String, String>,
    pub let_values: HashMap<String, Vec<String>>,
    pub warnings: Vec<CalWarning>,
}

A fully parsed CAL query — version prefix + statement + optional pipeline.

Fields

version: CalVersion

Explicit version prefix, if present. Defaults to CAL/1.

statement: CalStatement

The core statement.

pipeline: Vec<PipelineStage>

Pipeline stages applied after the statement (| SELECT ..., etc.).

with_options: Vec<WithOption>

WITH options (e.g. WITH superseded, WITH score_breakdown).

format: Option<FormatClause>

FORMAT spec (e.g. FORMAT json, FORMAT [markdown, json]).

let_bindings: Vec<LetBinding>

LET bindings extracted before the statement (e.g. LET $x = SUBJECTS OF (...)).

user_vars: HashMap<String, String>

WITH VARS { "key": "value", ... } — user-injected display variables.

These are string-only values accessible in FORMAT TEMPLATE via {{$key}} syntax. They do NOT affect query execution — display only.

let_values: HashMap<String, Vec<String>>

LET bindings after evaluation, keyed by name without the $.

Execution state, not query text, so it is never serialized: the parser leaves this empty and the executor fills it once the bindings have run. It exists because $friends in WHERE subject IN $friends has to become a list of values somewhere, and threading a scope object through every statement executor to do it would touch far more surface than carrying the answer on the query does.

warnings: Vec<CalWarning>

Warnings emitted during parsing (non-fatal).

Trait Implementations

impl Clone for CalQuery

fn clone(&self) -> CalQuery

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CalQuery

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CalQuery

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CalQuery

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for CalQuery

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CalQuery