archmeld 0.1.5

Secure, memory-safe, type-safe CLI for multi-format archive extraction, inspection and decompression
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
81
82
83
84
85

//! Error types for archmeld operations.

use std::path::PathBuf;

/// All errors that can occur during archive operations.
#[derive(Debug, thiserror::Error)]
#[allow(dead_code)]
pub enum Error {
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),

    #[error("ZIP error: {0}")]
    Zip(#[from] zip::result::ZipError),

    #[error("7-Zip error: {0}")]
    SevenZip(String),

    #[error("LZMA error: {0}")]
    Lzma(#[from] lzma_rs::error::Error),

    #[error("LZ4 decompression error: {0}")]
    Lz4(String),

    #[error("Unsupported archive format: {0}")]
    UnsupportedFormat(String),

    #[error("Invalid archive: {0}")]
    InvalidArchive(String),

    #[error("File too large: {size} bytes exceeds limit of {limit} bytes")]
    FileTooLarge { size: u64, limit: u64 },

    #[error("Total extraction size exceeds limit of {limit} bytes")]
    TotalSizeLimitExceeded { limit: u64 },

    #[error("Path traversal detected in archive entry: {0}")]
    PathTraversal(String),

    #[error("File not found: {}", .0.display())]
    FileNotFound(PathBuf),

    #[error("Invalid gzip header: {0}")]
    InvalidGzipHeader(String),

    #[error("Invalid StuffIt archive: {0}")]
    InvalidStuffIt(String),

    #[error("Invalid Compact Pro archive: {0}")]
    InvalidCompactPro(String),

    #[error("Checksum mismatch: expected {expected}, got {actual}")]
    ChecksumMismatch { expected: String, actual: String },

    #[error("Encrypted archive entries are not supported")]
    EncryptedNotSupported,

    #[error("Archive bomb detected: compression ratio {ratio:.0}:1 exceeds limit of {limit:.0}:1")]
    CompressionBomb { ratio: f64, limit: f64 },

    #[error("Too many entries: {count} exceeds limit of {limit}")]
    TooManyEntries { count: usize, limit: usize },

    #[error("RAR error: {0}")]
    Rar(String),

    #[error("CAB error: {0}")]
    Cab(String),

    #[error("AR error: {0}")]
    Ar(String),

    #[error("Brotli decompression error: {0}")]
    Brotli(String),

    #[error("Snappy decompression error: {0}")]
    Snappy(String),

    #[error("ZPAQ error: {0}")]
    Zpaq(String),

    #[error("Symlink rejected in archive: {0}")]
    SymlinkRejected(String),
}

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