Struct Hit 

pub struct Hit {
    pub path: PathBuf,
    pub claim: Claim,
    pub size: Size,
    pub modified: Option<SystemTime>,
}

One reclaimable thing: a directory, or — when the walk was asked for them — a gitignored file.

Fields

path: PathBuf

The path itself.

claim: Claim

Which tier claimed it, and everything that tier knows.

size: Size

What is known about the size. For a tier-one claim, Size::Unmeasured unless a breakdown was asked for, because measuring means enumerating the subtree the scan deliberately pruned at. A tier-two claim always carries a real number: a directory could not have been claimed without a full pass over it, so there was nothing left to save, and a file is one lstat the walk had already done.

modified: Option<SystemTime>

The directory’s own mtime. The best single proxy for “do I still need this”.

Implementations

impl Hit

pub fn age(&self, now: SystemTime) -> Option<Duration>

How long ago the directory was last touched, or None if the clock disagrees with the filesystem.

pub fn label(&self) -> Cow<'_, str>

What this directory is: the ecosystem and the kind, or UNLABELLED when only git knows the directory at all.

A fact rather than a hint, which is the whole reason it replaced the command that used to sit here. “node_modules is Node Dependencies” is checked; “npm install brings it back” was a guess about a package manager, on a machine nothing here had looked at.

pub fn kind(&self) -> Option<Kind>

What kind of artefact this is, or None when nothing knows what it is.

The half of a label a machine can act on, which is what the closed vocabulary bought: “show me every cache” is a question the front end can answer, and the None is not a gap to be filled in but the tier-two claim’s own content — see IgnoredClaim.

A kind no longer implies a rule. A gitignored file can carry one, read off its name by Kind::of_ignored_file, so “which tier claimed this” is Hit::is_ignored_file and Hit::rule rather than “does it have a kind”.

pub fn rule(&self) -> Option<&Rule>

The rule that claimed this directory, or None when no rule did.

pub fn is_ignored_file(&self) -> bool

Whether this claim is a gitignored file rather than a directory.

The one question the front end asks about the shape of a candidate, because a file is a different job from the one the sweep does — see crate::tui::lens, where it is an axis of its own rather than a third value on the tier axis.

Trait Implementations

impl Clone for Hit

fn clone(&self) -> Hit

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Hit

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

Formats the value using the given formatter.

impl From<&Hit> for Target

fn from(hit: &Hit) -> Self

Converts to this type from the input type.