unluac 1.3.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

//! AST 层入口。

mod build;
mod common;
#[cfg(feature = "decompile-debug")]
mod debug;
mod error;
mod features;
mod naming;
pub(crate) mod pretty;
mod readability;
pub(crate) mod traverse;

pub use crate::decompile::DecompileDialect;
pub use build::lower_ast;
pub use common::{
    AstAssign, AstBinaryExpr, AstBinaryOpKind, AstBindingRef, AstBlock, AstCallExpr, AstCallKind,
    AstCallStmt, AstDialectCaps, AstExpr, AstFeature, AstFieldAccess, AstFunctionDecl,
    AstFunctionExpr, AstFunctionName, AstGenericFor, AstGlobalAttr, AstGlobalBinding,
    AstGlobalBindingTarget, AstGlobalDecl, AstGlobalName, AstGoto, AstIf, AstIndexAccess,
    AstLValue, AstLabel, AstLabelId, AstLocalAttr, AstLocalBinding, AstLocalDecl,
    AstLocalFunctionDecl, AstLocalOrigin, AstLogicalExpr, AstMethodCallExpr, AstModule,
    AstNamePath, AstNameRef, AstNumericFor, AstRecordField, AstRepeat, AstReturn, AstStmt,
    AstSyntheticLocalId, AstTableConstructor, AstTableField, AstTableKey, AstTargetDialect,
    AstUnaryExpr, AstUnaryOpKind, AstWhile,
};
#[cfg(feature = "decompile-debug")]
pub use debug::dump_ast;
#[cfg(not(feature = "decompile-debug"))]
mod debug {
    crate::debug::define_unavailable_stage_dump!(dump_ast);
}
pub(crate) use common::is_lua_identifier_name;
#[cfg(not(feature = "decompile-debug"))]
pub use debug::dump_ast;
pub use error::AstLowerError;
pub(crate) use features::collect_ast_features;
pub use naming::{
    FunctionNameMap, NameInfo, NameMap, NameSource, NamingError, NamingEvidence, NamingMode,
    NamingOptions, assign_name_map, assign_names_with_evidence, collect_naming_evidence,
};
pub use readability::ReadabilityOptions;

pub(crate) fn analyze_ast_stage(
    state: &mut crate::decompile::DecompileState,
    context: &crate::decompile::DecompileContext<'_>,
) -> Result<(), crate::decompile::DecompileError> {
    {
        let _timing = context.timings.scope("build");
        build::lower_ast_for_generate(state, context)?;
    }
    {
        let _timing = context.timings.scope("readability");
        readability::make_readable(state, context)?;
    }
    {
        let _timing = context.timings.scope("naming");
        naming::assign_names(state, context)?;
    }

    Ok(())
}