Struct Diff 

pub struct Diff {
    pub dirty: Vec<PathBuf>,
    pub new: Vec<PathBuf>,
    pub deleted: Vec<PathBuf>,
    pub touched_clean: Vec<(PathBuf, FileEntry)>,
}

Categorized filesystem changes detected by diff_against_walk.

All three vectors hold absolute paths (matching the walk’s output). A Diff is “empty” only when every list is empty; the Self::is_empty helper exists to make this the canonical “no-work-needed” check.

The touched_clean field carries files whose stat tuple changed but whose blake3 hash still matches — “touched without content change”. These are NOT structural changes (the diff is otherwise empty for them) but the new (path, FileEntry) pairs need to be propagated back into the owning index’s manifest so that future diffs hit the cheap stat-tuple path rather than re-blake3’ing every time.

is_empty() deliberately ignores touched_clean: a diff that contains only touched-clean entries requires no index rebuild. crate::encoder::ripvec::index::RipvecIndex::apply_diff handles the manifest refresh separately.

Fields

dirty: Vec<PathBuf>

Files present in both manifest and walk whose content changed.

new: Vec<PathBuf>

Files present in the walk but not in the manifest.

deleted: Vec<PathBuf>

Files present in the manifest but not in the walk.

touched_clean: Vec<(PathBuf, FileEntry)>

Files whose stat tuple changed but whose blake3 hash matches (touch-without-content-change). Each entry carries the refreshed FileEntry (new mtime/size/ino, same blake3) so the caller can update the owning manifest without re-reading the file.

This field is NOT included in Self::is_empty or Self::total — these files are not structural changes.

Implementations

impl Diff

pub fn is_empty(&self) -> bool

Whether all structural change lists are empty.

Returns true even when touched_clean is non-empty — those files require manifest stat-tuple refreshes but no index rebuild.

pub fn total(&self) -> usize

Total number of structurally changed files (dirty + new + deleted).

Does not count touched_clean entries; they are not structural changes.

Trait Implementations

impl Debug for Diff

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

Formats the value using the given formatter.

impl Default for Diff

fn default() -> Diff

Returns the “default value” for a type.