Enum FileVerifyOutcome 

#[non_exhaustive]
pub enum FileVerifyOutcome {
    Match,
    WholeMismatch {
        expected: Vec<u8>,
        actual: Vec<u8>,
    },
    BlockMismatches {
        mismatched_blocks: Vec<usize>,
        expected_block_count: usize,
        actual_block_count: usize,
    },
    Missing,
    IoError {
        kind: ErrorKind,
        message: String,
    },
}

Per-file outcome of a HashVerifier::execute run.

#[non_exhaustive] so future outcome shapes (e.g. permission-denied vs generic IO) can be split without a SemVer break.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Match

File matched the expected hash (whole-file mode) or every block matched (block-mode).

WholeMismatch

Whole-file mode: the computed digest did not equal the expected digest.

Fields

expected: Vec<u8>

Expected digest.

actual: Vec<u8>

Digest computed over the on-disk file.

BlockMismatches

Block-mode: one or more blocks failed.

mismatched_blocks holds the zero-based indices of blocks whose hash did not match, in ascending order. expected_block_count is the number of block hashes the caller supplied. actual_block_count is the number of blocks the file would contain at block_size (i.e. ceil(size / block_size)); a difference means the file is shorter or longer than the caller’s expectation and every “extra” or “missing” block index is reported in mismatched_blocks.

Fields

mismatched_blocks: Vec<usize>

Zero-based indices of mismatched blocks, ascending.

expected_block_count: usize

Number of block hashes the caller supplied.

actual_block_count: usize

Number of blocks the on-disk file would split into at block_size.

Missing

The file does not exist on disk.

IoError

An I/O error occurred while reading the file. kind is the std::io::ErrorKind callers branch on (e.g. std::io::ErrorKind::PermissionDenied to prompt for elevation, std::io::ErrorKind::NotFound is reported as FileVerifyOutcome::Missing instead). message is the std::io::Error Display rendering, preserved as a string so the report stays Clone + PartialEq for downstream consumers.

Fields

kind: ErrorKind

std::io::ErrorKind of the underlying error.

message: String

Human-readable rendering of the error.

Trait Implementations

impl Clone for FileVerifyOutcome

fn clone(&self) -> FileVerifyOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileVerifyOutcome

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

Formats the value using the given formatter.

impl PartialEq for FileVerifyOutcome

fn eq(&self, other: &FileVerifyOutcome) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for FileVerifyOutcome

impl StructuralPartialEq for FileVerifyOutcome