Enum PathTag 

#[non_exhaustive]
pub enum PathTag {
    Input,
    InPathEnv(usize),
    SymlinkTo(PathBuf),
    Shim,
    SameCanonical,
    SameContent,
    Relative,
    NonNormalized,
    DifferentBinary,
    ManagedBy(String),
    BuildOutput,
    Ephemeral,
    NotExecutable,
}

Observed properties of a candidate path.

Tags describe how a candidate was found and what role it plays. Multiple tags can be attached to a single candidate. See Candidate::tags.

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.

Input

The path that was passed as input

InPathEnv(usize)

Found in PATH environment variable (holds discovery order: 0 = first PATH match)

SymlinkTo(PathBuf)

Is a symlink, pointing to the given target

Shim

In a shim directory or symlink target name doesn’t match candidate name

SameCanonical

Canonical path matches the input binary (same file)

SameContent

File content matches the input binary byte-for-byte (copied identical binary)

Relative

Relative path (doesn’t start with /)

NonNormalized

Non-normalized path (contains .. or . components)

DifferentBinary

Same name but different binary (canonical and content both differ)

ManagedBy(String)

Under a version manager (holds manager name)

BuildOutput

Inside a build output directory

Ephemeral

Inside a temporary/cache directory

NotExecutable

Not directly executable (no execute permission, or ambiguous bare relative path)

Trait Implementations

impl Clone for PathTag

fn clone(&self) -> PathTag

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathTag

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

Formats the value using the given formatter.

impl Eq for PathTag

impl PartialEq for PathTag

fn eq(&self, other: &PathTag) -> 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 StructuralPartialEq for PathTag