docker_compose 0.3.3

Parse, manipulate and serialize docker-compose.yml in a strongly-typed fashion
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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

// This is not a normal Rust module! It's included directly into v2.rs,
// possibly after build-time preprocessing.  See v2.rs for an explanation
// of how this works.

/// Permissions on devices that are mapped into the Docker container.
#[derive(Debug, Eq, PartialEq, Clone, Copy)]
pub struct DevicePermissions {
    /// Can the container read from this device?
    pub read: bool,
    /// Can the container write to this device?
    pub write: bool,
    /// Can the container call `mknod` for this device?
    pub mknod: bool,
}

impl Default for DevicePermissions {
    fn default() -> DevicePermissions {
        DevicePermissions {
            read: true,
            write: true,
            mknod: true,
        }
    }
}

impl fmt::Display for DevicePermissions {
    fn fmt(&self, f: &mut fmt::Formatter) -> Result<(), fmt::Error> {
        if self.read {
            try!(write!(f, "r"))
        }
        if self.write {
            try!(write!(f, "w"))
        }
        if self.mknod {
            try!(write!(f, "m"))
        }
        Ok(())
    }
}

impl_serialize_to_string!(DevicePermissions);

impl FromStr for DevicePermissions {
    type Err = InvalidValueError;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        lazy_static! {
            static ref PERMS: Regex =
                Regex::new("^(r)?(w)?(m)?").unwrap();
        }
        let caps = try!(PERMS.captures(s).ok_or_else(|| {
            InvalidValueError::new("restart-mode", s)
        }));
        Ok(DevicePermissions {
            read: caps.at(1).is_some(),
            write: caps.at(2).is_some(),
            mknod: caps.at(3).is_some(),
        })
    }
}

impl_deserialize_from_str!(DevicePermissions);

#[test]
fn device_permissions_has_a_string_representation() {
    let pairs = vec!(
        (Default::default(), "rwm"),
        (DevicePermissions { read: false, ..Default::default() }, "wm"),
        (DevicePermissions { write: false, ..Default::default() }, "rm"),
        (DevicePermissions { mknod: false, ..Default::default() }, "rw"),
    );
    for (mode, s) in pairs {
        assert_eq!(mode.to_string(), s);
        assert_eq!(mode, DevicePermissions::from_str(s).unwrap());
    }
}

/// Permissions on volumes that are mapped into the Docker container.
#[derive(Debug, Eq, PartialEq, Clone, Copy)]
pub enum VolumePermissions {
    /// This volume can be read and written (default).
    ReadWrite,
    /// This volume is ready-only.
    ReadOnly,
}

impl Default for VolumePermissions {
    fn default() -> VolumePermissions {
        VolumePermissions::ReadWrite
    }
}

impl fmt::Display for VolumePermissions {
    fn fmt(&self, f: &mut fmt::Formatter) -> Result<(), fmt::Error> {
        match self {
            &VolumePermissions::ReadWrite => write!(f, "rw"),
            &VolumePermissions::ReadOnly => write!(f, "ro"),
        }
    }
}

impl_serialize_to_string!(VolumePermissions);

impl FromStr for VolumePermissions {
    type Err = InvalidValueError;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        match s {
            "rw" => Ok(VolumePermissions::ReadWrite),
            "ro" => Ok(VolumePermissions::ReadOnly),
            _ => Err(InvalidValueError::new("volume permissions", s)),
        }
    }
}

#[test]
fn volume_permissions_has_a_string_representation() {
    let pairs = vec!(
        (VolumePermissions::ReadWrite, "rw"),
        (VolumePermissions::ReadOnly, "ro"),
    );
    for (mode, s) in pairs {
        assert_eq!(mode.to_string(), s);
        assert_eq!(mode, VolumePermissions::from_str(s).unwrap());
    }
}