Enum CoverageGapReason 

pub enum CoverageGapReason {
    NoFilePath,
    SourceNotReadable,
    HistoricalContent,
    TransientReadFailed,
    PermanentReadFailed,
    NotUtf8,
    DerivedViewAnchorless,
    FileTruncated,
    ByteBudgetExhausted,
}

Why the pass could not build file context for some findings.

Variants

NoFilePath

The finding carried no file path at all.

SourceNotReadable

The source backend does not expose a re-readable local file.

HistoricalContent

The finding describes historical content at a commit, not the file on disk today, so indexing the working-tree file would attribute a door that may never have coexisted with the credential.

TransientReadFailed

The file could not be read for a reason that may not hold a moment later: it was removed or replaced after the scan, briefly locked, or the read was interrupted. This is a candidate for retry by whatever owns the scan’s retry policy, and it is NOT the same fact as a permanent hole.

PermanentReadFailed

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

NotUtf8

The indexed prefix is not valid UTF-8, so byte offsets could not be mapped to lines without corrupting them.

DerivedViewAnchorless

The credential was recovered from a DERIVED view of the file rather than from the file’s own byte stream. Two kinds produce this, both labelled filesystem/<view>: a decode view (filesystem/base64, filesystem/hex, filesystem/reverse, filesystem/quoted-printable) and a windowed read of a large file (filesystem/windowed), whose line numbers are relative to the window, not the file.

The file on disk is readable and its doors are real, so it is still indexed and its targets are still reported. What is missing is a line ANCHOR: the finding’s line does not index the file, so no honest distance exists and every target is charged the maximum decay rather than claiming a proximity the number cannot support.

FileTruncated

The file is longer than max_file_bytes; only its prefix was indexed.

ByteBudgetExhausted

The whole-pass max_total_bytes ceiling was reached before this file.

Implementations

impl CoverageGapReason

pub fn as_str(self) -> &'static str

Stable machine-readable discriminator.

pub fn explain(self) -> &'static str

One calm sentence an operator can act on.

Trait Implementations

impl Clone for CoverageGapReason

fn clone(&self) -> CoverageGapReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CoverageGapReason

impl Debug for CoverageGapReason

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CoverageGapReason

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CoverageGapReason

impl Ord for CoverageGapReason

fn cmp(&self, other: &CoverageGapReason) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for CoverageGapReason

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for CoverageGapReason

fn partial_cmp(&self, other: &CoverageGapReason) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for CoverageGapReason

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CoverageGapReason