Struct Measurer 

pub struct Measurer { /* private fields */ }

Measures directories under a fixed policy.

Implementations

impl Measurer

pub fn new(mode: SizeMode) -> Self

A measurer with the given mode, staying on one filesystem.

pub fn same_file_system(self, same_file_system: bool) -> Self

Whether to descend across a mount point. Off by default, matching the safety model: what the deleter will not cross, the measurer must not count.

pub fn traverses(&self, dir: &Path, metadata: &Metadata) -> bool

Whether measuring dir means traversing it.

This is what decides whether a claim goes to the pricing pool instead of being sized on the walker thread that found it. Two things are false here and both matter: a claim this mode does not price at all, and a symlink, whose one lstat the walk has already done. Queueing either would trade a constant-time answer for a thread handoff and delay the claim’s own publication for nothing.

pub fn measure(&self, dir: &Path, metadata: &Metadata) -> Measurement

Measures dir, whose metadata the caller already has from the walk.

Returns without touching the filesystem under SizeMode::Skip, which is the point.

pub fn survey(&self, dir: &Path, metadata: &Metadata) -> Survey

One pass over a tier-two candidate, answering both questions the tier has left: how big it is, and whether it holds a git repository.

This walks whatever the mode is, because neither answer can be inferred, and it walks the whole subtree. An earlier version stopped as soon as it had enough bytes to clear the floor, which is much cheaper — and useless here, because “holds no repository” is a negative and a negative is only proved by covering everything. The consolation is that this pass is still cheaper than what the walker would have done had tier two not claimed the directory at all: a tight read_dir + lstat loop with no ignore stack and no rule evaluation, and then a prune.

Because it always covers everything, a tier-two claim arrives with a real size even on a default scan. Tier one’s claims stay Size::Unmeasured: nothing forces the walk to look inside those.

Trait Implementations

impl Clone for Measurer

fn clone(&self) -> Measurer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Measurer

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

Formats the value using the given formatter.