ping-fox 0.1.0

A ping (ICMP) library - simple to use and no root or setuid required.
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

use std::{error::Error, fmt};

#[derive(Debug)]
pub struct PingError {
    pub message: String,
    // no chained error
}

impl fmt::Display for PingError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> Result<(), fmt::Error> {
        write!(f, "PingError")?;
        if !self.message.is_empty() {
            write!(f, ": {}", self.message)?;
        }
        Ok(())
    }
}

impl Error for PingError {
    fn source(&self) -> Option<&(dyn Error + 'static)> {
        None
    }
}

impl From<std::io::Error> for PingError {
    fn from(error: std::io::Error) -> PingError {
        PingError { message: error.to_string() }
    }
}

#[cfg(test)]
mod tests {
    use std::io::ErrorKind;

    use super::*;

    #[test]
    fn fmt_without_message() {
        let ping_error = PingError { message: String::new() };
        let fmt_str = format!("{ping_error}");
        assert_eq!("PingError", fmt_str);
    }

    #[test]
    fn fmt_with_message() {
        let ping_error = PingError { message: "testing std::fmt::Display".to_string() };
        let fmt_str = format!("{ping_error}");
        assert_eq!("PingError: testing std::fmt::Display", fmt_str);
    }

    #[test]
    fn source() {
        assert!(PingError { message: String::new() }.source().is_none());
    }

    #[test]
    fn ping_error_from_std_io_error() {
        let std_io_error = std::io::Error::from(ErrorKind::Other);
        let ping_error: PingError = PingError::from(std_io_error);
        assert!(ping_error.source().is_none());
    }
}