Struct MergeExecutor 

pub struct MergeExecutor { /* private fields */ }

Executes real filesystem mutations (symlink / hardlink / delete) for a set of duplicate files.

use oximedia_dedup::merge_strategy::{MergeExecutor, LinkMode};
use std::path::PathBuf;

// Build an executor that replaces duplicates with hard links.
let executor = MergeExecutor::new(LinkMode::Hardlink);

// Dry-run: returns what *would* happen without touching the filesystem.
let primary = PathBuf::from("/media/archive/original.mp4");
let dups = vec![PathBuf::from("/media/inbox/copy.mp4")];
let report = executor.dry_run(&primary, &dups);

Implementations

impl MergeExecutor

pub fn new(link_mode: LinkMode) -> Self

Create a new executor with the given LinkMode.

pub fn apply( &self, primary_path: &Path, duplicates: &[PathBuf], ) -> Result<MergeReport, DedupError>

Apply the configured action to every path in duplicates, treating primary_path as the canonical file to keep.

The primary path itself is silently skipped if it appears in duplicates (path equality check using Path::canonicalize if both exist, falling back to byte comparison otherwise).

Errors

Returns crate::DedupError::Io for unrecoverable I/O failures. Cross-device hardlink failures are NOT errors — they produce AppliedAction::Skipped instead.

pub fn dry_run( &self, primary_path: &Path, duplicates: &[PathBuf], ) -> Result<MergeReport, DedupError>

Preview what apply would do without touching the filesystem.

The returned MergeReport describes the intended actions. No files are created, removed, or modified.

Errors

Currently infallible (always returns Ok), but uses the same error type as apply for API symmetry.

pub fn apply_resolution( &self, resolution: &MergeResolution, ) -> Result<MergeReport, DedupError>

Execute a pre-computed MergeResolution produced by MergeResolver.

This bridges the selection phase (which file to keep) with the execution phase (actually modifying the filesystem).

Errors

Returns crate::DedupError::Io for unrecoverable I/O failures.

Trait Implementations

impl Clone for MergeExecutor

fn clone(&self) -> MergeExecutor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for MergeExecutor

impl Debug for MergeExecutor

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

Formats the value using the given formatter.