lua_semantics 0.9.0

semantic analysis and enhanced AST converter for lua_parser crate
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

//! ```rust
//! // type of `lua_parser::Block`
//! let block = lua_parser::parse_str( ... )?;
//!
//! // semantic analysis, and generate enhanced AST for later use.
//! let enhanced_ast = lua_semantics::process(block)?;
//! ```
//!

mod context;
mod error;
mod expression;
mod label;
mod scope;
mod statement;

pub use lua_parser::FloatType;
pub use lua_parser::IntOrFloat;
pub use lua_parser::IntType;

pub use expression::ExprBinary;
pub use expression::ExprBinaryData;
pub use expression::ExprFunctionCall;
pub use expression::ExprFunctionObject;
pub use expression::ExprLocalVariable;
pub use expression::ExprTableConstructor;
pub use expression::ExprTableIndex;
pub use expression::ExprUnary;
pub use expression::ExprUnaryData;
pub use expression::Expression;
pub use expression::FunctionDefinition;

pub use statement::Attrib;
pub use statement::Block;
pub use statement::ReturnStatement;
pub use statement::Statement;
pub use statement::StmtAssignment;
pub use statement::StmtFor;
pub use statement::StmtForGeneric;
pub use statement::StmtFunctionCall;
pub use statement::StmtGoto;
pub use statement::StmtIf;
pub use statement::StmtLabel;
pub use statement::StmtLocalDeclaration;
pub use statement::StmtRepeat;
pub use statement::StmtWhile;

pub use context::Context;
pub use label::LabelInfo;
pub use scope::Scope;
pub use scope::ScopeBlock;
pub use scope::ScopeFunction;
pub use scope::VariableInfo;

pub use error::ProcessError;

/// perform semantic analysis on the given block and generate enhanced AST.
pub fn process(block: lua_parser::Block) -> Result<Block, ProcessError> {
    let mut context = Context::new();
    context.begin_scope(false);
    let block = context.process_block(block, true, false)?;

    // check all goto label is defined
    for (_, label_info) in context.labels.iter() {
        if label_info.borrow().scope.is_none() {
            let span = label_info.borrow().from[0].1;
            return Err(ProcessError::InvalidLabel(span));
        }
    }

    Ok(block)
}