Enum opendal::ErrorKind

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

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.

ContentTruncated

The content is truncated.

This error kind means there are more content to come but been truncated.

For examples:

• Users expected to read 1024 bytes, but service returned more bytes.
• Service expected to write 1024 bytes, but users write more bytes.

ContentIncomplete

The content is incomplete.

This error kind means expect content length is not reached.

For examples:

• Users expected to read 1024 bytes, but service returned less bytes.
• Service expected to write 1024 bytes, but users write less bytes.

InvalidInput

The input is invalid.

For example, user try to seek to a negative position

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

Formats the value using the given formatter.

impl Display for ErrorKind

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

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

This method tests for self and other values to be equal, and is used by ==.

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

This method 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