raystack 0.12.0

WIP SkySpark client
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

use crate::{Date, DateTime};
use chrono::SecondsFormat;
use url::Url;

pub(crate) trait HaystackUrl {
    fn about_url(&self) -> Url;
    fn filetypes_url(&self) -> Url;
    fn his_read_url(&self) -> Url;
    fn his_write_url(&self) -> Url;
    fn nav_url(&self) -> Url;
    fn ops_url(&self) -> Url;
    fn read_url(&self) -> Url;
}

/// Represents the different time range queries that can be sent
/// as part of the `hisRead` Haystack operation.
#[derive(Clone, Debug, Eq, PartialEq)]
pub enum HisReadRange {
    /// Query for history values from today.
    Today,
    /// Query for history values from yesterday.
    Yesterday,
    /// Query for history values on a particular date.
    Date(Date),
    /// Query for history values between two dates.
    DateSpan { start: Date, end: Date },
    /// Query for history values between two datetimes.
    DateTimeSpan { start: DateTime, end: DateTime },
    /// Query for history values since a particular datetime.
    SinceDateTime { date_time: DateTime },
}

const DATE_FMT: &str = "%Y-%m-%d";

impl HisReadRange {
    pub(crate) fn to_json_request_string(&self) -> String {
        match self {
            Self::Today => "today".to_owned(),
            Self::Yesterday => "yesterday".to_owned(),
            Self::Date(date) => date.naive_date().format(DATE_FMT).to_string(),
            Self::DateSpan { start, end } => {
                format!(
                    "{},{}",
                    start.naive_date().format(DATE_FMT),
                    end.naive_date().format(DATE_FMT)
                )
            }
            Self::DateTimeSpan { start, end } => {
                let start_str = to_zinc_encoded_string(start);
                let end_str = to_zinc_encoded_string(end);
                format!("{},{}", start_str, end_str)
            }
            Self::SinceDateTime { date_time } => {
                to_zinc_encoded_string(date_time)
            }
        }
    }
}

/// Convert a `DateTime` into a string which can be used in ZINC files.
fn to_zinc_encoded_string(date_time: &DateTime) -> String {
    let time_zone_name = date_time.short_time_zone();
    format!(
        "{} {}",
        date_time
            .date_time()
            .to_rfc3339_opts(SecondsFormat::Secs, true),
        time_zone_name,
    )
}