Struct ExecutableLookup 

pub struct ExecutableLookup<'env> { /* private fields */ }

Read-only executable lookup against a caller-owned environment snapshot.

Construction borrows the map without reading the process environment. Lookup applies the native PATH/PATHEXT rules and inspects candidate file metadata; it never starts a program or creates cache state. The snapshot does not freeze the filesystem, and a returned path grants no execution authority to a caller.

Implementations

impl<'env> ExecutableLookup<'env>

pub const fn new(environment: &'env BTreeMap<String, String>) -> Self

Borrow an existing environment without copying or refreshing it.

pub fn environment_value(&self, name: &str) -> Option<&'env str>

Read one borrowed value with native environment-name case rules.

Exact spelling wins. Windows additionally accepts ASCII case variants; other platforms retain case-sensitive lookup.

pub fn find(&self, name: &str) -> Option<PathBuf>

Find the first directly runnable candidate without executing it.

Candidate precedence and executable checks use the current platform’s conventions. A missing PATH or eligible file returns None.