Enum Error 

#[non_exhaustive]
pub enum Error {
    Invalid(Error),
    NotLater {
        what: &'static str,
        key: String,
        given: String,
        latest: String,
    },
    NotFound {
        what: &'static str,
        key: String,
    },
    Mismatch {
        what: &'static str,
        expected: String,
        found: String,
    },
    Conflict {
        hash: String,
    },
    Database(DatabaseError),
    PoolTimeout,
    Migration(String),
    Config(String),
}

What a Store method or a migration can fail with.

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.

Invalid(Error)

The core rejected the input: not canonical, not a receipt, a receipt that does not verify against the stored key document, not an instant or hash, a key document that does not satisfy SPEC 9.2, … The core’s error carries its code (Error::code), JSON path and detail.

NotLater

An append-only history refused a time that is not later than its latest entry: put_version (what = "version", key = the cell id), bind_name ("name", the function name) or put_namespace ("namespace", the host; equal is allowed there).

Fields

what: &'static str

"version", "name" or "namespace".

key: String

The cell id, function name or host.

given: String

The time given.

latest: String

The latest time already recorded.

NotFound

Something the write refers to is not in the store: the receipt of a version, the descriptor of a name binding.

Fields

what: &'static str

"receipt" or "descriptor".

key: String

Its hash.

Mismatch

The receipt named by put_version is for another cell, or has another tx.

Fields

what: &'static str

"cell_id" or "tx".

expected: String

The value given to put_version.

found: String

The receipt’s value.

Conflict

A receipt with this hash is stored with other bytes: the same payload with another valid signature by the same key (the receipt hash does not cover sig; it covers computed_by, so a rotated key gives another hash). Only a randomised signer makes two valid signatures; RFC 8032 Ed25519 is deterministic. The stored receipt is kept.

Fields

hash: String

The receipt hash.

Database(DatabaseError)

The database refused or failed: the server’s message and SQLSTATE (PostgreSQL) or SQLite’s message and result code, or the driver’s description of a failure that is not the database’s (no connection, a URL that does not parse, a TLS handshake refused, a certificate that did not verify).

PoolTimeout

No connection became free within the pool’s checkout timeout.

Migration(String)

A migration could not be applied or checked.

Config(String)

A connection option is unusable: a root certificate bundle (PoolOptions::tls_root_certificates_pem) with no certificate, or one that does not parse.

Implementations

impl Error

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

The core’s error code, for Error::Invalid.

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, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

For Error::Database, the driver’s error (as in 0.1.0; the DatabaseError is this error’s own text, so a chain of sources does not repeat it).

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(e: Error) -> Error

Converts to this type from the input type.