patholog 1.0.0

Diagnose, explain, clean, and safely repair PATH behavior.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

use std::path::{Path, PathBuf};

use crate::model::{PathEntry, PlatformRules, ResolutionCandidate};

use super::filesystem::find_executable;
use super::names::candidate_names;

pub(super) fn find_candidates(
    entries: &[PathEntry],
    command: &str,
    rules: &PlatformRules,
    cwd: &Path,
) -> Vec<ResolutionCandidate> {
    let mut candidates = Vec::new();
    let candidate_names = candidate_names(command, rules);

    for entry in entries {
        let Some(directory) = entry_directory(entry, cwd) else {
            continue;
        };
        for candidate_name in &candidate_names {
            let Some(candidate_path) = find_executable(&directory, candidate_name, rules) else {
                continue;
            };
            candidates.push(ResolutionCandidate {
                entry_index: entry.index,
                directory: searched_directory_display(entry),
                path: candidate_path.display().to_string(),
                wins: false,
            });
        }
    }

    mark_winner(candidates)
}

pub(super) fn searched_directory_display(entry: &PathEntry) -> String {
    if entry.is_empty {
        "<empty entry: current directory>".to_owned()
    } else {
        entry.display.clone()
    }
}

fn entry_directory(entry: &PathEntry, cwd: &Path) -> Option<PathBuf> {
    if entry.is_empty {
        return Some(cwd.to_path_buf());
    }
    if entry.is_dir {
        return Some(PathBuf::from(&entry.raw));
    }
    None
}

fn mark_winner(mut candidates: Vec<ResolutionCandidate>) -> Vec<ResolutionCandidate> {
    let Some(winning_key) = candidates
        .first()
        .map(|candidate| (candidate.entry_index, candidate.path.clone()))
    else {
        return Vec::new();
    };

    for candidate in &mut candidates {
        candidate.wins = candidate.entry_index == winning_key.0 && candidate.path == winning_key.1;
    }
    candidates
}