Enum MoveDirectoryExecutionError

pub enum MoveDirectoryExecutionError {
    UnableToAccessSource {
        path: PathBuf,
        error: Error,
    },
    EntryEscapesSourceDirectory {
        path: PathBuf,
    },
    DestinationEntryUnexpected {
        path: PathBuf,
    },
    CopyDirectoryError(CopyDirectoryExecutionError),
    RenameFailedAndNoFallbackStrategy,
    OtherIoError {
        error: Error,
    },
}

Directory move execution error.

Variants

UnableToAccessSource

A file or directory inside the source directory could not be accessed.

Fields

path: PathBuf

The path we were unable to access.

error: Error

IO error describing why the directory could not be created.

EntryEscapesSourceDirectory

An item inside the source directory “escaped” outside of the base source directory.

Implementation detail

This is an extremely unlikely error, because its requirement is that std::fs::read_dir’s iterator returns a directory entry outside the provided directory path.

Even though this seems extremely unlikely, a panic! would be an extreme measure due to the many types of filesystems that exist. Instead, treat this as a truly fatal error.

Fields

path: PathBuf

The path that “escaped” the source directory.

DestinationEntryUnexpected

A destination directory, a file, or a sub-directory inside it has changed since the preparation phase of the directory move call.

We can’t guarantee that all destination directory changes will trigger this, but some more obvious problematic ones, like a file appearing in one of the destinations we wanted to copy to, will.

This is essentially an unavoidable time-of-check time-of-use bug, but we try to catch it if possible.

The path field contains the path that already existed, causing this error.

Fields

path: PathBuf

The path of the target directory or file that already exists.

CopyDirectoryError(CopyDirectoryExecutionError)

Directory copy execution error.

These errors can happen when a move-by-rename fails and a copy-and-delete is performed instead.

RenameFailedAndNoFallbackStrategy

Occurs when renaming is the only enabled directory move strategy, but it fails.

This commonly indicates that the source and destination directory are on different mount points, which would require copy-and-delete, and sometimes even following (instead of preserving) symbolic links.

OtherIoError

An uncategorized unrecoverable IO error. See error field for more information.

Fields

error: Error

IO error describing the cause of the outer error.

Trait Implementations

impl Debug for MoveDirectoryExecutionError

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

Formats the value using the given formatter.

impl Display for MoveDirectoryExecutionError

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

Formats the value using the given formatter.

impl Error for MoveDirectoryExecutionError

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<CopyDirectoryExecutionError> for MoveDirectoryExecutionError

fn from(source: CopyDirectoryExecutionError) -> Self

Converts to this type from the input type.

impl From<MoveDirectoryExecutionError> for MoveDirectoryError

fn from(source: MoveDirectoryExecutionError) -> Self

Converts to this type from the input type.