drogue-client 0.11.1

Clients for the Drogue IoT Cloud APIs
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

use crate::serde::is_default;
use serde::{Deserialize, Serialize};

#[derive(Clone, Debug, PartialEq, Eq, Deserialize, Serialize)]
pub struct CoapEndpoint {
    pub url: String,
}

#[derive(Clone, Debug, PartialEq, Eq, Deserialize, Serialize)]
pub struct HttpEndpoint {
    pub url: String,
}

#[derive(Clone, Debug, PartialEq, Eq, Deserialize, Serialize)]
pub struct MqttEndpoint {
    pub host: String,
    pub port: u16,
}

#[derive(Clone, Debug, PartialEq, Eq, Deserialize, Serialize)]
pub struct RegistryEndpoint {
    pub url: String,
}

#[derive(Clone, Debug, Default, PartialEq, Eq, Deserialize, Serialize)]
pub struct Endpoints {
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub api: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub console: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub coap: Option<CoapEndpoint>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub http: Option<HttpEndpoint>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mqtt: Option<MqttEndpoint>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mqtt_ws: Option<HttpEndpoint>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mqtt_ws_browser: Option<HttpEndpoint>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mqtt_integration: Option<MqttEndpoint>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mqtt_integration_ws: Option<HttpEndpoint>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub mqtt_integration_ws_browser: Option<HttpEndpoint>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub websocket_integration: Option<HttpEndpoint>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub sso: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub issuer_url: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub redirect_url: Option<String>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub registry: Option<RegistryEndpoint>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub command_url: Option<String>,
    #[serde(default, skip_serializing_if = "is_default")]
    pub local_certs: bool,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub kafka_bootstrap_servers: Option<String>,
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub demos: Vec<(String, String)>,
}

impl Endpoints {
    /// The endpoint list visible for non-authenticated requests
    pub fn publicize(&self) -> Endpoints {
        Endpoints {
            coap: None,
            http: None,
            mqtt: None,
            mqtt_ws: None,
            mqtt_ws_browser: None,
            mqtt_integration: None,
            mqtt_integration_ws: None,
            mqtt_integration_ws_browser: None,
            websocket_integration: None,
            sso: self.sso.clone(),
            api: self.api.clone(),
            console: self.console.clone(),
            issuer_url: self.issuer_url.clone(),
            redirect_url: None,
            registry: self.registry.clone(),
            command_url: None,
            kafka_bootstrap_servers: None,
            local_certs: false,
            demos: vec![],
        }
    }
}

/// This struct is a copy / paste from https://github.com/drogue-iot/drogue-cloud/blob/main/service-api/src/version.rs
/// It can't really be moved here as it depends on drogue-cloud Cargo file to get a version number.
/// So we just steal the struct to be able to deserialize it.
#[derive(Clone, Debug, Serialize, Deserialize)]
pub struct DrogueVersion {
    pub version: String,
}