threexui-rs 2.9.3

Async Rust SDK for the 3x-ui panel API (targets 3x-ui v2.9.3)
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

use serde::Deserialize;

#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct ResourceStat {
    pub current: u64,
    pub total: u64,
}

#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct XrayState {
    pub state: String,
    pub error_msg: String,
    pub version: String,
}

#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct NetIO {
    pub up: u64,
    pub down: u64,
}

#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct NetTraffic {
    pub sent: u64,
    pub recv: u64,
}

#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct PublicIP {
    #[serde(rename = "ipv4")]
    pub ipv4: String,
    #[serde(rename = "ipv6")]
    pub ipv6: String,
}

#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct AppStats {
    pub threads: u32,
    pub mem: u64,
    pub uptime: u64,
}

#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct ServerStatus {
    pub cpu: f64,
    pub cpu_cores: i32,
    pub logical_pro: i32,
    pub cpu_speed_mhz: f64,
    pub mem: ResourceStat,
    pub swap: ResourceStat,
    pub disk: ResourceStat,
    pub xray: XrayState,
    pub uptime: u64,
    #[serde(default)]
    pub loads: Vec<f64>,
    pub tcp_count: i64,
    pub udp_count: i64,
    #[serde(rename = "netIO")]
    pub net_io: NetIO,
    pub net_traffic: NetTraffic,
    #[serde(rename = "publicIP")]
    pub public_ip: PublicIP,
    pub app_stats: AppStats,
}

#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct CpuHistoryPoint {
    pub t: i64,
    pub cpu: f64,
}

#[derive(Debug, Clone, Deserialize)]
pub struct UuidResponse {
    pub uuid: String,
}

#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct X25519Cert {
    pub private_key: String,
    pub public_key: String,
}

#[derive(Debug, Clone, Deserialize)]
pub struct Mldsa65Keys {
    pub seed: String,
    pub verify: String,
}

#[derive(Debug, Clone, Deserialize)]
pub struct Mlkem768Keys {
    pub seed: String,
    pub client: String,
}

#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct EchCert {
    pub ech_server_keys: String,
    pub ech_config_list: String,
}

#[derive(Debug, Clone, Deserialize)]
pub struct VlessAuth {
    pub label: String,
    #[serde(default)]
    pub encryption: String,
    #[serde(default)]
    pub decryption: String,
}

#[derive(Debug, Clone, Deserialize)]
pub struct VlessEncResult {
    pub auths: Vec<VlessAuth>,
}

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

    #[test]
    fn server_status_deserializes() {
        let raw = r#"{
            "cpu":12.5,"cpuCores":4,"logicalPro":8,"cpuSpeedMhz":3200.0,
            "mem":{"current":2048,"total":8192},
            "swap":{"current":0,"total":4096},
            "disk":{"current":10240,"total":51200},
            "xray":{"state":"running","errorMsg":"","version":"1.8.0"},
            "uptime":3600,"loads":[0.5,0.4,0.3],
            "tcpCount":10,"udpCount":5,
            "netIO":{"up":1024,"down":2048},
            "netTraffic":{"sent":102400,"recv":204800},
            "publicIP":{"ipv4":"1.2.3.4","ipv6":"::1"},
            "appStats":{"threads":12,"mem":65536,"uptime":3600}
        }"#;
        let status: ServerStatus = serde_json::from_str(raw).unwrap();
        assert_eq!(status.cpu, 12.5);
        assert_eq!(status.cpu_cores, 4);
        assert_eq!(status.mem.total, 8192);
    }

    #[test]
    fn uuid_response_deserializes() {
        let raw = r#"{"uuid":"550e8400-e29b-41d4-a716-446655440000"}"#;
        let u: UuidResponse = serde_json::from_str(raw).unwrap();
        assert_eq!(u.uuid, "550e8400-e29b-41d4-a716-446655440000");
    }
}