Enum trash::Error

pub enum Error {
    Unknown {
        description: String,
    },
    TargetedRoot,
    CouldNotAccess {
        target: String,
    },
    CanonicalizePath {
        original: PathBuf,
    },
    ConvertOsString {
        original: OsString,
    },
    RestoreCollision {
        path: PathBuf,
        remaining_items: Vec<TrashItem>,
    },
    RestoreTwins {
        path: PathBuf,
        items: Vec<TrashItem>,
    },
}

Provides information about an error.

Variants

Unknown

Fields

description: String

TargetedRoot

One of the target items was a root folder. If a list of items are requested to be removed by a single function call (e.g. delete_all) and this error is returned, then it’s guaranteed that none of the items is removed.

CouldNotAccess

Fields

target: String

The target does not exist or the process has insufficient permissions to access it.

CanonicalizePath

Fields

original: PathBuf

Path that triggered the error.

Error while canonicalizing path.

ConvertOsString

Fields

original: OsString

The string that was attempted to be converted.

Error while converting an OsString to a String.

This may also happen when converting a Path or PathBuf to an OsString.

RestoreCollision

Fields

path: PathBuf

remaining_items: Vec<TrashItem>

This kind of error happens when a trash item’s original parent already contains an item with the same name and type (file or folder). In this case an error is produced and the restoration of the files is halted meaning that there may be files that could be restored but were left in the trash due to the error.

One should not assume any relationship between the order that the items were supplied and the list of remaining items. That is to say, it may be that the item that collided was in the middle of the provided list but the remaining items’ list contains all the provided items.

path: The path of the file that’s blocking the trash item from being restored.

remaining_items: All items that were not restored in the order they were provided, starting with the item that triggered the error.

RestoreTwins

Fields

path: PathBuf

items: Vec<TrashItem>

This sort of error is returned when multiple items with the same original_path were requested to be restored. These items are referred to as twins here. If there are twins among the items, then none of the items are restored.

path: The original_path of the twins.

items: The complete list of items that were handed over to the restore_all function.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

fn fmt(&self, f: &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