ic-host-fs 0.69.6

Local host filesystem reads, durable publication, file locking and a bounded file CLI
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

//! Metadata-only logical lengths; callers retain traversal and cache policy.

use std::{fs, io, path::Path};

/// Sum non-directory metadata lengths without following final symlinks.
///
/// Directory metadata contributes no bytes. Sparse files contribute their logical
/// length; symlinks (including dangling links) contribute their own metadata
/// length. Hard-linked paths are counted separately. Totals saturate at `u64::MAX`.
/// The iterative walk reads metadata and directory entries, never file contents.
/// Only directories are queued; ordinary file paths are processed immediately.
/// No entry/depth budget or cleanup is selected; callers admit trees and retain
/// namespace custody. Intermediate path components can resolve through aliases.
/// This is an observation, not hostile-tree confinement or a snapshot.
///
/// # Errors
/// Returns the original metadata, directory-opening or entry-reading I/O error.
pub fn directory_logical_size(path: &Path) -> io::Result<u64> {
    let mut total = 0_u64;
    let metadata = fs::symlink_metadata(path)?;
    if !metadata.is_dir() {
        return Ok(metadata.len());
    }
    let mut pending = vec![path.to_owned()];
    while let Some(current) = pending.pop() {
        for entry in fs::read_dir(&current)? {
            let entry = entry?;
            let metadata = entry.metadata()?;
            if metadata.is_dir() {
                pending.push(entry.path());
            } else {
                total = total.saturating_add(metadata.len());
            }
        }
    }
    Ok(total)
}

#[cfg(test)]
mod tests;