brk_interface 0.0.111

An interface to find and format data from BRK
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

use std::ops::Deref;

use schemars::JsonSchema;
use serde::Deserialize;

use crate::{
    Format, Index,
    deser::{de_unquote_i64, de_unquote_usize},
    metrics::MaybeMetrics,
};

#[derive(Debug, Deserialize, JsonSchema)]
pub struct Params {
    #[serde(alias = "m")]
    #[schemars(description = "Requested metrics")]
    pub metrics: MaybeMetrics,

    #[serde(alias = "i")]
    #[schemars(description = "Requested index")]
    pub index: Index,

    #[serde(flatten)]
    pub rest: ParamsOpt,
}

impl Deref for Params {
    type Target = ParamsOpt;
    fn deref(&self) -> &Self::Target {
        &self.rest
    }
}

impl From<((Index, String), ParamsOpt)> for Params {
    fn from(((index, metric), rest): ((Index, String), ParamsOpt)) -> Self {
        Self {
            index,
            metrics: MaybeMetrics::from(metric),
            rest,
        }
    }
}

#[derive(Default, Debug, Deserialize, JsonSchema)]
pub struct ParamsOpt {
    #[serde(default, alias = "f", deserialize_with = "de_unquote_i64")]
    /// Inclusive starting index, if negative will be from the end
    #[schemars(description = "Inclusive starting index, if negative will be from the end")]
    from: Option<i64>,

    #[serde(default, alias = "t", deserialize_with = "de_unquote_i64")]
    /// Exclusive ending index, if negative will be from the end, overrides 'count'
    #[schemars(
        description = "Exclusive ending index, if negative will be from the end, overrides 'count'"
    )]
    to: Option<i64>,

    #[serde(default, alias = "c", deserialize_with = "de_unquote_usize")]
    /// Number of values requested
    #[schemars(description = "Number of values requested")]
    count: Option<usize>,

    #[serde(default)]
    /// Format of the output
    #[schemars(description = "Format of the output")]
    format: Format,
}

impl ParamsOpt {
    pub fn set_from(mut self, from: i64) -> Self {
        self.from.replace(from);
        self
    }

    pub fn set_to(mut self, to: i64) -> Self {
        self.to.replace(to);
        self
    }

    pub fn set_count(mut self, count: usize) -> Self {
        self.count.replace(count);
        self
    }

    pub fn from(&self) -> Option<i64> {
        self.from
    }

    pub fn to(&self) -> Option<i64> {
        if self.to.is_none()
            && let Some(c) = self.count
        {
            let c = c as i64;
            if let Some(f) = self.from {
                if f >= 0 || f.abs() > c {
                    return Some(f + c);
                }
            } else {
                return Some(c);
            }
        }
        self.to
    }

    pub fn format(&self) -> Format {
        self.format
    }
}

#[derive(Debug, Deserialize)]
pub struct ParamsDeprec {
    #[serde(alias = "i")]
    pub index: Index,
    #[serde(alias = "v")]
    pub ids: MaybeMetrics,
    #[serde(flatten)]
    pub rest: ParamsOpt,
}

impl From<ParamsDeprec> for Params {
    fn from(value: ParamsDeprec) -> Self {
        Params {
            index: value.index,
            metrics: value.ids,
            rest: value.rest,
        }
    }
}