tricorder 0.10.0

Automation, the KISS way, no YAML involved.
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

use crate::prelude::{Error, Result};

use regex::Regex;
use serde::de::{Deserialize, Deserializer};
use serde_derive::Serialize;

const HOST_ID_REGEX: &str = r"^[a-zA-Z0-9_][a-zA-Z0-9_\-]*$";

#[derive(Debug, Clone, Serialize, PartialEq)]
pub struct HostId(String);

impl HostId {
    /// Create a new host identifier from a string.
    ///
    /// Example:
    ///
    /// ```rust
    /// use tricorder::prelude::HostId;
    ///
    /// let id = HostId::new("example").unwrap();
    /// # assert_eq!(id.to_string(), String::from("example"));
    /// ```
    pub fn new(src: &str) -> Result<Self> {
        let re = Regex::new(HOST_ID_REGEX)?;
        if !re.is_match(src) {
            Err(Box::new(Error::InvalidHostId(format!(
                "ID {} does not match regex {}",
                src, HOST_ID_REGEX
            ))))
        } else {
            Ok(Self(src.to_string()))
        }
    }

    /// Return the underlying string
    pub fn to_string(self) -> String {
        let Self(s) = self;
        s.clone()
    }
}

impl<'de> Deserialize<'de> for HostId {
    fn deserialize<D>(deserializer: D) -> std::result::Result<Self, D::Error>
    where
        D: Deserializer<'de>,
    {
        let src = String::deserialize(deserializer)?;
        HostId::new(src.as_str()).map_err(serde::de::Error::custom)
    }
}