slew 0.2.0

A suspendable Lua interpreter with strict, embedder-controlled execution budgets
Documentation

slew

A suspendable Lua 5.4 interpreter in Rust. Load a script once, then run it with an exact fuel budget — the embedder controls precisely how fast a Lua program executes.

let mut lua = Lua::new();
let chunk = lua.load(r#"
    local n = 0
    while true do n = n + 1 end
"#)?;

let mut exec = lua.execute(&chunk);
loop {
    match exec.step(&mut lua, 1_000)? {
        Step::Done(values) => break,
        Step::Pending => { /* script paused after ~1000 ops; do other work */ }
    }
}

See DESIGN.md for architecture and roadmap.

REPL

cargo run            # interactive (reedline: multiline editing, history)
cargo run script.lua # run a file
echo 'print(1+2)' | cargo run   # run piped source

The REPL runs every input under a fuel budget — a runaway loop suspends instead of hanging, and :more grants it another budget:

slew> n = 0 while true do n = n + 1 end
~ suspended after 1000000 fuel (:more to continue, new input to abandon)
slew> n
(abandoned suspended execution)
333327

Commands: :fuel N, :more, :mem, :gc, :help, :quit.

The repl feature (on by default) pulls in reedline; library consumers can use default-features = false.

Conformance

The official Lua 5.4.9 test archive is the conformance corpus:

scripts/run-lua-tests.sh

The script downloads a pinned, checksum-verified archive into target/, runs a curated set of upstream test files, and compares each file's first failure against tests/lua-conformance.baseline. Getting further passes; failing earlier, or panicking the host, is a regression. Refresh the baseline after intentional progress with SLEW_BLESS=1 scripts/run-lua-tests.sh. Known intentional deviations from PUC-Lua are listed in DESIGN.md.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.