Enum Error 

pub enum Error {
    Connection(String),
    Query {
        code: String,
        message: String,
    },
    Auth(String),
    Io(Error),
    Json(Error),
    Quic(String),
    Tls(String),
    InvalidDsn(String),
    Type(String),
    Timeout,
    Pool(String),
    Validation(String),
    Limit(String),
    Other(String),
}

Error types that can occur when using the Geode client

Variants

Connection(String)

Connection error

Query

Query execution error

Fields

code: String

message: String

Auth(String)

Authentication error

Io(Error)

I/O error

Json(Error)

JSON serialization/deserialization error

Quic(String)

QUIC connection error

Tls(String)

TLS error

InvalidDsn(String)

Invalid DSN format

Type(String)

Type conversion error

Timeout

Timeout error

Pool(String)

Pool error

Validation(String)

Input validation error

Limit(String)

Client-side limit exceeded (frame size, rows, depth, etc.)

Other(String)

Generic error

Implementations

impl Error

pub fn connection<S: Into<String>>(msg: S) -> Self

Create a connection error

pub fn query<S: Into<String>>(msg: S) -> Self

Create a query error

pub fn protocol<S: Into<String>>(msg: S) -> Self

Create a protocol error

pub fn transaction<S: Into<String>>(msg: S) -> Self

Create a transaction error

pub fn timeout() -> Self

Create a timeout error

pub fn auth<S: Into<String>>(msg: S) -> Self

Create an auth error

pub fn quic<S: Into<String>>(msg: S) -> Self

Create a QUIC error

pub fn tls<S: Into<String>>(msg: S) -> Self

Create a TLS error

pub fn type_error<S: Into<String>>(msg: S) -> Self

Create a type error

pub fn pool<S: Into<String>>(msg: S) -> Self

Create a pool error

pub fn validation<S: Into<String>>(msg: S) -> Self

Create a validation error

pub fn limit<S: Into<String>>(msg: S) -> Self

Create a client limit error

pub fn invalid_dsn<S: Into<String>>(msg: S) -> Self

Create an invalid DSN error

pub fn is_retryable(&self) -> bool

Check if the error is retryable

Retryable errors are transient failures that may succeed on retry:

• Connection errors (network issues)
• Timeout errors
• QUIC errors (connection reset, etc.)
• Query errors with serialization failure codes (40001, 40P01)

pub fn code(&self) -> Option<&str>

Get the error code if this is a query error

pub fn is_auth_error(&self) -> bool

Reports whether this is a Geode authentication or authorization failure.

Returns true for query errors carrying the ISO/IEC 39075 status class 28000 (authorization error) or the Geode-specific 08P01 (password reset required) extension. Mirrors the Go reference client’s IsAuthError.

pub fn is_syntax_error(&self) -> bool

Reports whether this is a GQL parse or syntax error (status class 42000).

The Geode engine returns 42000 for unrecognised statements, including admin DDL verbs not yet implemented in the connected server build, so handlers can use this to degrade gracefully. Mirrors the Go reference client’s IsSyntaxError.

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

fn from(source: Error) -> Self

Converts to this type from the input type.