apk-info-zip 1.1.0

A library for correctly unpacking APK files that use the BadPack technique
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

//! Errors returned by this crate.
//!
//! This module contains the definitions for all error types returned by this crate.

use thiserror::Error;

/// Represents all possible errors that can occur while parsing a ZIP archive.
#[derive(Error, Debug, PartialEq)]
pub enum ZipError {
    /// The provided file does not have a valid ZIP header.
    #[error("provided file is not a zip archive")]
    InvalidHeader,

    /// An error occurred while decompressing a file entry.
    #[error("got error while decompressing object")]
    DecompressionError,

    /// The file entry is too large to decompress.
    #[error("file entry is too large to decompress")]
    FileTooLarge,

    /// Unexpected end-of-file (EOF) was reached while reading the ZIP archive.
    #[error("got EOF while parsing zip")]
    EOF,

    /// The requested file does not exist inside the ZIP archive.
    #[error("file not exist in zip")]
    FileNotFound,

    /// The End of Central Directory (EOCD) record could not be found, preventing operations.
    #[error("can't find EOCD in zip")]
    NotFoundEOCD,

    /// A general error occurred while parsing the ZIP archive.
    #[error("got error while parsing zip archive")]
    ParseError,

    /// An I/O error occurred while reading from the underlying stream of a
    /// lazily-read archive.
    #[error("io error while reading zip: {0:?}")]
    IoError(std::io::ErrorKind),
}

/// Lets `?` convert I/O results straight into a [ZipError], keeping only the
/// [ErrorKind](std::io::ErrorKind) (the enum is `PartialEq`, unlike `io::Error`).
impl From<std::io::Error> for ZipError {
    fn from(e: std::io::Error) -> Self {
        ZipError::IoError(e.kind())
    }
}

/// Represents all errors that can occur while handling certificates.
#[derive(Error, Debug)]
pub enum CertificateError {
    /// Failed to parse the certificate.
    #[error("got error while parsing certificate")]
    ParseError,

    /// An error occurred while parsing a ZIP archive within the certificate context.
    #[error("got zip error while parsing certificate: {0}")]
    ZipError(#[from] ZipError),

    /// A signing error occurred (e.g., invalid signer or signature verification failed).
    #[error("got signer error")]
    SignerError,

    /// The certificate format is invalid because the block sizes do not match the expected values.
    #[error("size of blocks not equals (required by format) - (start - {0}, end - {1})")]
    InvalidFormat(u64, u64),
}