ferrodock 1.14.0

A fast, native container manager for Docker, written in Rust.
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

//! Images: listing.

use bollard::models::ImageSummary;
use bollard::query_parameters::ListImagesOptions;

use super::{DockerClient, describe, short_id};

#[derive(Debug, Clone, PartialEq, Eq, Hash)]
pub struct ImageInfo {
    pub id: String,
    /// `repo:tag` names, without the `<none>:<none>` placeholder.
    pub tags: Vec<String>,
    pub size: i64,
    /// Unix timestamp (seconds).
    pub created: i64,
}

impl ImageInfo {
    pub fn short_id(&self) -> &str {
        short_id(&self.id)
    }

    /// The main name to show; untagged (dangling) images show as `<none>`.
    pub fn name(&self) -> &str {
        self.tags.first().map_or("<none>", String::as_str)
    }
}

impl From<ImageSummary> for ImageInfo {
    fn from(i: ImageSummary) -> Self {
        Self {
            id: i.id,
            tags: i
                .repo_tags
                .into_iter()
                .filter(|t| t != "<none>:<none>")
                .collect(),
            size: i.size,
            created: i.created,
        }
    }
}

impl DockerClient {
    /// Lists top-level images, sorted by name (untagged ones last).
    pub async fn list_images(&self) -> Result<Vec<ImageInfo>, String> {
        let mut list: Vec<ImageInfo> = self
            .docker
            .list_images(None::<ListImagesOptions>)
            .await
            .map_err(describe)?
            .into_iter()
            .map(ImageInfo::from)
            .collect();
        list.sort_by_cached_key(|i| (i.tags.is_empty(), i.name().to_lowercase()));
        Ok(list)
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn drops_placeholder_tags() {
        let info = ImageInfo::from(ImageSummary {
            id: "sha256:0123456789abcdef".into(),
            repo_tags: vec!["<none>:<none>".into()],
            ..Default::default()
        });
        assert!(info.tags.is_empty());
        assert_eq!(info.name(), "<none>");
        assert_eq!(info.short_id(), "0123456789ab");
    }
}