33 releases (18 breaking)
|0.19.10||Jan 14, 2021|
|0.19.9||Dec 30, 2020|
|0.17.0||Jul 13, 2020|
|0.2.0||Mar 26, 2016|
#7 in Embedded development
2,235 downloads per month
Used in 18 crates (10 directly)
Rhai is an embedded scripting language and evaluation engine for Rust that gives a safe and easy way to add scripting to any application.
- All common CPU targets for Windows, Linux and MacOS.
- WebAssembly (WASM)
- Minimum Rust version 1.45
- Fairly low compile-time overhead.
- Fairly efficient evaluation (1 million iterations in 0.3 sec on a single core, 2.3 GHz Linux VM).
- Tight integration with native Rust functions and types, including getters/setters, methods and indexers.
- Freely pass Rust variables/constants into a script via an external
Scope- all clonable Rust types are supported; no need to implement any special trait.
- Easily call a script-defined function from Rust.
- Relatively little
unsafecode (yes there are some for performance reasons).
- Few dependencies (currently only
- Re-entrant scripting engine can be made
Send + Sync(via the
- Scripts are optimized (useful for template-based machine-generated scripts) for repeated evaluations.
- Easy custom API development via plugins system powered by procedural macros.
- Function overloading and operator overloading.
- Dynamic dispatch via function pointers with additional support for currying.
- Closures (anonymous functions) that can capture shared values.
- Some syntactic support for object-oriented programming (OOP).
- Organize code base with dynamically-loadable modules.
- Serialization/deserialization support via serde (requires the
- Support for minimal builds by excluding unneeded language features.
- 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.
- Use as a DSL.
- Restrict the language by surgically disabling keywords and operators.
- Define custom operators.
- Extend the language with custom syntax.
See The Rhai Book for details on the Rhai scripting engine and language.
An Online Playground is available with syntax-highlighting editor, powered by WebAssembly.
Scripts can be evaluated directly from the editor.
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.