ghregistry 0.2.0

A pure-Rust synchronous library for Github Docker Registry API
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

//! Media-types for API objects.

use crate::errors::Result;
use mime;
use strum::EnumProperty;

// For schema1 types, see https://docs.docker.com/registry/spec/manifest-v2-1/
// For schema2 types, see https://docs.docker.com/registry/spec/manifest-v2-2/

#[derive(EnumProperty, EnumString, Display, Debug, Hash, PartialEq)]
pub enum MediaTypes {
    /// Manifest, version 2 schema 1.
    #[strum(serialize = "application/vnd.docker.distribution.manifest.v1+json")]
    #[strum(props(Sub = "vnd.docker.distribution.manifest.v1+json"))]
    ManifestV2S1,
    /// Signed manifest, version 2 schema 1.
    #[strum(
        serialize = "application/vnd.docker.distribution.manifest.v1+prettyjws",
        // TODO: find a generic way to handle this form
        serialize = "application/vnd.docker.distribution.manifest.v1+prettyjws; charset=utf-8",
    )]
    #[strum(props(Sub = "vnd.docker.distribution.manifest.v1+prettyjws"))]
    ManifestV2S1Signed,
    /// Manifest, version 2 schema 2.
    #[strum(serialize = "application/vnd.docker.distribution.manifest.v2+json")]
    #[strum(props(Sub = "vnd.docker.distribution.manifest.v2+json"))]
    ManifestV2S2,
    /// Manifest List (aka "fat manifest").
    #[strum(serialize = "application/vnd.docker.distribution.manifest.list.v2+json")]
    #[strum(props(Sub = "vnd.docker.distribution.manifest.list.v2+json"))]
    ManifestList,
    /// Image layer, as a gzip-compressed tar.
    #[strum(serialize = "application/vnd.docker.image.rootfs.diff.tar.gzip")]
    #[strum(props(Sub = "vnd.docker.image.rootfs.diff.tar.gzip"))]
    ImageLayerTgz,
    /// Configuration object for a container.
    #[strum(serialize = "application/vnd.docker.container.image.v1+json")]
    #[strum(props(Sub = "vnd.docker.container.image.v1+json"))]
    ContainerConfigV1,
    /// Generic JSON
    #[strum(serialize = "application/json")]
    #[strum(props(Sub = "json"))]
    ApplicationJson,
}

impl MediaTypes {
    // TODO: proper error types
    pub fn from_mime(mtype: &mime::Mime) -> Result<Self> {
        match (mtype.type_(), mtype.subtype(), mtype.suffix()) {
            (mime::APPLICATION, mime::JSON, _) => Ok(MediaTypes::ApplicationJson),
            (mime::APPLICATION, subt, Some(suff)) => {
                match (subt.to_string().as_str(), suff.to_string().as_str()) {
                    ("vnd.docker.distribution.manifest.v1", "json") => Ok(MediaTypes::ManifestV2S1),
                    ("vnd.docker.distribution.manifest.v1", "prettyjws") => {
                        Ok(MediaTypes::ManifestV2S1Signed)
                    }
                    ("vnd.docker.distribution.manifest.v2", "json") => Ok(MediaTypes::ManifestV2S2),
                    ("vnd.docker.distribution.manifest.list.v2", "json") => {
                        Ok(MediaTypes::ManifestList)
                    }
                    ("vnd.docker.image.rootfs.diff.tar.gzip", _) => Ok(MediaTypes::ImageLayerTgz),
                    ("vnd.docker.container.image.v1", "json") => Ok(MediaTypes::ContainerConfigV1),
                    _ => Err(crate::Error::UnknownMimeType(mtype.clone())),
                }
            }
            _ => Err(crate::Error::UnknownMimeType(mtype.clone())),
        }
    }

    pub fn to_mime(&self) -> mime::Mime {
        match self {
            &MediaTypes::ApplicationJson => Ok(mime::APPLICATION_JSON),
            m => {
                if let Some(s) = m.get_str("Sub") {
                    ("application/".to_string() + s).parse()
                } else {
                    "application/star".parse()
                }
            }
        }
        .expect("to_mime should be always successful")
    }
}