Struct Candidate 

pub struct Candidate { /* private fields */ }

A discovered location for a binary, with the observed PathTags that describe it.

Fields are private; use the accessors (path, canonical, tags, durability, is_stable). This hides the internal Vec<PathTag> representation so it can change without breaking the public API.

Implementations

impl Candidate

pub fn path(&self) -> &Path

The path of this candidate as discovered (input, PATH entry, symlink target, etc.). Not necessarily canonicalized.

pub fn canonical(&self) -> &Path

The canonical path of this candidate.

When std::fs::canonicalize succeeds this is the real (symlink- and ..-resolved) path. When it fails, it falls back to the candidate’s own path, so this is not guaranteed to always be a realpath.

pub fn tags(&self) -> &[PathTag]

The observed tags describing this candidate.

Tag order is not guaranteed (PathTag::Input / PathTag::InPathEnv happen to lead, but other tags follow in implementation order). Test membership with tags().contains(...) / tags().iter().any(...), not by position.

pub fn durability(&self) -> Durability

The Durability of this candidate’s path: whether the path string can be pinned into a service definition and survive rebuild / upgrade / reboot.

Judged per candidate, so the reference path and the canonical path of the same binary can differ (e.g. /opt/homebrew/bin/git is Durable while /opt/homebrew/Cellar/git/2.44.0/bin/git is NotDurable). See Durability for the judging model and its known limitations.

pub fn is_stable(&self) -> bool

Whether this candidate is durable-to-pin: true iff durability is Durability::Durable.

Durability::Unknown is treated as not stable (safe side).

Trait Implementations

impl Clone for Candidate

fn clone(&self) -> Candidate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Candidate

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

Formats the value using the given formatter.