tmuxctl 0.1.0

A bidirectional tmux control-mode (tmux -C) client: typed notification stream, command reply correlation, pane-output decoding, and layout-tree parsing.
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

//! The three wire identifiers tmux uses, each with its sigil baked into `Display`.

/// Declare a `u32` newtype whose `Display` prepends tmux's wire sigil.
macro_rules! wire_id {
    ($(#[$meta:meta])* $name:ident, $sigil:literal) => {
        $(#[$meta])*
        #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, PartialOrd, Ord)]
        pub struct $name(pub u32);

        impl std::fmt::Display for $name {
            fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
                write!(f, concat!($sigil, "{}"), self.0)
            }
        }
    };
}

wire_id!(
    /// A tmux pane id — `%<n>` on the wire.
    PaneId, "%"
);
wire_id!(
    /// A tmux window id — `@<n>` on the wire.
    WindowId, "@"
);
wire_id!(
    /// A tmux session id — `$<n>` on the wire.
    SessionId, "$"
);

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

    #[test]
    fn display_prepends_sigil() {
        assert_eq!(PaneId(3).to_string(), "%3");
        assert_eq!(WindowId(0).to_string(), "@0");
        assert_eq!(SessionId(12).to_string(), "$12");
    }
}