rmux-server 0.9.0

Tokio daemon and request dispatcher for the RMUX terminal multiplexer.
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

use rmux_core::OptionStore;
use rmux_proto::{OptionName, ProcessCommand, SessionName};

/// Resolves the command for a newly created window or pane.
///
/// An explicit command, including an empty shell command, always wins. Without
/// one, `default-command` follows the addressed session's option inheritance.
/// The empty effective value selects the normal `default-shell` path.
pub(crate) fn resolve_new_pane_process_command(
    options: &OptionStore,
    session_name: &SessionName,
    explicit: Option<ProcessCommand>,
) -> Option<ProcessCommand> {
    explicit.or_else(|| {
        options
            .resolve(Some(session_name), OptionName::DefaultCommand)
            .filter(|command| !command.is_empty())
            .map(|command| ProcessCommand::Shell(command.to_owned()))
    })
}

#[cfg(test)]
mod tests {
    use rmux_proto::{ScopeSelector, SetOptionMode};

    use super::*;

    fn session_name(value: &str) -> SessionName {
        SessionName::new(value).expect("valid session name")
    }

    fn set_option(options: &mut OptionStore, scope: ScopeSelector, value: &str) {
        options
            .set(
                scope,
                OptionName::DefaultCommand,
                value.to_owned(),
                SetOptionMode::Replace,
            )
            .expect("default-command mutation succeeds");
    }

    #[test]
    fn explicit_command_wins_even_when_empty() {
        let mut options = OptionStore::new();
        let alpha = session_name("alpha");
        set_option(&mut options, ScopeSelector::Global, "printf inherited");

        let explicit = ProcessCommand::Shell(String::new());

        assert_eq!(
            resolve_new_pane_process_command(&options, &alpha, Some(explicit.clone())),
            Some(explicit)
        );
    }

    #[test]
    fn session_value_overrides_global_and_empty_masks_it() {
        let mut options = OptionStore::new();
        let alpha = session_name("alpha");
        let beta = session_name("beta");
        set_option(&mut options, ScopeSelector::Global, "printf global");
        set_option(
            &mut options,
            ScopeSelector::Session(alpha.clone()),
            "printf local",
        );
        set_option(&mut options, ScopeSelector::Session(beta.clone()), "");

        assert_eq!(
            resolve_new_pane_process_command(&options, &alpha, None),
            Some(ProcessCommand::Shell("printf local".to_owned()))
        );
        assert_eq!(
            resolve_new_pane_process_command(&options, &beta, None),
            None
        );
    }

    #[test]
    fn missing_session_value_falls_back_to_global() {
        let mut options = OptionStore::new();
        let alpha = session_name("alpha");
        set_option(&mut options, ScopeSelector::Global, "printf global");

        assert_eq!(
            resolve_new_pane_process_command(&options, &alpha, None),
            Some(ProcessCommand::Shell("printf global".to_owned()))
        );
    }
}