Struct FileUtils 

pub struct FileUtils;

Enhanced file operations with safety checks.

This struct provides a collection of utility methods for file operations that include additional safety checks, validation, and enhanced functionality beyond the standard library’s file operations.

Implementations

impl FileUtils

pub fn safe_join<P: AsRef<Path>>(base: P, path: P) -> Result<PathBuf>

Safely joins two paths while preventing directory traversal attacks.

This method ensures that the resulting path remains within the base directory and cannot be used to access files outside of it through path traversal techniques like ../.

Arguments

• base - The base directory path.
• path - The path to join to the base.

Returns

A Result containing the safely joined PathBuf, or an error if path traversal is detected.

pub async fn get_enhanced_metadata(path: &Path) -> Result<EnhancedFileMetadata>

Retrieves enhanced file metadata with additional information.

This method provides more comprehensive file information than the standard metadata, including MIME type detection and text file classification.

Arguments

• path - The path to the file or directory.

Returns

A Result containing EnhancedFileMetadata with detailed file information.

pub async fn copy_with_progress<F>( from: &Path, to: &Path, progress_callback: F, ) -> Result<()>

where F: Fn(u64, u64) + Send + 'static,

Copies a file with progress tracking.

This method copies a file from one location to another while providing progress updates through a callback function. It uses a buffered approach for efficient copying of large files.

Arguments

• from - The source file path.
• to - The destination file path.
• progress_callback - A function called with (copied_bytes, total_bytes).

Returns

A Result indicating success or failure of the copy operation.

pub fn calculate_dir_size( path: &Path, ) -> Pin<Box<dyn Future<Output = Result<u64>> + Send + '_>>

Calculates the total size of a directory recursively.

This method traverses a directory tree and sums up the sizes of all files contained within it, including subdirectories.

Arguments

• path - The directory path to calculate the size for.

Returns

A Future that resolves to a Result containing the total size in bytes.

pub async fn find_duplicates(paths: &[PathBuf]) -> Result<Vec<Vec<PathBuf>>>

Finds duplicate files by comparing their content hashes.

This method analyzes a list of file paths and groups files that have identical content based on SHA-256 hash comparison.

Arguments

• paths - A slice of file paths to analyze for duplicates.

Returns

A Result containing a vector of groups, where each group contains paths to files with identical content.