stream-unpack 1.3.0

A small library for stream unpacking archives
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

use thiserror::Error;

/// Provides a [Decryptor] for the ZipCrypto (PKWARE encryption) algorithm, used in old ZIP files.
#[cfg(feature = "zipcrypto")]
pub mod zipcrypto;

/// Provides a [Decryptor] for the AE-x algorithm, used in ZIP files.
#[cfg(feature = "ae-x")]
pub mod aex;

#[derive(Error, Debug)]
pub enum DecryptionError {
    #[error("generic decryption error: {0}")]
    Generic(String)
}

#[derive(Error, Debug)]
pub enum DecryptorCreationError {
    #[error("generic decryptor creation error: {0}")]
    Generic(String),

    #[error("missing feature flag for encryption method: {0}")]
    NoFeature(String),

    #[error("incorrect password")]
    IncorrectPassword,

    #[error("data is not encrypted")]
    NotEncrypted
}

pub trait Decryptor: std::fmt::Debug + Send + Sync {
    /// Tries to decrypt data
    ///
    /// The return values are the amount of input bytes consumed,
    /// and the result of this decryption operation
    fn update(&mut self, data: &[u8]) -> Result<(usize, &[u8]), DecryptionError>;
}