Enum Error 

#[non_exhaustive]
pub enum Error {
    Turso {
        kind: ErrorKind,
        source: Error,
    },
    Remote {
        kind: ErrorKind,
        source: Error,
    },
    PoolTimeout,
    Decode {
        column: String,
        ty: &'static str,
        reason: String,
    },
    Encode(String),
    NotFound,
    InvalidOptions(String),
    Misuse(String),
    Custom(String),
}

The crate’s error type.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Turso

An error reported by the Turso engine, already classified.

Fields

kind: ErrorKind

The classification.

source: Error

The engine error.

Remote

Available on crate feature serverless only.

An error reported by the serverless client, already classified.

Fields

kind: ErrorKind

The classification.

source: Error

The client error.

PoolTimeout

No pooled connection became free within the acquire timeout.

Decode

A column could not be decoded into the requested Rust type.

Fields

column: String

The column name or index, as the caller asked for it.

ty: &'static str

The requested Rust type.

reason: String

Why the conversion failed.

Encode(String)

A value could not be encoded as a parameter.

NotFound

A query returned no row where one was required.

InvalidOptions(String)

The connect options are contradictory or unsupported.

Misuse(String)

The API was used in a way it cannot honour.

Custom(String)

A free-form error, for callers layering on top of this crate.

Implementations

impl Error

pub fn kind(&self) -> ErrorKind

Classifies the error.

pub fn is_busy(&self) -> bool

Whether the error is transient lock contention worth retrying.

pub fn constraint(&self) -> Option<ConstraintKind>

The constraint kind, when this is a constraint violation.

pub fn decode( column: impl Display, ty: &'static str, reason: impl Display, ) -> Self

Builds a decoding error for column and the requested type.

Public so that hand-written and derived FromValue impls report failures in the same shape as the built-in decoders.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature serverless only.

Classifies a serverless client error by variant, falling back to its message the same way as for the engine. HTTP failures count as connection errors: the statement never reached the database.

fn from(source: Error) -> Self

Converts to this type from the input type.