denki 0.2.0

CLI for controlling TP-Link smart home devices — denki (電気) means electricity in Japanese
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

use serde::{Deserialize, Serialize};

use crate::tapo_vendor::responses::TapoResponseExt;

/// A single PTZ preset position.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[cfg_attr(any(), pyo3::prelude::pyclass(from_py_object, get_all))]
pub struct Preset {
    /// Preset identifier.
    pub id: String,
    /// User-assigned name.
    pub name: String,
    /// Pan position (normalized, typically -1.0 to 1.0).
    pub pan: f64,
    /// Tilt position (normalized, typically -1.0 to 1.0).
    pub tilt: f64,
    /// Whether this preset is read-only.
    pub read_only: bool,
}

#[cfg(any())]
crate::tapo_vendor::impl_to_dict!(Preset);

/// Raw preset config as returned by the camera.
/// The camera returns parallel arrays; this struct matches that shape.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub(crate) struct PresetRaw {
    #[serde(default)]
    pub id: Vec<String>,
    #[serde(default)]
    pub name: Vec<String>,
    #[serde(default)]
    pub position_pan: Vec<String>,
    #[serde(default)]
    pub position_tilt: Vec<String>,
    #[serde(default)]
    pub read_only: Vec<String>,
}

impl TapoResponseExt for PresetRaw {}

impl PresetRaw {
    /// Zips the parallel arrays into a list of [`Preset`] structs.
    ///
    /// Entries where `position_pan` or `position_tilt` fail to parse as `f64` are skipped.
    pub fn into_presets(self) -> Vec<Preset> {
        self.id
            .into_iter()
            .zip(self.name)
            .zip(self.position_pan)
            .zip(self.position_tilt)
            .zip(self.read_only)
            .filter_map(|((((id, name), pan), tilt), read_only)| {
                Some(Preset {
                    id,
                    name,
                    pan: pan.parse().ok()?,
                    tilt: tilt.parse().ok()?,
                    read_only: read_only != "0",
                })
            })
            .collect()
    }
}