Enum WorkspaceError 

#[non_exhaustive]
pub enum WorkspaceError {
    BadName {
        name: String,
        why: NameProblem,
    },
    NoSuchDatabase {
        name: DbName,
        path: PathBuf,
    },
    Busy {
        name: DbName,
    },
    Io {
        path: PathBuf,
        source: Error,
    },
    Host(HostError),
}

Every way a workspace operation can fail.

Opening one database still fails as a HostError; this type adds the failures that only exist once databases are addressed by name.

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.

BadName

The string is not a usable database name.

Fields

name: String

The rejected string, as given.

why: NameProblem

What specifically was wrong with it.

NoSuchDatabase

No database of that name exists, and the caller asked not to create one.

Fields

name: DbName

The name that did not resolve.

path: PathBuf

Where it would have been.

Busy

The database is open for writing elsewhere.

Distinct from HostError::Locked so the message can name the database rather than a path the caller never typed. One file has one writer, and in a workspace the other writer is usually a long-running sidecar that will release it once the handle goes idle.

Fields

name: DbName

The database that is held elsewhere.

Io

A filesystem operation on the workspace itself failed.

Fields

path: PathBuf

The path the operation touched.

source: Error

The underlying error.

Host(HostError)

Opening or using one of the databases failed.

Trait Implementations

impl Debug for WorkspaceError

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

Formats the value using the given formatter.

impl Display for WorkspaceError

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

Formats the value using the given formatter.

impl Error for WorkspaceError

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<HostError> for WorkspaceError

fn from(source: HostError) -> Self

Converts to this type from the input type.