Go to file
2023-08-08 12:13:13 +00:00
.github/workflows Revert "Enable macos for no-std tests." 2023-05-13 14:59:30 +08:00
benches New packages API. 2022-08-18 17:22:56 +08:00
codegen Fix tests output. 2023-06-15 11:06:14 +08:00
examples Refine example scripts. 2023-05-10 08:55:38 +08:00
no_std/no_std_test Fix no-std builds. 2022-01-27 15:03:50 +08:00
scripts Add script example. 2023-03-23 17:11:42 +08:00
src Fix bug. 2023-06-27 17:14:18 +08:00
tests Improve type display in error messages. 2023-05-13 10:47:39 +08:00
tools Fix reverse lookup table for keywords 2023-04-25 22:33:29 +08:00
.gitattributes Add .gitattributes. 2022-03-14 09:34:28 +08:00
.gitignore Fine tune table-driven tokenizing. 2023-03-15 17:22:11 +08:00
build.rs fix build.yml, concurrency concerns, build.rs concerns 2022-11-04 15:36:18 +09:00
build.template Satisfy Clippy. 2022-11-23 13:24:14 +08:00
Cargo.toml Bump version. 2023-06-26 08:48:22 +08:00
CHANGELOG.md Fix bug. 2023-06-27 17:14:18 +08:00
LICENSE-APACHE.txt Remove appendix from LICENSE-APACHE.txt 2020-07-25 07:08:13 +02:00
LICENSE-MIT.txt Add LICENSE-MIT.txt (based on Syn) 2020-07-25 07:08:16 +02:00
README.md Refine error display. 2022-11-27 18:00:02 +08:00
renovate.json Add renovate.json 2023-07-03 10:44:17 +00:00

Rhai - Embedded Scripting for Rust

GitHub last commit Build Status Stars License crates.io crates.io API Docs VS Code plugin installs Sublime Text package downloads Discord Chat Zulip Chat Reddit Channel

Rhai logo

Rhai is an embedded scripting language and evaluation engine for Rust that gives a safe and easy way to add scripting to any application.

Targets and builds

  • All CPU and O/S targets supported by Rust, including:
    • WebAssembly (WASM)
    • no-std
  • Minimum Rust version 1.61.0

Standard features

Protected against attacks

  • Don't Panic guarantee - Any panic is a bug. Rhai subscribes to the motto that a library should never panic the host system, and is coded with this in mind.
  • Sand-boxed - the scripting engine, if declared immutable, cannot mutate the containing environment unless explicitly permitted.
  • Rugged - protected against malicious attacks (such as stack-overflow, over-sized data, and runaway scripts etc.) that may come from untrusted third-party user-land scripts.
  • Track script evaluation progress and manually terminate a script run.
  • Passes Miri.

For those who actually want their own language

Example

The scripts subdirectory contains sample Rhai scripts.

Below is the standard Fibonacci example for scripting languages:

// This Rhai script calculates the n-th Fibonacci number using a
// really dumb algorithm to test the speed of the scripting engine.

const TARGET = 28;
const REPEAT = 5;
const ANSWER = 317_811;

fn fib(n) {
    if n < 2 {
        n
    } else {
        fib(n-1) + fib(n-2)
    }
}

print(`Running Fibonacci(${TARGET}) x ${REPEAT} times...`);
print("Ready... Go!");

let result;
let now = timestamp();

for n in 0..REPEAT {
    result = fib(TARGET);
}

print(`Finished. Run time = ${now.elapsed} seconds.`);

print(`Fibonacci number #${TARGET} = ${result}`);

if result != ANSWER {
    print(`The answer is WRONG! Should be ${ANSWER}!`);
}

Project Site

rhai.rs

Documentation

See The Rhai Book for details on the Rhai scripting engine and language.

Playground

An Online Playground is available with syntax-highlighting editor, powered by WebAssembly.

Scripts can be evaluated directly from the editor.

License

Licensed under either of the following, at your choice:

Unless explicitly stated 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.