Struct Trash 

pub struct Trash {
    pub trash_folder_files: String,
    pub help: String,
    /* private fields */
}

Represent a view of the trash. Its content is navigable so we use a Vector to hold the content. Only files that share the same mount point as the trash folder (generally ~/.local/share/Trash) can be moved to trash. Other files are unaffected.

Fields

trash_folder_files: String

The path to the trashed files

help: String

Implementations

impl Trash

pub fn new(binds: &Bindings) -> Result<Self>

Creates an empty view of the trash. No file is read here, we wait for the user to open the trash first.

Errors

This function uses std::fs::create_dir_all internally and may fail for the same reasons.

pub fn update(&mut self) -> Result<()>

Parse the info files into a new instance. Only the file we can parse are read.

Errors

This function may fail if the trash_folder_info can’t be parsed correctly. If any file is listed in trash_folder_info but doesn’t exist.

pub fn trash(&mut self, origin: &Path) -> Result<()>

Move a file to the trash folder and create a new trash info file. Add a new TrashInfo to the content.

Errors

This function may fail if the origin path is a relative path. We have no way to know where the file is exactly located.

It may also fail if the trash folder can’t be located, we wouldn’t be able to create a new path for the file.

pub fn empty_trash(&mut self) -> Result<()>

Empty the trash, removing all the files and the trashinfo. This action requires a confirmation. Watchout, it may delete files that weren’t parsed.

Errors

This method may fail if the trashfolder was moved or deleted or simply doesn’t exist. This method uses std::fs::remove_dir internally, which may fail.

See std::fs::remove_file and std::fs::remove_dir.

remove_dir_all will fail if remove_dir or remove_file fail on any constituent paths, including the root path.

pub fn restore(&mut self) -> Result<()>

Restores a file from the trash to its previous directory. If the parent (or ancestor) folder were deleted, it is recreated.

Errors

Will return an error if the file isn’t trashed properly :

• missing .trashinfo
• missing file itself

It may also fail if the file can’t be restored : For example, if the original path of the file is now in a directory where the user has no permission to write.

pub fn delete_permanently(&mut self) -> Result<()>

Deletes a file permanently from the trash.

Errors

Will return an error if the selected file isn’t trashed properly:

• missing .trashinfo
• missing file itself.

Trait Implementations

impl Clone for Trash

fn clone(&self) -> Trash

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Selectable for Trash

Implement a selectable content for this struct. This trait allows to navigate through a vector of element content_type. It implements: is_empty, len, next, prev, set_index and selected_is_last.

fn is_empty(&self) -> bool

True if the content is empty.

fn len(&self) -> usize

The size of the content.

fn prev(&mut self)

Select the prev item.

fn next(&mut self)

Select the next item.

fn index(&self) -> usize

Returns the index of the selected item.

fn set_index(&mut self, index: usize)

Set the index to a new value if the value is below the length.

fn selected_is_last(&self) -> bool

true if the selected element is the last of content