tapo 0.9.0

Unofficial Tapo API Client. Works with TP-Link Tapo smart devices. Tested with light bulbs (L510, L520, L530, L535, L610, L630), light strips (L900, L920, L930), plugs (P100, P105, P110, P110M, P115), power strips (P300, P304M, P306, P316M), hubs (H100), switches (S200B, S200D, S210) and sensors (KE100, T100, T110, T300, T310, T315).
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
145
146
147
148

use chrono::{DateTime, Duration, Timelike as _, Utc};
use serde::Serialize;

use crate::requests::PowerDataInterval;

#[derive(Debug, Default, Serialize)]
pub(crate) struct GetPowerDataParams {
    start_timestamp: u64,
    end_timestamp: u64,
    interval: u64,
}

impl GetPowerDataParams {
    pub fn new(interval: PowerDataInterval) -> Self {
        match interval {
            PowerDataInterval::Every5Minutes {
                start_date_time,
                end_date_time,
            } => Self {
                start_timestamp: get_5_minute_interval_start(start_date_time).timestamp() as u64,
                end_timestamp: get_5_minute_interval_start(end_date_time).timestamp() as u64,
                interval: 5,
            },
            PowerDataInterval::Hourly {
                start_date_time,
                end_date_time,
            } => Self {
                start_timestamp: get_hourly_interval_start(start_date_time).timestamp() as u64,
                end_timestamp: get_hourly_interval_start(end_date_time).timestamp() as u64,
                interval: 60,
            },
        }
    }
}

fn get_5_minute_interval_start(date: DateTime<Utc>) -> DateTime<Utc> {
    // Seconds since start of the hour
    let secs_into_hour = (date.minute() as i64) * 60 + date.second() as i64;
    let rem = secs_into_hour % 300; // 300 = 5 * 60

    // If already exactly on a 5‑minute boundary (and second == 0) keep as-is.
    if rem == 0 && date.second() == 0 {
        return date
            .with_second(0)
            .expect("set second")
            .with_nanosecond(0)
            .expect("set nanos");
    }

    // Otherwise add the remaining seconds to reach the next 5‑minute boundary.
    let add = 300 - rem;
    let adjusted = date + Duration::seconds(add);

    adjusted
        .with_second(0)
        .expect("Failed to set second")
        .with_nanosecond(0)
        .expect("Failed to set nanos")
}

fn get_hourly_interval_start(date: DateTime<Utc>) -> DateTime<Utc> {
    // If already exactly on an hour boundary, keep it.
    if date.minute() == 0 && date.second() == 0 && date.nanosecond() == 0 {
        return date;
    }

    // Truncate to the current hour then add one hour (chrono handles day rollover).
    let hour_start = date
        .with_minute(0)
        .expect("Failed to set minute")
        .with_second(0)
        .expect("Failed to set second")
        .with_nanosecond(0)
        .expect("Failed to set nanos");

    hour_start + Duration::hours(1)
}

#[cfg(test)]
mod tests {
    use chrono::{Datelike as _, TimeZone as _};

    use super::*;

    #[test]
    fn test_get_5_minute_interval_start() {
        // Exact 5-minute interval, no change
        let date = Utc.with_ymd_and_hms(2025, 1, 1, 15, 0, 0).unwrap();
        let adjusted = get_5_minute_interval_start(date);
        assert_eq!(adjusted.hour(), 15);
        assert_eq!(adjusted.minute(), 0);
        assert_eq!(adjusted.second(), 0);

        // Non-exact 5-minute interval, round up to next 5-minute mark
        let date = Utc.with_ymd_and_hms(2025, 1, 1, 14, 3, 45).unwrap();
        let adjusted = get_5_minute_interval_start(date);
        assert_eq!(adjusted.hour(), 14);
        assert_eq!(adjusted.minute(), 5);
        assert_eq!(adjusted.second(), 0);

        // Non-exact 5-minute interval, round up to next hour
        let date = Utc.with_ymd_and_hms(2025, 1, 1, 14, 57, 30).unwrap();
        let adjusted = get_5_minute_interval_start(date);
        assert_eq!(adjusted.hour(), 15);
        assert_eq!(adjusted.minute(), 0);
        assert_eq!(adjusted.second(), 0);

        // Non-exact 5-minute interval, round up to next day
        let date = Utc.with_ymd_and_hms(2025, 1, 1, 23, 58, 59).unwrap();
        let adjusted = get_5_minute_interval_start(date);
        assert_eq!(adjusted.hour(), 0);
        assert_eq!(adjusted.minute(), 0);
        assert_eq!(adjusted.second(), 0);
        assert_eq!(adjusted.day(), 2);
    }

    #[test]
    fn test_get_hourly_interval_start() {
        // Exact hour, no change
        let date = Utc.with_ymd_and_hms(2025, 1, 1, 15, 0, 0).unwrap();
        let adjusted = get_hourly_interval_start(date);
        assert_eq!(adjusted.hour(), 15);
        assert_eq!(adjusted.minute(), 0);
        assert_eq!(adjusted.second(), 0);

        // Non-exact hour, round up to next hour
        let date = Utc.with_ymd_and_hms(2025, 1, 1, 14, 15, 0).unwrap();
        let adjusted = get_hourly_interval_start(date);
        assert_eq!(adjusted.hour(), 15);
        assert_eq!(adjusted.minute(), 0);
        assert_eq!(adjusted.second(), 0);

        // Non-exact hour, round up to next hour
        let date = Utc.with_ymd_and_hms(2025, 1, 1, 14, 0, 30).unwrap();
        let adjusted = get_hourly_interval_start(date);
        assert_eq!(adjusted.hour(), 15);
        assert_eq!(adjusted.minute(), 0);
        assert_eq!(adjusted.second(), 0);

        // Non-exact hour, round up to next day
        let date = Utc.with_ymd_and_hms(2025, 1, 1, 23, 30, 59).unwrap();
        let adjusted = get_hourly_interval_start(date);
        assert_eq!(adjusted.hour(), 0);
        assert_eq!(adjusted.minute(), 0);
        assert_eq!(adjusted.second(), 0);
        assert_eq!(adjusted.day(), 2);
    }
}