delharc 0.7.0

A library for parsing and extracting files from LHA/LZH 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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

use core::fmt;
#[cfg(feature = "std")]
use std::io;
use crate::stub_io::Read;

pub type LhaResult<T, R> = Result<T, LhaError<<R as Read>::Error>>;

/// `delharc` error type.
///
/// With `std` feature enabled `E` is [`std::io::Error`] and
/// `LhaError` can be converted to [`std::io::Error`] using [`From`] or [`Into`].
#[derive(Debug, PartialEq, Eq)]
#[non_exhaustive]
pub enum LhaError<E> {
    /// I/O error.
    Io(E),
    /// When parsing LHA header.
    HeaderParse(&'static str),
    /// When decompressing a file.
    Decompress(&'static str),
    /// Checksum mismatch.
    Checksum(&'static str),
}

impl<E: fmt::Display> fmt::Display for LhaError<E> {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        use LhaError::*;
        match self {
            Io(e) => e.fmt(f),
            HeaderParse(e) => write!(f, "while parsing LHA header: {}", e),
            Decompress(e) => write!(f, "while decompressing: {}", e),
            Checksum(e) => write!(f, "checksum: {}", e),
        }
    }
}

#[cfg(feature = "std")]
impl<E: std::error::Error + 'static> std::error::Error for LhaError<E> {
    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
        use LhaError::*;
        match self {
            Io(e) => Some(e),
            _ => None
        }
    }
}

#[cfg(feature = "std")]
impl From<LhaError<io::Error>> for io::Error {
    fn from(err: LhaError<io::Error>) -> Self {
        use LhaError::*;
        use io::{Error, ErrorKind};
        match err {
            Io(e) => e,
            HeaderParse(e) => Error::new(ErrorKind::InvalidData, e),
            Decompress(e) => Error::new(ErrorKind::InvalidData, e),
            Checksum(e) => Error::new(ErrorKind::InvalidData, e),
        }
    }
}