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

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

#[derive(Debug, Clone, PartialEq)]
pub struct GetDeviceStatesCommand<'a> {
    pub device_url: &'a str,
}

impl SomfyApiRequestCommand for GetDeviceStatesCommand<'_> {
    type Response = GetDeviceStatesResponse;
    fn to_request(&self) -> Result<RequestData, RequestError> {
        let encoded_device_url = encode(self.device_url);
        Ok(RequestData {
            path: format!(
                "/enduser-mobile-web/1/enduserAPI/setup/devices/{encoded_device_url}/states"
            ),
            method: HttpMethod::GET,
            body: Body::default(),
            query_params: HashMap::default(),
            header_map: HeaderMap::default(),
        })
    }
}

pub type GetDeviceStatesResponse = Vec<DeviceState>;

impl SomfyApiRequestResponse for GetDeviceStatesResponse {}

#[cfg(test)]
#[test]
fn parse_valid_body_correctly() {
    use crate::commands::types::DeviceStateValue;
    let body = r#"[
        {
            "name": "core:StatusState",
            "type": 3,
            "value": "available"
        }
    ]"#;
    let resp = GetDeviceStatesResponse::from_body(body).expect("should parse valid body correctly");

    assert_eq!(resp.len(), 1);
    assert_eq!(resp[0].name, "core:StatusState");
    assert_eq!(resp[0].state_type, 3);
    if let DeviceStateValue::String(value) = &resp[0].value {
        assert_eq!(value, "available");
    } else {
        panic!("Expected string value");
    }
}

#[test]
fn url_encoding_works_correctly() {
    let command = GetDeviceStatesCommand {
        device_url: "io://0000-1111-2222/12345678",
    };
    let request_data = command.to_request().expect("should not err");
    assert_eq!(
        request_data.path,
        "/enduser-mobile-web/1/enduserAPI/setup/devices/io%3A%2F%2F0000-1111-2222%2F12345678/states"
    );
}

#[test]
fn errs_for_invalid_body() {}