Enum GfError 

pub enum GfError {
    NotImplemented(&'static str),
    Parse {
        msg: String,
        span: Span,
    },
    Bind {
        msg: String,
        span: Span,
    },
    Plan(String),
    Execution(String),
    Provider {
        class: String,
        provider: String,
        model: String,
    },
    Storage(String),
    Project {
        code: ProjectErrorCode,
        message: String,
    },
    Api {
        code: ApiErrorCode,
        message: String,
    },
    Lifecycle(String),
    Validation(String),
    Ontology(String),
}

All errors produced by GraphForge.

Variant names correspond 1-to-1 with the Python exception hierarchy in graphforge.exceptions so that binding layers can map them without string-matching.

Variants

NotImplemented(&'static str)

Feature exists in the API but has not been implemented yet.

Parse

The Cypher parser rejected the input.

Fields

msg: String

Human-readable description of the parse failure.

span: Span

Location of the bad token in the source.

Bind

The binder rejected the query (e.g. undeclared variable, strict-mode unknown label). Carries the source span of the first error so callers can point at the offending token; msg lists every binder error. Shares the PlanError fault domain with GfError::Plan in the binding layers — it is the span-rich sibling for binder-phase failures.

Fields

msg: String

Human-readable description (all binder errors, joined with ; ).

span: Span

Source location of the first offending token.

Plan(String)

The binder or query planner could not produce a valid plan.

Execution(String)

A runtime fault occurred during query execution.

Provider

A redacted configured-provider invocation failed.

Fields

class: String

Stable provider failure class.

provider: String

Normalized non-secret provider identifier.

model: String

Non-secret model identifier.

Storage(String)

A storage I/O operation failed.

Project

The project container cannot be resolved safely.

Fields

code: ProjectErrorCode

Stable public error code.

message: String

Safe diagnostic without participant contents or unrestricted paths.

Api

A structured M20/M21 public API failure.

Fields

code: ApiErrorCode

Stable closed public error code.

message: String

Safe diagnostic without record contents.

Lifecycle(String)

An operation was invalid for the current instance lifecycle state.

Validation(String)

Input failed validation at the API boundary.

Ontology(String)

An ontology file could not be loaded or applied.

Implementations

impl GfError

pub const fn code(&self) -> &'static str

Return the stable public error code for this failure.

Trait Implementations

impl Debug for GfError

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

Formats the value using the given formatter.

impl Display for GfError

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

Formats the value using the given formatter.

impl Error for GfError

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.