luaur-repl-cli 0.1.3

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

use alloc::vec::Vec;
use core::cell::RefCell;

use rustyline::completion::Pair;

use luaur_vm::type_aliases::lua_state::lua_State;

use crate::functions::get_completions::get_completions;

// Faithful rustyline analog of Repl.cpp's `icGetCompletions`.
//
// In C++ this bridged isocline's completion environment to the REPL's
// `getCompletions`, calling `ic_add_completion_ex(cenv, completion, display, …)`
// for each match. With rustyline the "completion environment" becomes a
// `Vec<Pair>`: the `replacement` is the full completed word (what isocline used
// as the inserted completion text) and the `display` is the matched key (the
// human-readable alternative that isocline displayed when listing matches).
//
// `getCompletions`'s callback is `const AddCompletionCallback&` (an immutable
// `Fn` in Rust, mirroring C++'s `std::function` passed by const reference), so
// the accumulator uses interior mutability to collect the matches.
pub unsafe fn ic_get_completions(l: *mut lua_State, edit_buffer: &str) -> Vec<Pair> {
    let completions: RefCell<Vec<Pair>> = RefCell::new(Vec::new());

    get_completions(l, edit_buffer, &|completion: &str, display: &str| {
        completions.borrow_mut().push(Pair {
            display: display.into(),
            replacement: completion.into(),
        });
    });

    completions.into_inner()
}