shun 0.6.1

Flow-driven payload delivery runtime — installers, flashers, and portable modes
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

//! Pluggable delivery targets.
//!
//! Every target consumes the same flow model ([`crate::flow`]) and payload
//! surface ([`crate::payload`]) but lands the payload differently:
//! [`install`] performs direct registration (Windows: ARP + shortcuts +
//! Explorer verbs; Linux: `.desktop` via [`freedesktop`]; macOS: `.app`
//! bundles via [`macos`]) or skips it for portable mode, [`flash`] writes
//! images to block devices.

pub mod flash;
pub mod freedesktop;
pub mod install;
pub mod macos;
pub mod plist;

/// Machine-scope elevation helpers (self-relaunch via runas).
pub mod elevate;

#[cfg(windows)]
pub mod aumid;

#[cfg(windows)]
pub mod shortcuts;

/// Non-Windows stand-in for [`shortcuts`]. The whole `.lnk` surface —
/// Start-menu entries, desktop links, AUMID stamps, shell notifications —
/// exists only on Windows (`mslnk`/`windows-sys` are
/// `cfg(windows)`-scoped dependencies), so on any other host a shortcut
/// choice simply applies nothing. Keep the signature in lockstep with the
/// real module: the wizard (`crate::wizard::apply_finish`) and the shells
/// call it unconditionally.
#[cfg(not(windows))]
pub mod shortcuts {
    /// Applies a set of shortcut choices — a no-op away from Windows.
    pub fn apply_shortcut_choices(
        _aumid: &str,
        _product: &str,
        _main_exe: &str,
        _desktop: Option<bool>,
        _menu: Option<bool>,
        _dir: &str,
    ) -> Result<(), String> {
        Ok(())
    }

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

        #[test]
        fn shortcut_choices_apply_nothing_away_from_windows() {
            // The install dir is not even checked here — there is nothing
            // to create, so there is nothing to fail on either.
            assert!(
                apply_shortcut_choices("", "Demo", "demo.exe", Some(true), Some(false), "").is_ok()
            );
        }
    }
}