cfsp 1.0.1

A JVM Bytecode Manipulation Framework inspired by ASM.
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

use std::io::Read;

pub use error::{ParseError, ParseResult};
pub use signature::{class_signature, field_signature, method_signature};

use crate::node::class::Class;

mod attribute;
mod class;
mod constant;
mod error;
mod field;
mod method;
mod signature;

/// Parses class file based on given options.
pub fn to_class<R: Read>(class_bytes: &mut R, option: ParsingOption) -> ParseResult<Class> {
    let class = class::class(class_bytes, option)?;

    let mut remain = vec![];

    class_bytes.read_to_end(&mut remain)?;

    if !remain.is_empty() {
        Err(ParseError::Remains(remain.len()))
    } else {
        Ok(class)
    }
}

/// Parsing options allows marking some parsing phase optional.
#[derive(Debug, Default)]
pub struct ParsingOption {
    skip_attribute: bool,
    skip_instruction: bool,
}

impl ParsingOption {
    /// Skips on attribute parsing.
    pub fn skip_attribute(mut self) -> Self {
        self.skip_attribute = true;

        self
    }

    /// Skips on instruction parsing on code attribute.
    pub fn skip_instruction(mut self) -> Self {
        self.skip_instruction = true;

        self
    }
}