Struct TreeStats 

pub struct TreeStats {
    pub total_size: u64,
    pub total_files: u64,
    pub total_dirs: u64,
    pub total_symlinks: u64,
    pub max_depth: u32,
    pub largest_file: Option<(PathBuf, u64)>,
    pub oldest_file: Option<(PathBuf, SystemTime)>,
    pub newest_file: Option<(PathBuf, SystemTime)>,
}

Summary statistics for a scanned tree.

Fields

total_size: u64

Total size in bytes.

total_files: u64

Total number of files.

total_dirs: u64

Total number of directories.

total_symlinks: u64

Total number of symbolic links.

max_depth: u32

Maximum depth reached.

largest_file: Option<(PathBuf, u64)>

Largest file (path, size).

oldest_file: Option<(PathBuf, SystemTime)>

Oldest file (path, time).

newest_file: Option<(PathBuf, SystemTime)>

Newest file (path, time).

Implementations

impl TreeStats

pub fn new() -> TreeStats

Create new empty stats.

pub fn record_file( &mut self, path: &Path, size: u64, modified: Option<SystemTime>, depth: u32, )

Update stats with a file entry. Only clones the path when updating a tracked field. Equal sizes/times choose the smallest native path, independent of arrival order.

modified is None when the file’s modification time could not be read; such files are excluded from oldest/newest tracking rather than being coerced to the Unix epoch (which would poison the “oldest file” result).

pub fn record_file_with( &mut self, size: u64, modified: Option<SystemTime>, depth: u32, path: impl FnOnce() -> PathBuf, )

Self::record_file that builds the path only when it is needed: when this file may become the largest, oldest or newest.

pub fn record_dir(&mut self, depth: u32)

Record a directory.

pub fn record_symlink(&mut self)

Record a symlink.

pub fn collect(root: &FileNode, root_path: &Path) -> TreeStats

Statistics of an existing tree whose root is at root_path, as a scan of it would have recorded them.

Trait Implementations

impl Clone for TreeStats

fn clone(&self) -> TreeStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TreeStats

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

Formats the value using the given formatter.

impl Default for TreeStats

fn default() -> TreeStats

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TreeStats

fn deserialize<__D>( __deserializer: __D, ) -> Result<TreeStats, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TreeStats

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.