auditmysite 1.4.0

Resource-efficient WCAG 2.1 AA (+ select 2.2 criteria) Accessibility Checker in Rust
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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163

//! Browser registry - platform-specific paths and search order
//!
//! Defines known browser locations for each platform in priority order.

use super::types::BrowserKind;

/// An entry in the browser registry
pub struct RegistryEntry {
    pub kind: BrowserKind,
    pub path: &'static str,
}

/// Known browser paths for the current platform, in priority order
pub fn system_browser_paths() -> Vec<RegistryEntry> {
    let mut entries = Vec::new();

    #[cfg(target_os = "macos")]
    {
        entries.extend([
            RegistryEntry {
                kind: BrowserKind::Chrome,
                path: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
            },
            RegistryEntry {
                kind: BrowserKind::Edge,
                path: "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
            },
            RegistryEntry {
                kind: BrowserKind::UngoogledChromium,
                path: "/Applications/Ungoogled Chromium.app/Contents/MacOS/Chromium",
            },
            RegistryEntry {
                kind: BrowserKind::Chromium,
                path: "/Applications/Chromium.app/Contents/MacOS/Chromium",
            },
            RegistryEntry {
                kind: BrowserKind::Chromium,
                path: "/opt/homebrew/bin/chromium",
            },
            RegistryEntry {
                kind: BrowserKind::Chromium,
                path: "/usr/local/bin/chromium",
            },
        ]);
    }

    #[cfg(target_os = "linux")]
    {
        entries.extend([
            RegistryEntry {
                kind: BrowserKind::Chrome,
                path: "/usr/bin/google-chrome",
            },
            RegistryEntry {
                kind: BrowserKind::Chrome,
                path: "/usr/bin/google-chrome-stable",
            },
            RegistryEntry {
                kind: BrowserKind::Edge,
                path: "/usr/bin/microsoft-edge",
            },
            RegistryEntry {
                kind: BrowserKind::Edge,
                path: "/usr/bin/microsoft-edge-stable",
            },
            RegistryEntry {
                kind: BrowserKind::UngoogledChromium,
                path: "/usr/bin/ungoogled-chromium",
            },
            RegistryEntry {
                kind: BrowserKind::Chromium,
                path: "/usr/bin/chromium",
            },
            RegistryEntry {
                kind: BrowserKind::Chromium,
                path: "/usr/bin/chromium-browser",
            },
            RegistryEntry {
                kind: BrowserKind::Chromium,
                path: "/snap/bin/chromium",
            },
            RegistryEntry {
                kind: BrowserKind::Chromium,
                path: "/var/lib/flatpak/exports/bin/org.chromium.Chromium",
            },
        ]);
    }

    #[cfg(target_os = "windows")]
    {
        entries.extend([
            RegistryEntry {
                kind: BrowserKind::Chrome,
                path: r"C:\Program Files\Google\Chrome\Application\chrome.exe",
            },
            RegistryEntry {
                kind: BrowserKind::Chrome,
                path: r"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe",
            },
            RegistryEntry {
                kind: BrowserKind::Edge,
                path: r"C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe",
            },
            RegistryEntry {
                kind: BrowserKind::Edge,
                path: r"C:\Program Files\Microsoft\Edge\Application\msedge.exe",
            },
        ]);
    }

    entries
}

/// Search terms for `which`/`where` per BrowserKind
pub fn which_names(kind: BrowserKind) -> &'static [&'static str] {
    match kind {
        BrowserKind::Chrome => &["google-chrome", "google-chrome-stable"],
        BrowserKind::Edge => &["microsoft-edge", "microsoft-edge-stable"],
        BrowserKind::UngoogledChromium => &["ungoogled-chromium"],
        BrowserKind::Chromium => &["chromium", "chromium-browser"],
        _ => &[],
    }
}

/// Priority order for automatic browser search
pub fn search_order() -> &'static [BrowserKind] {
    &[
        BrowserKind::Chrome,
        BrowserKind::Edge,
        BrowserKind::UngoogledChromium,
        BrowserKind::Chromium,
    ]
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_system_browser_paths_not_empty() {
        let paths = system_browser_paths();
        assert!(
            !paths.is_empty()
                || cfg!(not(any(
                    target_os = "macos",
                    target_os = "linux",
                    target_os = "windows"
                )))
        );
    }

    #[test]
    fn test_search_order_starts_with_chrome() {
        let order = search_order();
        assert_eq!(order[0], BrowserKind::Chrome);
    }

    #[test]
    fn test_which_names_chrome() {
        let names = which_names(BrowserKind::Chrome);
        assert!(names.contains(&"google-chrome"));
    }
}