wintheon 0.1.0

Library to discover, rank and inspect launchable Windows file entries.
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

//! Where a [`FileEntry`](crate::file::FileEntry) was discovered.

use core::fmt;
use std::borrow::Cow;

/// Where a discovered entry came from.
///
/// Built-in variants cover the sources `wintheon` ships out of the box.
/// User-defined [`Source`](super::Source) implementations should return
/// [`Origin::Custom`] with a human-readable label.
///
/// Marked `#[non_exhaustive]` so adding more built-in variants in a
/// future release isn't a breaking change.
#[derive(Debug, Clone, PartialEq, Eq, Hash)]
#[non_exhaustive]
pub enum Origin {
    /// `%USERPROFILE%\Desktop` and `%PUBLIC%\Desktop`. Reported by
    /// [`DesktopSource`](super::DesktopSource).
    Desktop,
    /// Per-user `%APPDATA%\Microsoft\Windows\Start Menu\Programs` and
    /// system-wide `%ProgramData%\Microsoft\Windows\Start Menu\Programs`.
    /// Reported by [`StartMenuSource`](super::StartMenuSource).
    StartMenu,
    /// `%LOCALAPPDATA%\Microsoft\WindowsApps` — the `AppExec` stub
    /// directory used by the Microsoft Store and command-line shims.
    /// Reported by [`WindowsAppsSource`](super::WindowsAppsSource).
    WindowsApps,
    /// User-defined source label. Use `Cow::Borrowed("…")` for static
    /// names (the common case) or `Cow::Owned(…)` for runtime ones.
    Custom(Cow<'static, str>),
}

impl fmt::Display for Origin {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Self::Desktop => f.write_str("Desktop"),
            Self::StartMenu => f.write_str("Start Menu"),
            Self::WindowsApps => f.write_str("Windows Apps"),
            Self::Custom(label) => f.write_str(label),
        }
    }
}