cocoon 0.4.3

A simple protected container with strong encryption and format validation.
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

/// Error variants produced by the Cocoon API.
#[derive(Debug)]
#[cfg_attr(feature = "thiserror", derive(thiserror::Error))]
pub enum Error {
    /// I/o error during read/write operation (`Cocoon::dump`, `Cocoon::parse`).
    #[cfg(feature = "std")]
    #[cfg_attr(feature = "thiserror", error("Input/output error"))]
    Io(std::io::Error),

    /// Format is not recognized. Probably corrupted.
    #[cfg_attr(feature = "thiserror", error("Unrecognized format"))]
    UnrecognizedFormat,

    /// Cryptographic error. There could be a few reasons:
    /// 1. Integrity is compromised.
    /// 2. Password is invalid.
    #[cfg_attr(
        feature = "thiserror",
        error("Cryptographic error: bad integrity/password")
    )]
    Cryptography,

    /// Container is too large to get processed on the current architecture.
    /// E.g. it's not possible to process a container larger than 4 GB on 32-bit architecture.
    #[cfg_attr(
        feature = "thiserror",
        error("Container size exceeds architectural limit")
    )]
    TooLarge,

    /// Buffer is too short and barely holds all data to decrypt, inconsistent length
    /// encoded to the header.
    #[cfg_attr(
        feature = "thiserror",
        error("Insufficient buffer size for decrypted data")
    )]
    TooShort,
}

#[cfg(feature = "std")]
impl From<std::io::Error> for Error {
    fn from(err: std::io::Error) -> Self {
        match err.kind() {
            std::io::ErrorKind::UnexpectedEof => Error::TooShort,
            _ => Error::Io(err),
        }
    }
}