Struct auto_delete_path::AutoDeletePath

pub struct AutoDeletePath { /* private fields */ }

This struct simply holds an instance of std::path::PathBuf. However, when such an instance goes out of scope and is destroyed, its destructor will be called, which attempts to delete the owned path (either file or directory).

This works even if the program panics.

Useful for creating temporary files that you want to be deleted automatically.

Implementations

impl AutoDeletePath

pub fn temp() -> Self

Creates an AutoDeletePath in the default temp directory. This method just returns a path; If you want to actually make a file or folder, you have to do that manually.

Examples

File:

let mut temp_path_clone = std::path::PathBuf::new();
{
    let temp_path = auto_delete_path::AutoDeletePath::temp();

    temp_path_clone = temp_path.as_ref().to_owned();
    assert!(!temp_path_clone.exists());
    std::fs::write(&temp_path, "spam").unwrap();
    assert!(temp_path_clone.exists());
} // temp_path dies here, so the file is deleted
assert!(!temp_path_clone.exists());

Directory:

let mut temp_path_clone = std::path::PathBuf::new();
{
    let temp_path = auto_delete_path::AutoDeletePath::temp();
    temp_path_clone = temp_path.as_ref().to_owned();
    assert!(!temp_path_clone.exists());
    std::fs::create_dir(&temp_path).unwrap();
    assert!(temp_path_clone.exists());
} // temp_path dies here, so the directory is deleted
assert!(!temp_path_clone.exists());

Trait Implementations

impl AsRef<Path> for AutoDeletePath

fn as_ref(&self) -> &Path

Converts this type into a shared reference of the (usually inferred) input type.

impl Debug for AutoDeletePath

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

Formats the value using the given formatter.

impl Drop for AutoDeletePath

fn drop(&mut self)

Executes the destructor for this type.