unluac 1.1.1

Multi-dialect Lua decompiler written in Rust.
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

//! 这个文件定义 parser 层的错误类型。
//!
//! 错误里保留 offset 等定位信息，是为了让调试输出和回归测试可以直接定位
//! 原始 chunk 的问题位置，而不是把底层读取细节泄漏到更高层。

use thiserror::Error;

/// 将 Lua 字节码解析成 raw 结构时可能产生的错误。
#[derive(Debug, Error)]
pub enum ParseError {
    #[error("parser for dialect `{dialect}` is not implemented yet")]
    UnsupportedDialect { dialect: &'static str },
    #[error(
        "unexpected end of input at offset {offset}: need {requested} bytes but only {remaining} remain"
    )]
    UnexpectedEof {
        offset: usize,
        requested: usize,
        remaining: usize,
    },
    #[error("invalid Lua chunk signature at offset {offset}")]
    InvalidSignature { offset: usize },
    #[error("unsupported Lua version byte 0x{found:02x}")]
    UnsupportedVersion { found: u8 },
    #[error("unsupported PUC-Lua header format {found}")]
    UnsupportedHeaderFormat { found: u8 },
    #[error("unsupported {field} size {value} in bytecode chunk")]
    UnsupportedSize { field: &'static str, value: u8 },
    #[error("unsupported {field} value {value} in bytecode chunk")]
    UnsupportedValue { field: &'static str, value: u64 },
    #[error("integer overflow while decoding {field}: {value}")]
    IntegerOverflow { field: &'static str, value: u64 },
    #[error("negative {field} value {value} is not valid in this bytecode chunk")]
    NegativeValue { field: &'static str, value: i64 },
    #[error("invalid constant tag {tag} at offset {offset}")]
    InvalidConstantTag { offset: usize, tag: u8 },
    #[error(
        "luau closure const #{const_index} refers to proto {proto_index}, but current proto only exposes {child_count} child slots"
    )]
    InvalidLuauClosureProto {
        const_index: usize,
        proto_index: u32,
        child_count: usize,
    },
    #[error("invalid opcode {opcode} at raw pc {pc}")]
    InvalidOpcode { pc: usize, opcode: u8 },
    #[error("missing SETLIST extra argument after raw pc {pc}")]
    MissingSetListWord { pc: usize },
    #[error("opcode `{opcode}` at raw pc {pc} must be followed by EXTRAARG")]
    MissingExtraArgWord { pc: usize, opcode: &'static str },
    #[error("opcode `{opcode}` at raw pc {pc} must be followed by EXTRAARG, found opcode {found}")]
    InvalidExtraArgWord {
        pc: usize,
        opcode: &'static str,
        found: u8,
    },
    #[error("unterminated string payload at offset {offset}")]
    UnterminatedString { offset: usize },
    #[error("failed to decode string payload at offset {offset} as {encoding}")]
    StringDecode {
        offset: usize,
        encoding: &'static str,
    },
}