Enum SurqlError 

pub enum SurqlError {
    Database {
        reason: String,
    },
    Connection {
        reason: String,
    },
    Query {
        reason: String,
    },
    Transaction {
        reason: String,
    },
    Context {
        reason: String,
    },
    Registry {
        reason: String,
    },
    Streaming {
        reason: String,
    },
    Validation {
        reason: String,
    },
    SchemaParse {
        reason: String,
    },
    MigrationDiscovery {
        reason: String,
    },
    MigrationLoad {
        reason: String,
    },
    MigrationGeneration {
        reason: String,
    },
    MigrationExecution {
        reason: String,
    },
    MigrationHistory {
        reason: String,
    },
    MigrationSquash {
        reason: String,
    },
    MigrationWatcher {
        reason: String,
    },
    Orchestration {
        reason: String,
    },
    Serialization {
        reason: String,
    },
    Io {
        reason: String,
    },
    WithContext {
        source: Box<SurqlError>,
        context: String,
    },
}

Unified error type for the surql crate.

Each variant corresponds to one subsystem. Variants can be wrapped with additional context via Context::context.

Variants

Database

General database error (analogue of Python DatabaseError).

Fields

reason: String

Human-readable explanation.

Connection

Connection failed, timed out, or was closed unexpectedly.

Fields

reason: String

Human-readable explanation.

Query

A query failed at the database or during result decoding.

Fields

reason: String

Human-readable explanation.

Transaction

A transaction could not be started, committed, or rolled back.

Fields

reason: String

Human-readable explanation.

Context

Ambient connection context was missing or misconfigured.

Fields

reason: String

Human-readable explanation.

Registry

Named-connection registry lookup or registration failed.

Fields

reason: String

Human-readable explanation.

Streaming

Live/streaming query error.

Fields

reason: String

Human-readable explanation.

Validation

Input failed validation (invalid identifier, malformed id, etc.).

Fields

reason: String

Human-readable explanation.

SchemaParse

Schema parser could not understand the schema text or response.

Fields

reason: String

Human-readable explanation.

MigrationDiscovery

Error while discovering migration files on disk.

Fields

reason: String

Human-readable explanation.

MigrationLoad

Error while loading an individual migration.

Fields

reason: String

Human-readable explanation.

MigrationGeneration

Error while generating a migration from a schema diff.

Fields

reason: String

Human-readable explanation.

MigrationExecution

Error while executing a migration against the database.

Fields

reason: String

Human-readable explanation.

MigrationHistory

Error while reading or writing migration history.

Fields

reason: String

Human-readable explanation.

MigrationSquash

Error while squashing migrations.

Fields

reason: String

Human-readable explanation.

MigrationWatcher

Error raised by the schema file watcher.

Fields

reason: String

Human-readable explanation.

Orchestration

Multi-environment orchestration failed.

Fields

reason: String

Human-readable explanation.

Serialization

JSON encode or decode failure.

Fields

reason: String

Human-readable explanation.

Io

Filesystem / generic I/O error.

Fields

reason: String

Human-readable explanation.

WithContext

An existing SurqlError with extra context prepended.

Fields

source: Box<SurqlError>

Underlying error.

context: String

Context description added at the call site.

Trait Implementations

impl Clone for SurqlError

fn clone(&self) -> SurqlError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SurqlError

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

Formats the value using the given formatter.

impl Display for SurqlError

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

Formats the value using the given formatter.

impl Error for SurqlError

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<Error> for SurqlError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SurqlError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SurqlError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl PartialEq for SurqlError

fn eq(&self, other: &SurqlError) -> 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 Eq for SurqlError

impl StructuralPartialEq for SurqlError