chml_api 0.8.0

Rust SDK for ChmlFrp
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

pub mod function;
pub mod schema;

use crate::{
    ChmlApi,
    res::{ApiError, ApiResult},
    schema::Tunnel,
};

impl ChmlApi {
    /// get_tunnels
    pub async fn tunnel(&self) -> ApiResult<Vec<schema::Tunnel>> {
        function::get_tunnels(self).await
    }

    /// create_tunnel
    pub async fn create_tunnel(
        &self,
        params: &function::CreateTunnelParams,
    ) -> ApiResult<schema::Tunnel> {
        function::create_tunnel(self, params).await
    }

    /// delete_tunnel
    pub async fn delete_tunnel(&self, tunnel_id: &str) -> ApiResult<()> {
        function::delete_tunnel(self, tunnel_id).await
    }

    /// update_tunnel
    pub async fn update_tunnel(
        &self,
        tunnel_update: schema::TunnelUpdate,
    ) -> ApiResult<schema::Tunnel> {
        function::update_tunnel(self, tunnel_update).await
    }

    /// tunnel_config
    pub async fn tunnel_config(&self, node: &str, tunnel_names: &[&str]) -> ApiResult<String> {
        function::get_tunnel_config(self, node, tunnel_names).await
    }

    pub async fn _select_tunnel(
        &self,
        tunnel_name: Option<&str>,
        tunnel_id: Option<u64>,
    ) -> Result<Tunnel, ApiError> {
        let tunnels = self.tunnel().await?.into_result()?;
        let tunnel = match (tunnel_name, tunnel_id) {
            (Some(name), _) => tunnels
                .into_iter()
                .find(|t| t.name.contains(name))
                .ok_or_else(|| ApiError::NotFound(format!("tunnel '{}' not found", name)))?,

            (None, Some(id)) => tunnels
                .into_iter()
                .find(|t| t.id == Some(id))
                .ok_or_else(|| ApiError::NotFound(format!("tunnel id '{}' not found", id)))?,

            _ => {
                return Err(ApiError::GenericError(
                    "either tunnel_name or tunnel_id must be provided".into(),
                ));
            }
        };

        Ok(tunnel)
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::prelude::*;
    #[tokio::test]
    async fn test_tunnel() {
        init_logger();
        let chml_api = ChmlApi::from_env().unwrap();

        let res = chml_api.tunnel().await;
        println!("{:?}", res);
    }

    #[tokio::test]
    async fn test_create_tunnel() {
        init_logger();
        let chml_api = ChmlApi::from_env().unwrap();

        // 10000-65535 动态生成的话返回409则再次尝试
        let params = function::CreateTunnelParams {
            token: chml_api.get_token().unwrap().to_string(),
            tunnelname: "dyTi7y8a".to_string(),
            node: "中国香港".to_string(),
            localip: "127.0.0.1".to_string(),
            port_type: "TCP".to_string(),
            local_port: 8999,
            encryption: false,
            compression: false,
            extra_params: "".to_string(),
            remote_port: 64272,
        };

        let res = chml_api.create_tunnel(&params).await;
        println!("{:?}", res);
    }

    #[tokio::test]
    async fn test_delete_tunnel() {
        init_logger();
        let chml_api = ChmlApi::from_env().unwrap();

        let res = chml_api.delete_tunnel("239167").await;
        println!("{:?}", res);
    }

    #[tokio::test]
    async fn test_update_tunnel() {
        init_logger();
        let chml_api = ChmlApi::from_env().unwrap();

        let tunnel_update = schema::TunnelUpdate {
            tunnelid: 239172,
            tunnelname: "dddi7y8a".to_string(),
            node: "中国香港".to_string(),
            port_type: "tcp".to_string(),
            localport: 8999,
            encryption: false,
            compression: false,
            localip: "127.0.0.1".to_string(),
            remoteport: 64272,
        };

        let res = chml_api.update_tunnel(tunnel_update).await;
        println!("{:?}", res);
    }

    #[tokio::test]
    async fn test_tunnel_config() {
        init_logger();
        let chml_api = ChmlApi::from_env().unwrap();

        let res = chml_api.tunnel_config("北京多线4", &["RDP"]).await;
        println!("{:?}", res);
    }
}