Go to file
Stephen Chung c5f11e8b1f
Merge pull request #367 from schungx/master
Fixed bug with shared value assignments.
2021-03-04 11:00:52 +08:00
.github/workflows Merge pull request #351 from schungx/master 2021-02-13 22:27:11 +08:00
benches Fix bug with op-assignment. 2021-02-24 16:17:04 +08:00
codegen Fix codegen test results. 2021-02-26 20:14:23 +08:00
examples Refine examples. 2021-02-20 23:46:25 +08:00
no_std/no_std_test Update URL links. 2021-01-07 17:30:06 +08:00
scripts Change rhai_runner and repl to rhai-run and rhai-repl. 2020-12-25 16:08:56 +08:00
src Fix no_closure build. 2021-03-04 10:50:45 +08:00
tests Make RhaiResult internal. 2021-03-03 22:49:29 +08:00
.gitignore Ignore benches/results. 2021-03-02 21:50:39 +08:00
Cargo.toml Bump version. 2021-02-27 12:52:20 +08:00
CHANGELOG.md Fix shared value assignments. 2021-03-04 10:24:14 +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 Add project website link to logo. 2021-03-01 12:43:11 +08:00

Rhai - Embedded Scripting for Rust

GitHub last commit Build Status license crates.io crates.io API Docs chat Reddit

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.

Supported targets and builds

  • All common CPU targets for Windows, Linux and MacOS.
  • WebAssembly (WASM)
  • no-std
  • Minimum Rust version 1.49

Standard features

  • Simple language similar to JavaScript+Rust with dynamic typing.
  • 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.
  • Built-in support for most common data types including booleans, integers, floating-point numbers (including Decimal), strings, Unicode characters, arrays and maps.
  • Easily call a script-defined function from Rust.
  • Relatively little unsafe code (yes there are some for performance reasons).
  • Few dependencies (currently only smallvec and ahash).
  • Re-entrant scripting engine can be made Send + Sync (via the sync feature).
  • Compile once to AST form for repeated evaluations.
  • Scripts are optimized (useful for template-based machine-generated scripts).
  • 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, optionally overriding the resolution process
  • Serialization/deserialization support via serde (requires the serde feature).
  • Support for minimal builds by excluding unneeded language features.

Protected against attacks

  • 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.

For those who actually want their own language

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.