unluac 1.2.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
65
66

//! 这个文件承载 parser 层对外暴露的调试入口。
//!
//! 具体某个 dialect 的 dump 逻辑放在各自目录里，这里只负责根据解析结果做
//! 分派；另外共享 `ParserProtoEntry` 与 `build_parser_summary_row`，
//! 让各 dialect 在构造 elided 占位行时用同一套字段语义（lines/instrs/children）。

use crate::debug::{DebugColorMode, DebugDetail, DebugFilters, ProtoSummaryRow};

use super::dialect::lua51;
use super::dialect::lua52;
use super::dialect::lua53;
use super::dialect::lua54;
use super::dialect::lua55;
use super::dialect::luajit;
use super::dialect::luau;
use super::{DialectVersion, RawChunk, RawProto};

/// 根据 chunk 的实际 dialect 分派到对应的 parser dump 实现。
pub fn dump_parser(
    chunk: &RawChunk,
    detail: DebugDetail,
    filters: &DebugFilters,
    color: DebugColorMode,
) -> String {
    match chunk.header.version {
        DialectVersion::Lua51 => lua51::dump_chunk(chunk, detail, filters, color),
        DialectVersion::Lua52 => lua52::dump_chunk(chunk, detail, filters, color),
        DialectVersion::Lua53 => lua53::dump_chunk(chunk, detail, filters, color),
        DialectVersion::Lua54 => lua54::dump_chunk(chunk, detail, filters, color),
        DialectVersion::Lua55 => lua55::dump_chunk(chunk, detail, filters, color),
        DialectVersion::LuaJit => luajit::dump_chunk(chunk, detail, filters, color),
        DialectVersion::Luau => luau::dump_chunk(chunk, detail, filters, color),
    }
}

/// 各 dialect parser dump 复用的 `(id, parent, depth, proto)` 快照。
///
/// dialect 自己的 `ProtoEntry<'a>` 携带的方言特有字段（flags、extra 等）不在
/// 这里出现；这个投影只保留 `format_proto_summary_row` 需要的那几项。
/// `parent` 目前没有被读，但保留以便未来 breadcrumb/children dump 可以复用。
#[derive(Debug, Clone, Copy)]
pub(crate) struct ParserProtoEntry<'a> {
    pub id: usize,
    #[allow(dead_code)]
    pub parent: Option<usize>,
    pub depth: usize,
    pub proto: &'a RawProto,
}

/// 把 `RawProto` 压成 elided 行。parser 阶段拿不到函数名，只能呈现
/// `lines / instrs / children` 三项，这些都从 `RawProto::common` 里直接取得。
pub(crate) fn build_parser_summary_row(entry: &ParserProtoEntry<'_>) -> ProtoSummaryRow {
    ProtoSummaryRow {
        id: entry.id,
        depth_below_focus: entry.depth,
        name: None,
        first: None,
        lines: Some((
            entry.proto.common.line_range.defined_start,
            entry.proto.common.line_range.defined_end,
        )),
        instrs: Some(entry.proto.common.instructions.len()),
        children: Some(entry.proto.common.children.len()),
    }
}