Struct QqlError 

pub struct QqlError {
    pub kind: ErrorKind,
    pub code: Cow<'static, str>,
    pub message: Cow<'static, str>,
    pub span: Option<Span>,
    pub fields: Vec<ErrorField>,
    pub source: Option<Box<QqlError>>,
}

Unified error type for the entire QQL pipeline.

Every error carries:

• a broad ErrorKind category,
• a machine-readable code (e.g. QQL-EDGE-COLLECTION-NOT-FOUND),
• a human-readable message,
• an optional source-code Span,
• optional structured ErrorFields for machine-readable context, and
• an optional causal source error for chaining.

Fields

kind: ErrorKind

Broad origin category within the pipeline.

code: Cow<'static, str>

Machine-readable error code, e.g. QQL-PARSE-SYNTAX.

message: Cow<'static, str>

Human-readable description of the failure.

span: Option<Span>

Optional source span in the original query text.

fields: Vec<ErrorField>

Structured key-value metadata providing machine-readable context (e.g. collection, status_code, field_name, url).

source: Option<Box<QqlError>>

Causal error that led to this one (error chaining).

Implementations

impl QqlError

pub fn new( kind: ErrorKind, code: impl Into<Cow<'static, str>>, message: impl Into<Cow<'static, str>>, span: Option<Span>, ) -> Self

Build an error with an explicit kind, code, message, and optional span.

pub fn lex( code: impl Into<Cow<'static, str>>, message: impl Into<Cow<'static, str>>, span: Span, ) -> Self

Create an error with ErrorKind::Lex and the given source span.

pub fn parse( code: impl Into<Cow<'static, str>>, message: impl Into<Cow<'static, str>>, span: Span, ) -> Self

Create an error with ErrorKind::Parse and the given source span.

pub fn validation( code: impl Into<Cow<'static, str>>, message: impl Into<Cow<'static, str>>, span: Option<Span>, ) -> Self

Create an error with ErrorKind::Validation and an optional span.

pub fn execution( code: impl Into<Cow<'static, str>>, message: impl Into<Cow<'static, str>>, span: Option<Span>, ) -> Self

Create an error with ErrorKind::Execution and an optional span.

pub fn transport( code: impl Into<Cow<'static, str>>, message: impl Into<Cow<'static, str>>, span: Option<Span>, ) -> Self

Create an error with ErrorKind::Transport and an optional span.

pub fn backend( code: impl Into<Cow<'static, str>>, message: impl Into<Cow<'static, str>>, span: Option<Span>, ) -> Self

Create an error with ErrorKind::Backend and an optional span.

pub fn with_field( self, key: impl Into<Cow<'static, str>>, value: impl Into<Cow<'static, str>>, ) -> Self

Attach a structured key-value metadata field.

let err = QqlError::backend("QQL-BACKEND", "unexpected status", None)
    .with_field("status_code", "404")
    .with_field("collection", "my_collection");
assert_eq!(err.field("status_code"), Some("404"));
assert_eq!(err.field("collection"), Some("my_collection"));

pub fn with_collection(self, name: impl Into<Cow<'static, str>>) -> Self

Shorthand for .with_field("collection", name).

pub fn with_status(self, code: u16) -> Self

Shorthand for .with_field("status_code", code).

pub fn with_url(self, url: impl Into<Cow<'static, str>>) -> Self

Shorthand for .with_field("url", url).

pub fn with_field_name(self, name: impl Into<Cow<'static, str>>) -> Self

Shorthand for .with_field("field_name", name).

pub fn with_index_name(self, name: impl Into<Cow<'static, str>>) -> Self

Shorthand for .with_field("index_name", name).

pub fn with_vector_name(self, name: impl Into<Cow<'static, str>>) -> Self

Shorthand for .with_field("vector_name", name).

pub fn with_model(self, name: impl Into<Cow<'static, str>>) -> Self

Shorthand for .with_field("model", name).

pub fn with_span(self, span: Span) -> Self

Attach an optional source-code span.

pub fn caused_by(self, source: QqlError) -> Self

Chain a causal error.

The source error will be displayed when the outer error is printed and is accessible via std::error::Error::source.

pub fn field(&self, key: &str) -> Option<&str>

Look up the first value for a given metadata key, case-insensitive.

Trait Implementations

impl Clone for QqlError

fn clone(&self) -> QqlError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QqlError

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

Formats the value using the given formatter.

impl Display for QqlError

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

Formats the value using the given formatter.

impl Eq for QqlError

impl Error for QqlError

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 PartialEq for QqlError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for QqlError