dockworker 0.16.0

Docker daemon API client. (a fork of Faraday's boondock)
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

#[cfg(unix)]
mod unix {
    use std::convert::TryFrom;
    use std::io;
    use std::os::raw::c_int;

    pub use self::NixSignal::*;
    use nix::sys::signal::{Signal as NixSignal, SignalIterator as NixSignalIterator};

    use crate::errors::Error;

    #[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
    pub struct Signal(NixSignal);

    #[derive(Debug, Clone)]
    pub struct SignalIterator(NixSignalIterator);

    impl Signal {
        pub fn as_i32(&self) -> i32 {
            self.0 as i32
        }

        pub fn iterator() -> SignalIterator {
            SignalIterator(NixSignal::iterator())
        }

        pub fn from_c_int(signum: c_int) -> Result<Self, Error> {
            Ok(NixSignal::try_from(signum)
                .map_err(|err| io::Error::from_raw_os_error(err as i32))?
                .into())
        }
    }

    impl From<NixSignal> for Signal {
        fn from(sig: NixSignal) -> Self {
            Self(sig)
        }
    }

    impl Iterator for SignalIterator {
        type Item = Signal;
        fn next(&mut self) -> Option<Self::Item> {
            self.0.next().map(Into::into)
        }
    }
}

#[cfg(windows)]
mod windows {
    use std::io;
    use std::os::raw::c_int;

    use crate::errors::Error;

    #[repr(i32)]
    #[derive(Debug, PartialEq, Eq, PartialOrd, Ord, Clone, Copy, Hash)]
    pub enum Signal {
        SIGKILL = 9,
        SIGTERM = 15,
    }

    #[derive(Debug, Clone)]
    pub struct SignalIterator(std::vec::IntoIter<Signal>);

    impl Signal {
        pub fn as_i32(&self) -> i32 {
            self.clone() as i32
        }

        pub fn iterator() -> SignalIterator {
            use self::Signal::*;
            SignalIterator(vec![SIGKILL, SIGTERM].into_iter())
        }

        pub fn from_c_int(signum: c_int) -> Result<Self, Error> {
            match signum {
                9 => Ok(Signal::SIGKILL),
                15 => Ok(Signal::SIGTERM),
                other => Err(io::Error::new(
                    io::ErrorKind::InvalidInput,
                    format!("unknown signal: {}", other),
                )
                .into()),
            }
        }
    }

    impl Iterator for SignalIterator {
        type Item = Signal;
        fn next(&mut self) -> Option<Self::Item> {
            self.0.next()
        }
    }

    #[cfg(test)]
    mod test {
        use super::*;
        #[test]
        fn iterator() {
            let mut it = Signal::iterator();
            assert_eq!(it.next(), Some(Signal::SIGKILL));
            assert_eq!(it.next(), Some(Signal::SIGTERM));
            assert_eq!(it.next(), None);
        }
    }
}

#[cfg(unix)]
pub use self::unix::*;
#[cfg(windows)]
pub use self::windows::*;