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

//! Defines root error type

#[non_exhaustive]
#[derive(thiserror::Error, Debug)]
pub enum Error {
    #[error("base64 decode error")]
    Base64Decode(#[from] base64::DecodeError),
    #[error("header parse error")]
    HeaderParse(#[from] http::header::ToStrError),
    #[error("json error")]
    Json(#[from] serde_json::Error),
    #[error("http transport error: {0}")]
    Reqwest(#[from] reqwest::Error),
    #[error("URI parse error")]
    Uri(#[from] url::ParseError),
    #[error("IO error")]
    IO(#[from] std::io::Error),
    #[error("SenderError")]
    Sender(#[from] std::sync::mpsc::SendError<u64>),
    #[error("input is not UTF-8")]
    Utf8Parse(#[from] std::string::FromUtf8Error),
    #[error("strum error")]
    StrumParse(#[from] strum::ParseError),
    #[error("authentication information missing for index {0}")]
    AuthInfoMissing(String),
    #[error("unknown media type {0:?}")]
    UnknownMimeType(mime::Mime),
    #[error("unknown media type {0:?}")]
    UnsupportedMediaType(crate::mediatypes::MediaTypes),
    #[error("mime parse error")]
    MimeParse(#[from] mime::FromStrError),
    #[error("missing authentication header {0}")]
    MissingAuthHeader(&'static str),
    #[error("unexpected HTTP status {0}")]
    UnexpectedHttpStatus(reqwest::StatusCode),
    #[error("invalid auth token '{0}'")]
    InvalidAuthToken(String),
    #[error("API V2 not supported")]
    V2NotSupported,
    #[error("obtained token is invalid")]
    LoginReturnedBadToken,
    #[error("www-authenticate header parse error")]
    Www(#[from] crate::WwwHeaderParseError),
    #[error(
        "request failed with status {status} and body of size {len}: {}",
        String::from_utf8_lossy(body)
    )]
    Client {
        status: http::StatusCode,
        len: usize,
        body: Vec<u8>,
    },
    #[error("content digest error")]
    ContentDigestParse(#[from] crate::ContentDigestError),
    #[error("no header Content-Type given and no workaround to apply")]
    MediaTypeSniff,
    #[error("manifest error")]
    Manifest(#[from] crate::manifest::ManifestError),
    // #[error("reference is invalid")]
    // ReferenceParse(#[from] crate::reference::ReferenceParseError),
    #[error("requested operation requires that credentials are available")]
    NoCredentials,
    #[error("Download Failed")]
    DownloadFailed,
    #[error("Missing header {0}")]
    MissingHeader(String),
}

pub type Result<T> = std::result::Result<T, Error>;

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

    #[test]
    fn test_error_bounds() {
        fn check_bounds<T: Send + Sync + 'static>() {}
        check_bounds::<Error>();
    }
}