embers-cli 0.3.0

Interactive terminal UI and automation CLI for the Embers 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
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

//! `display-message`: format expansion with `-p`, and delivery to the
//! clients showing a session.

use std::time::Duration;

use embers_core::new_request_id;
use embers_protocol::{ClientMessage, ClientRequest, ServerEvent, ServerResponse};
use embers_test_support::{TestConnection, TestServer};

use crate::support::{cli_command, run_cli, session_snapshot_by_name, stdout};

async fn alpha_with_window(server: &TestServer) -> String {
    run_cli(server, ["new-session", "alpha"]);
    run_cli(
        server,
        [
            "new-window",
            "-t",
            "alpha",
            "--title",
            "editor",
            "--",
            "/bin/sh",
        ],
    );
    let panes = stdout(&run_cli(server, ["list-panes", "-t", "alpha:0"]));
    panes.split('\t').next().expect("a pane").to_owned()
}

#[tokio::test(flavor = "multi_thread", worker_threads = 2)]
async fn display_message_print_expands_formats() {
    let server = TestServer::start().await.expect("start server");
    let pane = alpha_with_window(&server).await;

    let printed = run_cli(
        &server,
        [
            "display-message",
            "-p",
            "-t",
            &pane,
            "[#S] #I:#W pane #D ## #{pane_current_command}",
        ],
    );
    assert_eq!(
        stdout(&printed).trim_end(),
        format!("[alpha] 0:editor pane {pane} # sh")
    );

    let numbered = run_cli(
        &server,
        [
            "--base-index",
            "1",
            "display-message",
            "-p",
            "-t",
            &pane,
            "#I",
        ],
    );
    assert_eq!(stdout(&numbered).trim_end(), "1");

    // Words are joined like tmux joins a quoted message.
    let joined = run_cli(&server, ["display-message", "-p", "hello", "#S"]);
    assert_eq!(stdout(&joined).trim_end(), "hello alpha");

    server.shutdown().await.expect("shutdown server");
}

#[tokio::test(flavor = "multi_thread", worker_threads = 2)]
async fn display_message_reaches_clients_showing_the_session() {
    let server = TestServer::start().await.expect("start server");
    let pane = alpha_with_window(&server).await;

    // Without an attached client there is nowhere to show the message.
    let nobody = cli_command(&server)
        .args(["display-message", "-t", &pane, "hi"])
        .output()
        .expect("cli runs");
    assert!(!nobody.status.success());
    let stderr = String::from_utf8_lossy(&nobody.stderr);
    assert!(stderr.contains("no client"), "stderr: {stderr}");

    let mut client = TestConnection::connect(server.socket_path())
        .await
        .expect("connect");
    client.subscribe(None).await.expect("subscribe");
    let session_id = session_snapshot_by_name(&mut client, "alpha")
        .await
        .session
        .id;
    let response = client
        .request(&ClientMessage::Client(ClientRequest::Switch {
            request_id: new_request_id(),
            client_id: None,
            session_id,
        }))
        .await
        .expect("switch");
    let client_id = match response {
        ServerResponse::Client(response) => response.client.id,
        other => panic!("unexpected response {other:?}"),
    };

    run_cli(&server, ["display-message", "-d", "1500", "#S says hi"]);
    let event = client
        .wait_for_event(Duration::from_secs(5), |event| {
            matches!(event, ServerEvent::DisplayMessage(_))
        })
        .await
        .expect("display message event");
    let ServerEvent::DisplayMessage(event) = event else {
        unreachable!()
    };
    assert_eq!(event.message, "alpha says hi");
    assert_eq!(event.duration_ms, 1500);

    run_cli(
        &server,
        ["display-message", "-c", &client_id.to_string(), "direct"],
    );
    let event = client
        .wait_for_event(Duration::from_secs(5), |event| {
            matches!(event, ServerEvent::DisplayMessage(_))
        })
        .await
        .expect("display message event");
    let ServerEvent::DisplayMessage(event) = event else {
        unreachable!()
    };
    assert_eq!(event.message, "direct");
    assert_eq!(event.duration_ms, 0);

    server.shutdown().await.expect("shutdown server");
}