Struct IncrementalIndex 

pub struct IncrementalIndex { /* private fields */ }

Persistent index for incremental deduplication.

Tracks which files have been seen and their state at the time of the last scan, enabling subsequent scans to skip unchanged files.

Implementations

impl IncrementalIndex

pub fn new() -> Self

Create a new, empty index.

pub fn tracked_count(&self) -> usize

Number of tracked files.

pub fn scan_count(&self) -> u64

Number of scans completed.

pub fn last_scan_epoch(&self) -> u64

Epoch of the last scan.

pub fn classify(&self, path: &Path) -> DedupResult<(FileChange, FileState)>

Classify a single file against the stored state.

Errors

Returns an error if the file’s metadata cannot be read.

pub fn scan(&self, candidates: &[PathBuf]) -> ScanResult

Perform an incremental scan over a list of candidate paths.

Classifies each file, identifies deleted files (tracked but not in the candidate list), and returns a ScanResult.

Does not update the index – call commit after processing.

pub fn commit(&mut self, paths: &[PathBuf])

Commit processed files to the index, updating their state.

Call this after successfully processing the files from a scan.

pub fn commit_file(&mut self, path: &Path, state: FileState)

Commit a single file with an explicit state (e.g. with content hash).

pub fn prune_deleted(&mut self, deleted: &[PathBuf])

Remove deleted files from the index.

pub fn get_state(&self, path: &Path) -> Option<&FileState>

Get the stored state for a file.

pub fn is_tracked(&self, path: &Path) -> bool

Check if a file is tracked.

pub fn to_json(&self) -> DedupResult<String>

Serialise the index to JSON.

Errors

Returns an error if serialisation fails.

pub fn from_json(json: &str) -> DedupResult<Self>

Deserialise an index from JSON.

Errors

Returns an error if the JSON is invalid.

pub fn save_to_file(&self, path: &Path) -> DedupResult<()>

Save the index to a file.

Errors

Returns an I/O error if the file cannot be written.

pub fn load_from_file(path: &Path) -> DedupResult<Self>

Load the index from a file.

Errors

Returns an error if the file cannot be read or parsed.

pub fn clear(&mut self)

Clear the entire index.

pub fn tracked_paths(&self) -> Vec<String>

Return all tracked file paths.

pub fn merge(&mut self, other: &IncrementalIndex)

Merge another index into this one. Files in other override this index.

Trait Implementations

impl Clone for IncrementalIndex

fn clone(&self) -> IncrementalIndex

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IncrementalIndex

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

Formats the value using the given formatter.

impl Default for IncrementalIndex

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for IncrementalIndex

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for IncrementalIndex

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

where __S: Serializer,

Serialize this value into the given Serde serializer.