parallel_bzip2_decoder 0.2.1

High-performance parallel bzip2 decompression library
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

//! Error types for parallel bzip2 decompression.

use std::fmt;

/// Error type for parallel bzip2 decompression operations.
#[derive(Debug)]
pub enum Bz2Error {
    /// Failed to decompress a block at the specified bit offset.
    DecompressionFailed {
        /// Bit offset where the block starts
        offset: u64,
        /// The underlying I/O error
        source: std::io::Error,
    },

    /// Invalid bzip2 format detected.
    InvalidFormat(String),

    /// I/O error occurred.
    Io(std::io::Error),

    /// Memory mapping failed.
    MmapFailed(std::io::Error),

    /// Decompression limit exceeded (possible decompression bomb).
    DecompressionLimitExceeded {
        /// Bit offset where the block starts
        offset: u64,
        /// The limit that was exceeded
        limit: usize,
    },
}

impl fmt::Display for Bz2Error {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Bz2Error::DecompressionFailed { offset, source } => {
                write!(
                    f,
                    "Failed to decompress block at bit offset {}: {}",
                    offset, source
                )
            }
            Bz2Error::InvalidFormat(msg) => write!(f, "Invalid bzip2 format: {}", msg),
            Bz2Error::Io(err) => write!(f, "I/O error: {}", err),
            Bz2Error::MmapFailed(err) => write!(f, "Memory mapping failed: {}", err),
            Bz2Error::DecompressionLimitExceeded { offset, limit } => {
                write!(
                    f,
                    "Decompression limit exceeded ({} bytes) at bit offset {}. Possible decompression bomb.",
                    limit, offset
                )
            }
        }
    }
}

impl std::error::Error for Bz2Error {
    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
        match self {
            Bz2Error::DecompressionFailed { source, .. } => Some(source),
            Bz2Error::Io(err) => Some(err),
            Bz2Error::MmapFailed(err) => Some(err),
            Bz2Error::InvalidFormat(_) => None,
            Bz2Error::DecompressionLimitExceeded { .. } => None,
        }
    }
}

impl From<std::io::Error> for Bz2Error {
    fn from(err: std::io::Error) -> Self {
        Bz2Error::Io(err)
    }
}

/// Result type for parallel bzip2 decompression operations.
pub type Result<T> = std::result::Result<T, Bz2Error>;