Enum ContentError 

pub enum ContentError {
    TransientRead,
    PermanentRead,
    NotUtf8,
}

Why a file could not be turned into an index.

Transient and permanent are separate variants on purpose. This pass re-opens a file AFTER the scan finished, so between the two a file can be deleted, replaced, or briefly locked by another process. That is a different fact from “this file is a directory” or “you may not read it”, and collapsing the two would report a momentary blip as a permanent hole in coverage.

The failure the pass can design out, it does: FilesystemContent opens once and works from the handle rather than stat-ing a path and then opening it, so there is no check-then-use race of its own making. What is left is genuinely external, which is why it is classified rather than looped over. Retry policy is not decided here; a caller that owns one wraps FileContentSource and retries only ContentError::TransientRead.

Variants

TransientRead

The read failed for a reason that may not hold a moment later: the file was removed or replaced after the scan, a lock was held, a syscall was interrupted, or a resource was momentarily busy.

PermanentRead

The read failed for a reason retrying cannot change: permission denied, the path is a directory, or the device rejected it.

NotUtf8

The prefix is not valid UTF-8.

Implementations

impl ContentError

pub fn classify(error: &Error) -> Self

Classify an I/O failure. Anything not known to be permanent is treated as transient, because calling a momentary condition permanent is the error that costs coverage; the reverse only costs one retry.

Trait Implementations

impl Clone for ContentError

fn clone(&self) -> ContentError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ContentError

impl Debug for ContentError

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

Formats the value using the given formatter.

impl Eq for ContentError

impl PartialEq for ContentError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ContentError