Struct TempDir 

pub struct TempDir { /* private fields */ }

A temporary directory that automatically cleans up when dropped.

This struct provides RAII (Resource Acquisition Is Initialization) semantics for temporary directories. The directory is created when the struct is created and automatically removed when the struct is dropped, even if the program panics.

Examples

use agpm_cli::utils::fs::TempDir;

{
    let temp = TempDir::new("test")?;
    let temp_path = temp.path();
     
    // Use the temporary directory
    std::fs::write(temp_path.join("file.txt"), "temporary data")?;
     
    // Directory exists here
    assert!(temp_path.exists());
} // TempDir is dropped here, directory is automatically cleaned up

Thread Safety

Each TempDir instance creates a unique directory using UUID generation, making it safe to use across multiple threads without naming conflicts.

Cleanup Behavior

• Directory is removed recursively when dropped
• Cleanup happens even if the program panics
• If cleanup fails (rare), the error is silently ignored
• Uses the system temporary directory as the parent

Use Cases

• Unit testing with temporary files
• Staging areas for atomic operations
• Scratch space for temporary processing

Implementations

impl TempDir

pub fn new(prefix: &str) -> Result<Self>

Creates a new temporary directory with the given prefix.

The directory is created immediately and will have a name like agpm_{prefix}_{uuid} in the system temporary directory.

Arguments

• prefix - A prefix for the directory name (for identification)

Returns

A new TempDir instance, or an error if directory creation fails

Examples

use agpm_cli::utils::fs::TempDir;

let temp = TempDir::new("cache")?;
println!("Temporary directory: {}", temp.path().display());

pub fn path(&self) -> &Path

Returns the path to the temporary directory.

The directory is guaranteed to exist as long as this TempDir instance exists.

Returns

A reference to the temporary directory path

Trait Implementations

impl Drop for TempDir

fn drop(&mut self)

Executes the destructor for this type.