hermes_rs 0.1.4

A dependency-free disassembler and assembler for the Hermes bytecode
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
84
85
86
87
88
89
90
91
92
93
94

use std::io;

use crate::hermes::decode::{decode_u32, read_bitfield};
use crate::hermes::encode::{encode_u32, encode_u8, write_bitfield};
use crate::hermes::Serializable;

#[cfg_attr(feature = "specta", derive(specta::Type))]
#[cfg_attr(feature = "serde", derive(serde::Serialize))]
#[derive(Debug)]
pub struct SmallStringTableEntry {
    pub is_utf_16: bool,
    pub offset: u32,
    pub length: u32,
    // Before v56 there was an additional "identifier" field, but there's no real reason to support it as of right now.
    // If someone needs it, raise an issue and provide the bytecode file format and def files.
}

impl Serializable for SmallStringTableEntry {
    type Version = u32;
    /// The size of a SmallStringTableEntry is 4 bytes, bitfields are used to store the data.
    fn size(&self) -> usize {
        4
    }

    fn deserialize<R>(r: &mut R, _version: u32) -> Self
    where
        R: io::Read + io::BufRead + io::Seek,
    {
        let mut string_storage_bytes = [0u8; 4];
        r.read_exact(&mut string_storage_bytes)
            .expect("unable to read string storage bytes");

        let is_utf_16 = read_bitfield(&string_storage_bytes, 0, 1);
        let offset = read_bitfield(&string_storage_bytes, 1, 23);
        let length = read_bitfield(&string_storage_bytes, 24, 8);

        SmallStringTableEntry {
            is_utf_16: is_utf_16 == 1,
            offset,
            length,
        }
    }

    fn serialize<W>(&self, w: &mut W)
    where
        W: io::Write,
    {
        let mut string_storage_bytes = [0u8; 4];
        write_bitfield(
            &mut string_storage_bytes,
            0,
            1,
            if self.is_utf_16 { 1 } else { 0 },
        );
        write_bitfield(&mut string_storage_bytes, 1, 23, self.offset);
        write_bitfield(&mut string_storage_bytes, 24, 8, self.length);
        for byte in &string_storage_bytes {
            encode_u8(w, *byte);
        }
    }
}

#[cfg_attr(feature = "specta", derive(specta::Type))]
#[cfg_attr(feature = "serde", derive(serde::Serialize))]
#[derive(Debug)]
pub struct OverflowStringTableEntry {
    pub offset: u32,
    pub length: u32,
}

impl Serializable for OverflowStringTableEntry {
    type Version = u32;
    fn size(&self) -> usize {
        8
    }

    fn deserialize<R>(r: &mut R, _version: u32) -> Self
    where
        R: io::Read + io::BufRead + io::Seek,
    {
        OverflowStringTableEntry {
            offset: decode_u32(r),
            length: decode_u32(r),
        }
    }

    fn serialize<W>(&self, w: &mut W)
    where
        W: io::Write,
    {
        encode_u32(w, self.offset);
        encode_u32(w, self.length);
    }
}