somfy-sdk 0.2.2

A Rust-based SDK for interacting with Somfy smart home devices and 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

use crate::commands::traits::{
    HttpMethod, RequestData, SomfyApiRequestCommand, SomfyApiRequestResponse,
};
use crate::commands::types::Setup;
use crate::err::http::RequestError;
use reqwest::header::HeaderMap;
use reqwest::Body;
use std::collections::HashMap;

#[derive(Debug, Clone, PartialEq)]
pub struct GetSetupCommand;

impl SomfyApiRequestCommand for GetSetupCommand {
    type Response = GetSetupResponse;
    fn to_request(&self) -> Result<RequestData, RequestError> {
        Ok(RequestData {
            path: "/enduser-mobile-web/1/enduserAPI/setup".to_string(),
            method: HttpMethod::GET,
            body: Body::default(),
            query_params: HashMap::default(),
            header_map: HeaderMap::default(),
        })
    }
}

pub type GetSetupResponse = Setup;

impl SomfyApiRequestResponse for GetSetupResponse {}

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

    #[test]
    fn test_to_request() {
        let command = GetSetupCommand;
        let request = command
            .to_request()
            .expect("should create valid request data");

        assert_eq!(request.path, "/enduser-mobile-web/1/enduserAPI/setup");
        assert_eq!(request.method, HttpMethod::GET);
        assert!(request.query_params.is_empty());
        assert!(request.header_map.is_empty());
        assert!(request
            .body
            .as_bytes()
            .expect("should read body bytes")
            .is_empty());
    }
}

#[cfg(test)]
#[test]
fn parse_valid_body_correctly() {
    let body = r#"{
        "gateways": [
            {
                "connectivity": {
                    "status": "OK",
                    "protocolVersion": "2025.3.2-7"
                },
                "gatewayId": "0000-1111-2222"
            }
        ],
        "devices": [
            {
                "deviceURL": "io://0000-1111-2222/12345678",
                "label": "Test Device",
                "controllableName": "io:StackComponent",
                "subsystemId": 1,
                "type": 1,
                "available": true,
                "synced": true,
                "enabled": true,
                "states": [],
                "attributes": []
            }
        ]
    }"#;
    let resp = GetSetupResponse::from_body(body).expect("should parse valid body correctly");

    assert_eq!(resp.gateways.len(), 1);
    assert_eq!(resp.devices.len(), 1);
    assert_eq!(resp.gateways[0].gateway_id, "0000-1111-2222");
    assert_eq!(resp.devices[0].label, "Test Device");
}