FerroBabe 0.1.2

A lightweight Rust library for disassembling Java class files.
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

#[derive(Debug, Clone, Copy, Default, PartialEq, Eq)]
/// Selects how the disassembler handles a decoding failure after the header.
pub enum RecoveryMode {
    #[default]
    /// Return the readable header and a diagnostic instead of discarding all parse information.
    BestEffort,
    /// Return the decoding failure as an error.
    Strict,
}

#[derive(Debug, Clone, PartialEq, Eq)]
/// Immutable configuration used to create a [`Disassembler`](crate::Disassembler).
pub struct DisassemblerOptions {
    recovery: RecoveryMode,
}

impl Default for DisassemblerOptions {
    fn default() -> Self {
        Self {
            recovery: RecoveryMode::BestEffort,
        }
    }
}

impl DisassemblerOptions {
    /// Returns the configured recovery mode.
    #[must_use]
    pub fn recovery(&self) -> RecoveryMode {
        self.recovery
    }
}

#[derive(Debug, Clone, Default)]
/// Configures a [`Disassembler`](crate::Disassembler) before construction.
pub struct DisassemblerBuilder {
    options: DisassemblerOptions,
}

impl DisassemblerBuilder {
    /// Sets the recovery mode used by the resulting disassembler.
    ///
    /// The supplied mode replaces the builder's previous recovery mode.
    #[must_use]
    pub fn recovery(mut self, recovery: RecoveryMode) -> Self {
        self.options.recovery = recovery;
        self
    }

    /// Builds a [`Disassembler`](crate::Disassembler) from these options.
    #[must_use]
    pub fn build(self) -> Disassembler {
        Disassembler::new(self.options)
    }
}

use crate::Disassembler;