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>,
},
}
Expand description
Provides information about an error.
Variants§
Unknown
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
The target
does not exist or the process has insufficient permissions to access it.
CanonicalizePath
Error while canonicalizing path.
ConvertOsString
Error while converting an OsString
to a String
.
This may also happen when converting a Path
or PathBuf
to an OsString
.
RestoreCollision
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
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.