luaur-repl-cli 0.1.1

Interactive Luau REPL (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

use core::ffi::c_char;

use luaur_vm::functions::lua_l_getmetafield::lua_l_getmetafield;
use luaur_vm::functions::lua_pushnil::lua_pushnil;
use luaur_vm::functions::lua_pushvalue::lua_pushvalue;
use luaur_vm::functions::lua_rawget::lua_rawget;
use luaur_vm::functions::lua_remove::lua_remove;
use luaur_vm::functions::lua_replace::lua_replace;
use luaur_vm::macros::lua_isnil::lua_isnil;
use luaur_vm::macros::lua_istable::lua_istable;
use luaur_vm::macros::lua_pop::lua_pop;
use luaur_vm::type_aliases::lua_state::lua_State;

// Mirrors MaxTraversalLimit in Repl.cpp.
const MAX_TRAVERSAL_LIMIT: i32 = 50;

// This function is similar to lua_gettable, but it avoids calling any
// lua callback functions (e.g. __index) which might modify the Lua VM state.
pub unsafe fn safe_get_table(l: *mut lua_State, table_index: i32) {
    lua_pushvalue(l, table_index); // Duplicate the table

    // The loop invariant is that the table to search is at -1
    // and the key is at -2.
    let mut loop_count = 0;
    loop {
        lua_pushvalue(l, -2); // Duplicate the key
        lua_rawget(l, -2); // Try to find the key
        if !lua_isnil!(l, -1) || loop_count >= MAX_TRAVERSAL_LIMIT {
            // Either the key has been found, and/or we have reached the max traversal limit
            break;
        } else {
            lua_pop(l, 1); // Pop the nil result
            if lua_l_getmetafield(l, -1, c"__index".as_ptr() as *const c_char) == 0 {
                lua_pushnil(l);
                break;
            } else if lua_istable!(l, -1) {
                // Replace the current table being searched with __index table
                lua_replace(l, -2);
            } else {
                lua_pop(l, 1); // Pop the value
                lua_pushnil(l);
                break;
            }
        }

        loop_count += 1;
    }

    lua_remove(l, -2); // Remove the table
    lua_remove(l, -2); // Remove the original key
}