unluac 1.1.0

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
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
95
96
97
98

//! 这个模块承载整个字节码 parser 层。
//!
//! 它的职责是提供统一入口、共享基础设施和跨 dialect 共享的数据模型；
//! 具体某个 dialect 的 parser 本体与专属枚举都放到子目录里，避免公共层
//! 被单个版本的细节持续污染。

mod debug;
mod dialect;
mod error;
mod options;
mod raw;
mod reader;

pub use debug::dump_parser;
pub use dialect::lua51::*;
pub use dialect::lua52::*;
pub use dialect::lua53::*;
pub use dialect::lua54::*;
pub use dialect::lua55::*;
pub use dialect::luajit::*;
pub use dialect::luau::*;
pub use error::ParseError;
pub use options::{ParseMode, ParseOptions, StringDecodeMode, StringEncoding};
pub use raw::*;

use dialect::lua51::Lua51Parser;
use dialect::lua52::Lua52Parser;
use dialect::lua53::Lua53Parser;
use dialect::lua54::Lua54Parser;
use dialect::lua55::Lua55Parser;
use dialect::luajit::LuaJitParser;
use dialect::luau::LuauParser;

const LUA_SIGNATURE: &[u8; 4] = b"\x1bLua";
const LUA51_VERSION: u8 = 0x51;
const LUA52_VERSION: u8 = 0x52;
const LUA53_VERSION: u8 = 0x53;
const LUA54_VERSION: u8 = 0x54;
const LUA55_VERSION: u8 = 0x55;

/// 根据 chunk header 自动选择对应 dialect parser。
pub fn parse_chunk(bytes: &[u8], options: ParseOptions) -> Result<RawChunk, ParseError> {
    if bytes.len() < 5 {
        return Err(ParseError::UnexpectedEof {
            offset: 0,
            requested: 5,
            remaining: bytes.len(),
        });
    }

    if &bytes[..4] != LUA_SIGNATURE {
        return Err(ParseError::InvalidSignature { offset: 0 });
    }

    match bytes[4] {
        LUA51_VERSION => Lua51Parser::new(options).parse(bytes),
        LUA52_VERSION => Lua52Parser::new(options).parse(bytes),
        LUA53_VERSION => Lua53Parser::new(options).parse(bytes),
        LUA54_VERSION => Lua54Parser::new(options).parse(bytes),
        LUA55_VERSION => Lua55Parser::new(options).parse(bytes),
        found => Err(ParseError::UnsupportedVersion { found }),
    }
}

/// 直接按 Lua 5.1 规则解析 chunk，不做版本自动探测。
pub fn parse_lua51_chunk(bytes: &[u8], options: ParseOptions) -> Result<RawChunk, ParseError> {
    Lua51Parser::new(options).parse(bytes)
}

/// 直接按 Lua 5.2 规则解析 chunk，不做版本自动探测。
pub fn parse_lua52_chunk(bytes: &[u8], options: ParseOptions) -> Result<RawChunk, ParseError> {
    Lua52Parser::new(options).parse(bytes)
}

/// 直接按 Lua 5.3 规则解析 chunk，不做版本自动探测。
pub fn parse_lua53_chunk(bytes: &[u8], options: ParseOptions) -> Result<RawChunk, ParseError> {
    Lua53Parser::new(options).parse(bytes)
}

/// 直接按 Lua 5.4 规则解析 chunk，不做版本自动探测。
pub fn parse_lua54_chunk(bytes: &[u8], options: ParseOptions) -> Result<RawChunk, ParseError> {
    Lua54Parser::new(options).parse(bytes)
}

/// 直接按 Lua 5.5 规则解析 chunk，不做版本自动探测。
pub fn parse_lua55_chunk(bytes: &[u8], options: ParseOptions) -> Result<RawChunk, ParseError> {
    Lua55Parser::new(options).parse(bytes)
}

/// LuaJIT 入口保留显式 dialect 分派，不走 PUC-Lua 自动探测。
pub fn parse_luajit_chunk(bytes: &[u8], options: ParseOptions) -> Result<RawChunk, ParseError> {
    LuaJitParser::new(options).parse(bytes)
}

/// Luau 入口先只保留显式 dialect 分派位，避免调用方继续误走 PUC-Lua 自动探测。
pub fn parse_luau_chunk(bytes: &[u8], options: ParseOptions) -> Result<RawChunk, ParseError> {
    LuauParser::new(options).parse(bytes)
}