peview 0.1.1

A minimal and fast zero-copy parser for the PE32+ file format.
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

use alloc::{format, string::String};
use core::{
    any, error,
    fmt::{self, Display, Formatter},
    result,
};

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

#[derive(Debug)]
pub enum Error {
    Misaligned,
    InsufficientBuffer,
    Malformed(String),
    InvalidFileFormat,
    DataDirectoryEmpty,
    SectionEmpty,
}

impl Error {
    pub fn make_malformed<T, R>(m: String) -> Result<R> {
        let type_name = any::type_name::<T>();
        Err(Self::Malformed(format!("{type_name} {m}")))
    }
}

impl Display for Error {
    fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
        let msg = match self {
            Self::Misaligned => "provided buffer is misaligned",
            Self::InsufficientBuffer => "provided buffer is too small",
            Self::Malformed(m) => m,
            Self::InvalidFileFormat => "only x64 (PE32+) files are supported",
            Self::DataDirectoryEmpty => "required data directory is empty",
            Self::SectionEmpty => "required section has no raw data",
        };

        write!(f, "Error ({self:?}) {msg}")
    }
}

impl error::Error for Error {}