libits-client 3.1.0

library to connect on an ITS MQTT server
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

/*
 * Software Name : libits-client
 * SPDX-FileCopyrightText: Copyright (c) Orange SA
 * SPDX-License-Identifier: MIT
 *
 * This software is distributed under the MIT license,
 * see the "LICENSE.txt" file for more details or https://opensource.org/license/MIT/
 *
 * Authors: see CONTRIBUTORS.md
 */

use serde::{Deserialize, Serialize};

/// Represents a Curvature according to an ETSI standard.
///
/// This message is used to describe curvature.
/// It implements the schema defined in the [CAM version 2.2.0][1].
///
/// [1]: https://github.com/Orange-OpenSource/its-client/blob/master/schema/cam/cam_schema_2-2-0.json#L955
#[serde_with::skip_serializing_none]
#[derive(Default, Debug, Clone, Hash, PartialEq, Eq, Serialize, Deserialize)]
pub struct Curvature {
    /// Curvature value.
    pub value: i16,
    /// Confidence level for the curvature.
    pub confidence: CurvatureConfidence,
}

#[derive(Debug, Default, Clone, Copy, Hash, PartialEq, Eq, Serialize, Deserialize)]
#[serde(from = "u8", into = "u8")]
pub enum CurvatureConfidence {
    /// Curvature confidence levels.
    OnePerMeter0_00002 = 0,
    OnePerMeter0_0001 = 1,
    OnePerMeter0_0005 = 2,
    OnePerMeter0_002 = 3,
    OnePerMeter0_01 = 4,
    OnePerMeter0_1 = 5,
    OutOfRange = 6,
    #[default]
    Unavailable = 7,
}

impl From<CurvatureConfidence> for u8 {
    fn from(value: CurvatureConfidence) -> Self {
        value as u8
    }
}

impl From<u8> for CurvatureConfidence {
    fn from(value: u8) -> Self {
        match value {
            0 => CurvatureConfidence::OnePerMeter0_00002,
            1 => CurvatureConfidence::OnePerMeter0_0001,
            2 => CurvatureConfidence::OnePerMeter0_0005,
            3 => CurvatureConfidence::OnePerMeter0_002,
            4 => CurvatureConfidence::OnePerMeter0_01,
            5 => CurvatureConfidence::OnePerMeter0_1,
            6 => CurvatureConfidence::OutOfRange,
            _ => CurvatureConfidence::Unavailable,
        }
    }
}

#[cfg(test)]
mod tests {
    use crate::exchange::etsi::curvature::{Curvature, CurvatureConfidence};

    #[test]
    fn test_deserialize_curvature() {
        let data = r#"{
            "value": 1023,
            "confidence": 7
        }"#;

        match serde_json::from_str::<Curvature>(data) {
            Ok(object) => {
                assert_eq!(object.value, 1023);
                assert_eq!(object.confidence, CurvatureConfidence::Unavailable);
            }
            Err(e) => panic!("Failed to deserialize a Curvature: '{e}'"),
        }
    }
}