Enum ErrorKind

#[non_exhaustive]
pub enum ErrorKind {
    Unexpected,
    Unsupported,
    ConfigInvalid,
    NotFound,
    PermissionDenied,
    IsADirectory,
    NotADirectory,
    AlreadyExists,
    RateLimited,
    IsSameFile,
    ConditionNotMatch,
    RangeNotSatisfied,
}

ErrorKind is all kinds of Error of opendal.

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.

Unexpected

OpenDAL don’t know what happened here, and no actions other than just returning it back. For example, s3 returns an internal service error.

Unsupported

Underlying service doesn’t support this operation.

ConfigInvalid

The config for backend is invalid.

NotFound

The given path is not found.

PermissionDenied

The given path doesn’t have enough permission for this operation

IsADirectory

The given path is a directory.

NotADirectory

The given path is not a directory.

AlreadyExists

The given path already exists thus we failed to the specified operation on it.

RateLimited

Requests that sent to this path is over the limit, please slow down.

IsSameFile

The given file paths are same.

ConditionNotMatch

The condition of this operation is not match.

The condition itself is context based.

For example, in S3, the condition can be:

1. writing a file with If-Match header but the file’s ETag is not match (will get a 412 Precondition Failed).
2. reading a file with If-None-Match header but the file’s ETag is match (will get a 304 Not Modified).

As OpenDAL cannot handle the condition not match error, it will always return this error to users. So users could to handle this error by themselves.

RangeNotSatisfied

The range of the content is not satisfied.

OpenDAL returns this error to indicate that the range of the read request is not satisfied.

Implementations

impl ErrorKind

pub fn into_static(self) -> &'static str

Convert self into static str.

Trait Implementations

impl Clone for ErrorKind

fn clone(&self) -> ErrorKind

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ErrorKind

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

Formats the value using the given formatter.

impl Display for ErrorKind

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

Formats the value using the given formatter.

impl From<ErrorKind> for &'static str

fn from(v: ErrorKind) -> &'static str

Converts to this type from the input type.

impl PartialEq for ErrorKind

fn eq(&self, other: &ErrorKind) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ErrorKind

impl Eq for ErrorKind

impl StructuralPartialEq for ErrorKind