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

pub mod error;
pub mod opcode;
pub mod prelude;

use num_traits::FromPrimitive;
use opcode::py27::{Mnemonic, Standard};
use std::io::Read;

use crate::error::DecodeError;
use crate::opcode::{Instruction, Opcode};

/// Decodes a single instruction from a source and returns its result or an error
pub fn decode<O: Opcode + FromPrimitive, R: Read>(
    source: &mut R,
) -> Result<Instruction<O>, DecodeError> {
    let mut opcode_buffer = [0u8];
    source.read_exact(&mut opcode_buffer)?;

    let opcode = O::from_u8(opcode_buffer[0])
        .map_or(Err(DecodeError::UnknownOpcode(opcode_buffer[0])), Ok)?;

    let arg = if opcode.has_arg() {
        let mut argument_buffer = [0u8, 0u8];
        source.read_exact(&mut argument_buffer)?;

        Some(u16::from_le_bytes(argument_buffer))
    } else {
        None
    };

    Ok(Instruction { opcode, arg })
}

/// Convenience wrapper around [`decode`] for decoding Python 2.7 instructions
pub fn decode_py27<O: Opcode<Mnemonic = crate::opcode::py27::Mnemonic>, R: Read>(source: &mut R) -> Result<Instruction<O>, DecodeError> {
    decode::<O, _>(source)
}