Enum SkipReason 

#[non_exhaustive]
pub enum SkipReason {
    Empty,
    TooSmall,
    Utf16Bom,
    NotUtf8,
}

Why read_file_with_eol_classified declined to hand a file’s bytes to the metric engine.

read_file_with_eol collapses every one of these into Ok(None), which left front-ends unable to name the real cause — bca reported a multi-kilobyte binary and a one-byte source alike as “empty” (#1287). This enum is the classified form of that same decision; the variants map 1:1 onto the skip branches of read_file_with_eol_classified.

Marked #[non_exhaustive]: a future gate (a size ceiling, a further encoding) adds a variant additively, so match on it with a wildcard arm or render it through Display.

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.

Empty

The file is zero bytes long.

TooSmall

The file holds 1–3 bytes — too little to be worth parsing — or it shrank below the UTF-8 probe window between the stat and the read.

Utf16Bom

The file opens with a UTF-16 BE or LE byte-order mark. Its interleaved-NUL body would pass a byte-level UTF-8 check and reach the parser as garbage, so it is skipped rather than decoded (#803).

NotUtf8

The file’s leading window is not valid UTF-8 — the shape a binary file takes here.

Trait Implementations

impl Clone for SkipReason

fn clone(&self) -> SkipReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SkipReason

impl Debug for SkipReason

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

Formats the value using the given formatter.

impl Display for SkipReason

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

Renders the reason as a noun phrase naming the skipped file, so a caller can splice it into a diagnostic: skipping {reason}: {path}.

Per the project diagnostic convention the phrase carries no severity word — the presenting layer owns that prefix.

impl Eq for SkipReason

impl Hash for SkipReason

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for SkipReason

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SkipReason