Enum bonsaidb_core::Error

pub enum Error {
    SchemaMismatch {
        database_name: String,
        schema: SchemaName,
        stored_schema: SchemaName,
    },
    SchemaAlreadyRegistered(SchemaName),
    SchemaNotRegistered(SchemaName),
    InvalidDatabaseName(String),
    DatabaseNotFound(String),
    DatabaseNameAlreadyTaken(String),
    Database(String),
    Serialization(String),
    Server(String),
    Transport(String),
    Websocket(String),
    Networking(Error),
    Io(String),
    Configuration(String),
    Client(String),
    CollectionNotFound,
    CollectionAlreadyDefined,
    DocumentNotFound(CollectionName, u64),
    DocumentConflict(CollectionName, u64),
    UniqueKeyViolation {
        view: ViewName,
        conflicting_document: Header,
        existing_document: Header,
    },
    InvalidName(InvalidNameError),
    PermissionDenied(PermissionDenied),
    Password(String),
    UserNotFound,
    InvalidUnicode(String),
    InvalidCredentials,
    ReduceUnimplemented,
    NotANumber,
}

an enumeration of errors that this crate can produce

Variants

SchemaMismatch

Fields

database_name: String

The name of the database being accessed.

schema: SchemaName

The schema provided for the database.

stored_schema: SchemaName

The schema stored for the database.

The database named database_name was created with a different schema (stored_schema) than provided (schema).

SchemaAlreadyRegistered(SchemaName)

The SchemaName returned has already been registered.

SchemaNotRegistered(SchemaName)

The SchemaName requested was not registered.

InvalidDatabaseName(String)

An invalid database name was specified. See StorageConnection::create_database() for database name requirements.

DatabaseNotFound(String)

The database name given was not found.

DatabaseNameAlreadyTaken(String)

The database name already exists.

Database(String)

An error from interacting with local storage.

Serialization(String)

An error serializing data.

Server(String)

An error from interacting with a server.

Transport(String)

An error occurred from the QUIC transport layer.

Websocket(String)

An error occurred from the websocket transport layer.

Networking(Error)

An error occurred from networking.

Io(String)

An error occurred from IO.

Configuration(String)

An error occurred with the provided configuration options.

Client(String)

An error occurred inside of the client.

CollectionNotFound

An attempt to use a Collection with a Database that it wasn’t defined within.

CollectionAlreadyDefined

A Collection being added already exists. This can be caused by a collection name not being unique.

DocumentNotFound(CollectionName, u64)

An attempt to update a document that doesn’t exist.

DocumentConflict(CollectionName, u64)

When updating a document, if a situation is detected where the contents have changed on the server since the Revision provided, a Conflict error will be returned.

UniqueKeyViolation

Fields

view: ViewName

The name of the view that the unique key violation occurred.

conflicting_document: Header

The document that caused the violation.

existing_document: Header

The document that already uses the same key.

When saving a document in a collection with unique views, a document emits a key that is already emitted by an existing ocument, this error is returned.

InvalidName(InvalidNameError)

An invalid name was specified during schema creation.

PermissionDenied(PermissionDenied)

Permission was denied.

Password(String)

An internal error handling passwords was encountered.

UserNotFound

The user specified was not found. This will not be returned in response to an invalid username being used during login. It will be returned in other APIs that operate upon users.

InvalidUnicode(String)

An error occurred converting from bytes to Utf-8.

InvalidCredentials

The credentials specified are not valid.

ReduceUnimplemented

Returned when the a view’s reduce() function is unimplemented.

NotANumber

A floating point operation yielded Not a Number.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Error

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

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)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

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

impl From<Error> for Error

fn from(source: Error) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(err: Error) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(err: Error) -> Self

Performs the conversion.

impl From<FromUtf8Error> for Error

fn from(err: FromUtf8Error) -> Self

Performs the conversion.

impl<T> From<InsertError<T>> for Error

fn from(err: InsertError<T>) -> Self

Performs the conversion.

impl From<InvalidNameError> for Error

fn from(source: InvalidNameError) -> Self

Performs the conversion.

impl From<PermissionDenied> for Error

fn from(source: PermissionDenied) -> Self

Performs the conversion.

impl Serialize for Error

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.