rmux-server 0.10.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

use super::*;
use std::sync::atomic::AtomicBool;
use std::sync::Arc;

use crate::control::{ControlModeUpgrade, ControlServerEvent, CONTROL_SERVER_EVENT_CAPACITY};
use crate::handler::ControlRegistration;
use crate::outer_terminal::OuterTerminalContext;
use rmux_os::identity::UserIdentity;
use tokio::sync::mpsc;

#[tokio::test]
async fn parsed_command_list_routes_start_server_and_named_inventory_lookups() {
    let handler = RequestHandler::new();
    let parsed = CommandParser::new()
        .parse(
            "start-server ; \
             list-commands -F '#{command_list_name}|#{command_list_usage}' send-keys ; \
             list-commands -F '#{command_list_name}|#{command_list_usage}' set-buffer ; \
             list-commands -F '#{command_list_name}|#{command_list_usage}' set-environment ; \
             list-commands -F '#{command_list_name}|#{command_list_usage}' show-environment ; \
             list-commands -F '#{command_list_name}|#{command_list_usage}' show-hooks ; \
             list-commands -F '#{command_list_name}|#{command_list_usage}' refresh-client ; \
             list-commands -F '#{command_list_name}|#{command_list_usage}' switch-client ; \
             list-commands -F '#{?command_list_alias,alias,none}' list-commands",
        )
        .expect("command list parses");

    let output = handler
        .execute_parsed_commands_for_test(std::process::id(), parsed)
        .await
        .expect("shared queue inventory succeeds");

    assert_eq!(
        String::from_utf8(output.stdout).expect("inventory output is utf-8"),
        concat!(
            "send-keys|[-FHKlMRX] [-c target-client] [-N repeat-count] [-t target-pane] [key ...]\n",
            "set-buffer|[-aw] [-b buffer-name] [-n new-buffer-name] [-t target-client] [data]\n",
            "set-environment|[-Fhgru] [-t target-session] variable [value]\n",
            "show-environment|[-hgs] [-t target-session] [variable]\n",
            "show-hooks|[-gpw] [-t target-pane] [hook]\n",
            "refresh-client|[-lS] [-C XxY] [-f flags] [-F flags] [-t target-client]\n",
            "switch-client|[-ElnprZ] [-c target-client] [-t target-session] [-T key-table] [-O order]\n",
            "alias\n",
        )
    );
}

#[tokio::test]
async fn control_queue_allows_read_only_start_server_and_list_commands() {
    let handler = RequestHandler::new();
    let requester_pid = 52_001;
    let (event_tx, _event_rx) = mpsc::channel::<ControlServerEvent>(CONTROL_SERVER_EVENT_CAPACITY);
    handler
        .register_control_with_access(
            requester_pid,
            ControlModeUpgrade {
                initial_command_count: 0,
                mode: rmux_proto::ControlMode::Plain,
                terminal_context: OuterTerminalContext::default(),
            },
            ControlRegistration {
                event_tx,
                closing: Arc::new(AtomicBool::new(false)),
                uid: 1000,
                user: UserIdentity::Uid(1000),
                can_write: false,
            },
        )
        .await
        .expect("control registration succeeds");
    let parsed = CommandParser::new()
        .parse("start-server ; list-commands new-window")
        .expect("control commands parse");

    let result = handler
        .execute_control_commands(requester_pid, parsed)
        .await;

    assert_eq!(result.error, None);
    assert_eq!(
        String::from_utf8(result.stdout).expect("inventory output is utf-8"),
        "new-window (neww) [-abdkPS] [-c start-directory] [-e environment] [-F format] [-n window-name] [-t target-window] [shell-command [argument ...]]\n"
    );
}