tmux_interface 0.4.0

Rust language library for communication with TMUX via CLI
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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158

use crate::Error;
use crate::FormatsOutput;
#[cfg(feature = "tmux_2_5")]
use crate::SessionStack;
use std::str::FromStr;

// XXX: number of all flags, needed for array init
// NOTE: variables were first intoduced in tmux 1.6
// accordingly to tmux.h: Formats
// XXX: check all types
#[derive(Default, PartialEq, Clone, Debug)]
pub struct Session {
    // NOTE: u64
    /// session_activity - Time of session last activity
    #[cfg(feature = "tmux_2_1")]
    pub activity: Option<usize>,
    /// session_activity_string - String time of session last activity
    #[cfg(all(feature = "tmux_2_1", not(feature = "tmux_2_2")))]
    pub activity_string: Option<String>,
    /// session_alerts - List of window indexes with alerts
    #[cfg(feature = "tmux_2_1")]
    pub alerts: Option<String>,
    /// session_attached - Number of clients session is attached to
    #[cfg(feature = "tmux_1_6")]
    pub attached: Option<usize>,
    /// session_attached_list - List of clients session is attached to
    #[cfg(feature = "tmux_3_1")]
    pub attached_list: Option<usize>,
    // NOTE: u64
    /// session_created - Time session created
    #[cfg(feature = "tmux_1_6")]
    pub created: Option<usize>,
    /// String time session created
    #[cfg(all(feature = "tmux_1_6", not(feature = "tmux_2_2")))]
    pub created_string: Option<String>,
    /// 1 if format is for a session (not assuming the current)
    #[cfg(feature = "tmux_2_6")]
    pub format: Option<bool>,
    /// session_group - Name of session group
    #[cfg(feature = "tmux_1_6")]
    pub group: Option<String>,
    /// session_group_attached - Number of clients sessions in group are attached >
    #[cfg(feature = "tmux_3_1")]
    pub group_attached: Option<usize>,
    /// session_group_attached_list - List of clients sessions in group are attached to
    #[cfg(feature = "tmux_3_1")]
    pub group_attached_list: Option<String>,
    /// session_group_list - List of sessions in group
    #[cfg(feature = "tmux_2_7")]
    pub group_list: Option<String>,
    /// session_group_many_attached - 1 if multiple clients attached to sessions in gro
    #[cfg(feature = "tmux_3_1")]
    pub group_many_attached: Option<bool>,
    /// session_size - Size of session group
    #[cfg(feature = "tmux_2_7")]
    pub group_size: Option<String>,
    /// session_grouped - 1 if session in a group
    #[cfg(feature = "tmux_1_6")]
    pub grouped: Option<bool>,
    /// session_height - Height of session
    #[cfg(all(feature = "tmux_1_6", not(feature = "tmux_2_9")))]
    pub height: Option<usize>,
    /// session_width - Width of session
    #[cfg(all(feature = "tmux_1_6", not(feature = "tmux_2_9")))]
    pub width: Option<usize>,
    /// session_id - Unique session ID
    #[cfg(feature = "tmux_1_8")]
    pub id: Option<usize>,
    // NOTE: u64
    /// session_last_attached - Time session last attached
    #[cfg(feature = "tmux_2_1")]
    pub last_attached: Option<usize>,
    /// session_last_attached_string - String time session last attached
    #[cfg(all(feature = "tmux_2_1", not(feature = "tmux_2_2")))]
    pub last_attached_string: Option<String>,
    /// session_many_attached - 1 if multiple clients attached
    #[cfg(feature = "tmux_2_0")]
    pub many_attached: Option<bool>,
    /// session_name - #S Name of session
    #[cfg(feature = "tmux_1_6")]
    pub name: Option<String>,
    /// session_stack - Window indexes in most recent order
    #[cfg(feature = "tmux_2_5")]
    pub stack: Option<SessionStack>,
    /// session_windows - Number of windows in session
    #[cfg(feature = "tmux_1_6")]
    pub windows: Option<usize>,
}

impl FromStr for Session {
    type Err = Error;

    fn from_str(s: &str) -> Result<Self, Error> {
        let mut session = Session::new();
        let mut format = FormatsOutput::new();
        format.separator(':');

        #[cfg(feature = "tmux_2_1")]
        format.session_activity(&mut session.activity);
        #[cfg(all(feature = "tmux_2_1", not(feature = "tmux_2_2")))]
        format.session_activity_string(&mut session.activity_string);
        #[cfg(feature = "tmux_2_1")]
        format.session_alerts(&mut session.alerts);
        #[cfg(feature = "tmux_1_6")]
        format.session_attached(&mut session.attached);
        #[cfg(feature = "tmux_3_1")]
        format.session_attached_list(&mut session.attached_list);
        #[cfg(feature = "tmux_1_6")]
        format.session_created(&mut session.created);
        #[cfg(all(feature = "tmux_1_6", not(feature = "tmux_2_2")))]
        format.session_created_string(&mut session.created_string);
        #[cfg(feature = "tmux_2_6")]
        format.session_format(&mut session.format);
        #[cfg(feature = "tmux_1_6")]
        format.session_group(&mut session.group);
        #[cfg(feature = "tmux_3_1")]
        format.session_group_attached(&mut session.group_attached);
        #[cfg(feature = "tmux_3_1")]
        format.session_group_attached_list(&mut session.group_attached_list);
        #[cfg(feature = "tmux_2_7")]
        format.session_group_list(&mut session.group_list);
        #[cfg(feature = "tmux_3_1")]
        format.session_group_many_attached(&mut session.group_many_attached);
        #[cfg(feature = "tmux_2_7")]
        format.session_group_size(&mut session.group_size);
        #[cfg(feature = "tmux_1_6")]
        format.session_grouped(&mut session.grouped);
        #[cfg(all(feature = "tmux_1_6", not(feature = "tmux_2_9")))]
        format.session_height(&mut session.height);
        #[cfg(all(feature = "tmux_1_6", not(feature = "tmux_2_9")))]
        format.session_width(&mut session.width);
        #[cfg(feature = "tmux_1_8")]
        format.session_id(&mut session.id);
        #[cfg(feature = "tmux_2_1")]
        format.session_last_attached(&mut session.last_attached);
        #[cfg(all(feature = "tmux_2_1", not(feature = "tmux_2_2")))]
        format.session_last_attached_string(&mut session.last_attached_string);
        #[cfg(feature = "tmux_2_0")]
        format.session_many_attached(&mut session.many_attached);
        #[cfg(feature = "tmux_1_6")]
        format.session_name(&mut session.name);
        #[cfg(feature = "tmux_2_5")]
        format.session_stack(&mut session.stack);
        #[cfg(feature = "tmux_1_6")]
        format.session_windows(&mut session.windows);

        FormatsOutput::from_string_ext(s, &mut format);
        Ok(session)
    }
}

impl Session {
    pub fn new() -> Self {
        Default::default()
    }

    // XXX: wrapper with format generating and result parsing using callback
}