dexparser 0.6.2

Parser for Android's DEX 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
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

use failure::Fail;

#[derive(Debug, Fail, Clone)]
pub enum DexParserError {
    #[fail(display = "file unexpectedly ended early: expected {} bytes", needed)]
    EndedEarly {
        needed: usize
    },
    #[fail(display = "could not parse file: {}", reason)]
    ParsingFailed {
        reason: String
    },
    #[fail(display = "could not decode string to UTF8: may be malformed")]
    EncodingError
}

impl<E: std::fmt::Debug + Clone> From<nom::Err<E>> for DexParserError {
    fn from(e: nom::Err<E>) -> Self {
        match e {
            nom::Err::Incomplete(ref needed) => {
                match needed {
                    nom::Needed::Unknown => DexParserError::ParsingFailed { reason: "file ended early".to_string() },
                    nom::Needed::Size(size) => DexParserError::EndedEarly { needed: *size }
                }
            },
            nom::Err::Error(ctx) => {
                match ctx {
                    nom::Context::Code(pos, kind) => {
                        DexParserError::ParsingFailed { reason: format!("parsing failed at byte {:?}: parser {:?}", pos, kind) }
                    },
                    nom::Context::List(errors) => {
                        let reason = errors.iter()
                            .map(|(pos, kind)| format!("parsing failed at byte {:?}: parser {:?}", pos, kind))
                            .collect::<Vec<String>>()
                            .join(": ");

                        DexParserError::ParsingFailed { reason }
                    }
                }
            },
            nom::Err::Failure(ctx) => {
                match ctx {
                    nom::Context::Code(pos, kind) => {
                        DexParserError::ParsingFailed { reason: format!("parsing failed at byte {:?}: parser {:?}", pos, kind) }
                    },
                    nom::Context::List(errors) => {
                        let reason = errors.iter()
                            .map(|(pos, kind)| format!("parsing failed at byte {:?}: parser {:?}", pos, kind))
                            .collect::<Vec<String>>()
                            .join(": ");

                        DexParserError::ParsingFailed { reason }
                    }
                }
            }
        }
    }
}

impl From<&'static str> for DexParserError {
    fn from(e: &'static str) -> Self {
        DexParserError::ParsingFailed { reason: e.to_string() }
    }
}

impl From<String> for DexParserError {
    fn from(e: String) -> Self {
        DexParserError::ParsingFailed { reason: e }
    }
}

impl From<::std::string::FromUtf8Error> for DexParserError {
    fn from(_e: ::std::string::FromUtf8Error) -> Self {
        DexParserError::ParsingFailed { reason: "could not parse string as UTF8".to_string() }
    }
}

impl From<DexParserError> for nom::Err<&[u8]> {
    fn from(e: DexParserError) -> Self {
        // TODO - work out how to build a proper error here, or avoid converting back and forth
        nom::Err::Failure(nom::Context::Code(b"Failed to parse DEX file", nom::ErrorKind::Custom(0)))
    }
}