Enum QueryError 

pub enum QueryError {
    Lex(LexError),
    Parse(ParseError),
    Validation(ValidationError),
    Execution(ExecutionError),
    Cancelled,
}

Top-level query error encompassing all error types

Variants

Lex(LexError)

Lexical analysis error

Parse(ParseError)

Parsing error

Validation(ValidationError)

Validation error

Execution(ExecutionError)

Execution error

Cancelled

Cooperative cancellation observed inside the query evaluator (per A_cancellation.md §4 + 00_contracts.md §3.CC-1).

This variant is constructed by crate::query::cancellation::CancellationToken::query_check when an MCP / IPC dispatch wrapper has flipped the per-request cancellation flag because the deadline elapsed (or, in the future, because an admin cancel IPC arrived). It is distinct from ExecutionError::Cancelled, which is reserved for the LSP $/cancelRequest path. Wrapper boundaries downcast against this variant to map to the canonical RpcError::deadline_exceeded envelope.

Implementations

impl QueryError

pub fn exit_code(&self) -> i32

Get CLI exit code for this error

Returns:

• 2 for syntax/validation errors (user input errors)
• 1 for execution errors (system/runtime errors)

pub fn with_source(self, source: impl Into<String>) -> RichQueryError

Wrap this error with source code context for rich diagnostics

Trait Implementations

impl Debug for QueryError

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

Formats the value using the given formatter.

impl Display for QueryError

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

Formats the value using the given formatter.

impl Error for QueryError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<ExecutionError> for QueryError

fn from(source: ExecutionError) -> Self

Converts to this type from the input type.

impl From<LexError> for QueryError

fn from(source: LexError) -> Self

Converts to this type from the input type.

impl From<ParseError> for QueryError

fn from(source: ParseError) -> Self

Converts to this type from the input type.

impl From<ValidationError> for QueryError

fn from(source: ValidationError) -> Self

Converts to this type from the input type.