lockzippy 0.0.1

Pure-Rust AES-256 decryptor for 7z archives, part of the 8z umbrella
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

use std::fmt;
use thiserror::Error;

/// All errors produced by lockzippy.
#[derive(Error, Debug)]
pub enum LockzippyError {
    /// The ciphertext length is not a multiple of the AES block size (16 bytes).
    #[error("ciphertext length {0} is not a multiple of AES block size 16")]
    InvalidCiphertextLength(usize),

    /// The properties blob had an unexpected length (expected 32+2 = 34 bytes or similar).
    #[error("invalid AES properties length {0} (expected at least 2 bytes)")]
    InvalidProperties(usize),

    /// The NumCyclesPower value was out of range.
    #[error("invalid NumCyclesPower {0} (valid range 0..=24)")]
    InvalidNumCyclesPower(u8),

    /// AES-CBC unpadding failed (wrong password or corrupt data).
    #[error("AES-CBC decrypt/unpad error: {0}")]
    DecryptError(String),

    /// Wrapped IO error.
    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),
}

impl LockzippyError {
    /// Construct a decrypt error from any `Display` value.
    pub fn decrypt<T: fmt::Display>(msg: T) -> Self {
        LockzippyError::DecryptError(msg.to_string())
    }
}

/// Convenience alias used throughout lockzippy.
pub type LockzippyResult<T> = Result<T, LockzippyError>;