phoxal 0.67.0

Phoxal - production-oriented autonomous robot framework: the one framework library, holding the runtime engine, the api contract tree, the typed bus, the canonical model, and the bundle.
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

crate::endpoints! {
    sample: Sample<Sample>;
}

#[derive(
    phoxal_macros::DescribeWire, Clone, Debug, PartialEq, serde::Serialize, serde::Deserialize,
)]
#[serde(try_from = "SampleWire")]
pub struct Sample {
    pub latitude: f64,
    pub longitude: f64,
    pub altitude: f64,
    pub position_covariance: [f64; 9],
}
#[derive(serde::Deserialize)]
struct SampleWire {
    latitude: f64,
    longitude: f64,
    altitude: f64,
    position_covariance: [f64; 9],
}
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct InvalidSample(&'static str);
impl std::fmt::Display for InvalidSample {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.write_str(self.0)
    }
}
impl std::error::Error for InvalidSample {}
impl Sample {
    pub fn try_new(
        latitude: f64,
        longitude: f64,
        altitude: f64,
        position_covariance: [f64; 9],
    ) -> Result<Self, InvalidSample> {
        if !(latitude.is_finite()
            && (-90.0..=90.0).contains(&latitude)
            && longitude.is_finite()
            && (-180.0..=180.0).contains(&longitude)
            && altitude.is_finite()
            && position_covariance.iter().all(|v| v.is_finite())
            && position_covariance[0] >= 0.0
            && position_covariance[4] >= 0.0
            && position_covariance[8] >= 0.0
            && (position_covariance[1] - position_covariance[3]).abs() <= 1e-12
            && (position_covariance[2] - position_covariance[6]).abs() <= 1e-12
            && (position_covariance[5] - position_covariance[7]).abs() <= 1e-12)
        {
            return Err(InvalidSample(
                "GNSS position must be finite and bounded; covariance must be finite, symmetric, and have nonnegative variance",
            ));
        }
        Ok(Self {
            latitude,
            longitude,
            altitude,
            position_covariance,
        })
    }
}
impl TryFrom<SampleWire> for Sample {
    type Error = InvalidSample;
    fn try_from(v: SampleWire) -> Result<Self, Self::Error> {
        Self::try_new(v.latitude, v.longitude, v.altitude, v.position_covariance)
    }
}
#[cfg(test)]
mod tests {
    use super::*;
    #[test]
    fn constructor_bounds_coordinates_and_covariance() {
        assert!(Sample::try_new(90.1, 0.0, 0.0, [0.0; 9]).is_err());
        assert!(
            Sample::try_new(0.0, 0.0, 0.0, [0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0]).is_err()
        );
    }
}