|
|
@@ -10,7 +10,7 @@ Rhai - Embedded Scripting for Rust
|
|
|
|
[](https://discord.gg/HquqbYFcZ9)
|
|
|
|
[](https://discord.gg/HquqbYFcZ9)
|
|
|
|
[](https://www.reddit.com/r/Rhai)
|
|
|
|
[](https://www.reddit.com/r/Rhai)
|
|
|
|
|
|
|
|
|
|
|
|

|
|
|
|

|
|
|
|
|
|
|
|
|
|
|
|
Rhai is an embedded scripting language and evaluation engine for Rust that gives a safe and easy way
|
|
|
|
Rhai is an embedded scripting language and evaluation engine for Rust that gives a safe and easy way
|
|
|
|
to add scripting to any application.
|
|
|
|
to add scripting to any application.
|
|
|
@@ -30,51 +30,51 @@ Standard features
|
|
|
|
|
|
|
|
|
|
|
|
* Simple language similar to JavaScript+Rust with dynamic typing.
|
|
|
|
* 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).
|
|
|
|
* 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](https://rhaiscript.github.io/book/rust/functions.html) and [types]([#custom-types-and-methods](https://rhaiscript.github.io/book/rust/custom.html)), including [getters/setters](https://rhaiscript.github.io/book/rust/getters-setters.html), [methods](https://rhaiscript.github.io/book/rust/custom.html) and [indexers](https://rhaiscript.github.io/book/rust/indexers.html).
|
|
|
|
* Tight integration with native Rust [functions](https://rhai.rs/book/rust/functions.html) and [types]([#custom-types-and-methods](https://rhai.rs/book/rust/custom.html)), including [getters/setters](https://rhai.rs/book/rust/getters-setters.html), [methods](https://rhai.rs/book/rust/custom.html) and [indexers](https://rhai.rs/book/rust/indexers.html).
|
|
|
|
* Freely pass Rust variables/constants into a script via an external [`Scope`](https://rhaiscript.github.io/book/rust/scope.html) - all clonable Rust types are supported; no need to implement any special trait.
|
|
|
|
* Freely pass Rust variables/constants into a script via an external [`Scope`](https://rhai.rs/book/rust/scope.html) - all clonable Rust types are supported; no need to implement any special trait.
|
|
|
|
* Easily [call a script-defined function](https://rhaiscript.github.io/book/engine/call-fn.html) from Rust.
|
|
|
|
* Easily [call a script-defined function](https://rhai.rs/book/engine/call-fn.html) from Rust.
|
|
|
|
* Relatively little `unsafe` code (yes there are some for performance reasons).
|
|
|
|
* Relatively little `unsafe` code (yes there are some for performance reasons).
|
|
|
|
* Few dependencies (currently only [`smallvec`](https://crates.io/crates/smallvec) and [`ahash`](https://crates.io/crates/ahash)).
|
|
|
|
* Few dependencies (currently only [`smallvec`](https://crates.io/crates/smallvec) and [`ahash`](https://crates.io/crates/ahash)).
|
|
|
|
* Re-entrant scripting engine can be made `Send + Sync` (via the `sync` feature).
|
|
|
|
* Re-entrant scripting engine can be made `Send + Sync` (via the `sync` feature).
|
|
|
|
* Compile once to AST form for repeated evaluations.
|
|
|
|
* Compile once to AST form for repeated evaluations.
|
|
|
|
* Scripts are [optimized](https://rhaiscript.github.io/book/engine/optimize.html) (useful for template-based machine-generated scripts).
|
|
|
|
* Scripts are [optimized](https://rhai.rs/book/engine/optimize.html) (useful for template-based machine-generated scripts).
|
|
|
|
* Easy custom API development via [plugins](https://rhaiscript.github.io/book/plugins/index.html) system powered by procedural macros.
|
|
|
|
* Easy custom API development via [plugins](https://rhai.rs/book/plugins/index.html) system powered by procedural macros.
|
|
|
|
* [Function overloading](https://rhaiscript.github.io/book/language/overload.html) and [operator overloading](https://rhaiscript.github.io/book/rust/operators.html).
|
|
|
|
* [Function overloading](https://rhai.rs/book/language/overload.html) and [operator overloading](https://rhai.rs/book/rust/operators.html).
|
|
|
|
* Dynamic dispatch via [function pointers](https://rhaiscript.github.io/book/language/fn-ptr.html) with additional support for [currying](https://rhaiscript.github.io/book/language/fn-curry.html).
|
|
|
|
* Dynamic dispatch via [function pointers](https://rhai.rs/book/language/fn-ptr.html) with additional support for [currying](https://rhai.rs/book/language/fn-curry.html).
|
|
|
|
* [Closures](https://rhaiscript.github.io/book/language/fn-closure.html) (anonymous functions) that can capture shared values.
|
|
|
|
* [Closures](https://rhai.rs/book/language/fn-closure.html) (anonymous functions) that can capture shared values.
|
|
|
|
* Some syntactic support for [object-oriented programming (OOP)](https://rhaiscript.github.io/book/language/oop.html).
|
|
|
|
* Some syntactic support for [object-oriented programming (OOP)](https://rhai.rs/book/language/oop.html).
|
|
|
|
* Organize code base with dynamically-loadable [modules](https://rhaiscript.github.io/book/language/modules.html), optionally overriding the resolution process
|
|
|
|
* Organize code base with dynamically-loadable [modules](https://rhai.rs/book/language/modules.html), optionally overriding the resolution process
|
|
|
|
* Serialization/deserialization support via [serde](https://crates.io/crates/serde) (requires the `serde` feature).
|
|
|
|
* Serialization/deserialization support via [serde](https://crates.io/crates/serde) (requires the `serde` feature).
|
|
|
|
* Support for [minimal builds](https://rhaiscript.github.io/book/start/builds/minimal.html) by excluding unneeded language [features](https://rhaiscript.github.io/book/start/features.html).
|
|
|
|
* Support for [minimal builds](https://rhai.rs/book/start/builds/minimal.html) by excluding unneeded language [features](https://rhai.rs/book/start/features.html).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Protected against attacks
|
|
|
|
Protected against attacks
|
|
|
|
-------------------------
|
|
|
|
-------------------------
|
|
|
|
|
|
|
|
|
|
|
|
* Sand-boxed - the scripting engine, if declared immutable, cannot mutate the containing environment unless [explicitly permitted](https://rhaiscript.github.io/book/patterns/control.html).
|
|
|
|
* Sand-boxed - the scripting engine, if declared immutable, cannot mutate the containing environment unless [explicitly permitted](https://rhai.rs/book/patterns/control.html).
|
|
|
|
* Rugged - protected against malicious attacks (such as [stack-overflow](https://rhaiscript.github.io/book/safety/max-call-stack.html), [over-sized data](https://rhaiscript.github.io/book/safety/max-string-size.html), and [runaway scripts](https://rhaiscript.github.io/book/safety/max-operations.html) etc.) that may come from untrusted third-party user-land scripts.
|
|
|
|
* Rugged - protected against malicious attacks (such as [stack-overflow](https://rhai.rs/book/safety/max-call-stack.html), [over-sized data](https://rhai.rs/book/safety/max-string-size.html), and [runaway scripts](https://rhai.rs/book/safety/max-operations.html) etc.) that may come from untrusted third-party user-land scripts.
|
|
|
|
* Track script evaluation [progress](https://rhaiscript.github.io/book/safety/progress.html) and manually terminate a script run.
|
|
|
|
* Track script evaluation [progress](https://rhai.rs/book/safety/progress.html) and manually terminate a script run.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
For those who actually want their own language
|
|
|
|
For those who actually want their own language
|
|
|
|
---------------------------------------------
|
|
|
|
---------------------------------------------
|
|
|
|
|
|
|
|
|
|
|
|
* Use as a [DSL](https://rhaiscript.github.io/book/engine/dsl.html).
|
|
|
|
* Use as a [DSL](https://rhai.rs/book/engine/dsl.html).
|
|
|
|
* Restrict the language by surgically [disabling keywords and operators](https://rhaiscript.github.io/book/engine/disable.html).
|
|
|
|
* Restrict the language by surgically [disabling keywords and operators](https://rhai.rs/book/engine/disable.html).
|
|
|
|
* Define [custom operators](https://rhaiscript.github.io/book/engine/custom-op.html).
|
|
|
|
* Define [custom operators](https://rhai.rs/book/engine/custom-op.html).
|
|
|
|
* Extend the language with [custom syntax](https://rhaiscript.github.io/book/engine/custom-syntax.html).
|
|
|
|
* Extend the language with [custom syntax](https://rhai.rs/book/engine/custom-syntax.html).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Documentation
|
|
|
|
Documentation
|
|
|
|
-------------
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
|
|
See [The Rhai Book](https://rhaiscript.github.io/book) for details on the Rhai scripting engine and language.
|
|
|
|
See [The Rhai Book](https://rhai.rs/book) for details on the Rhai scripting engine and language.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Playground
|
|
|
|
Playground
|
|
|
|
----------
|
|
|
|
----------
|
|
|
|
|
|
|
|
|
|
|
|
An [Online Playground](https://rhaiscript.github.io/playground) is available with
|
|
|
|
An [Online Playground](https://rhai.rs/playground) is available with
|
|
|
|
syntax-highlighting editor, powered by WebAssembly.
|
|
|
|
syntax-highlighting editor, powered by WebAssembly.
|
|
|
|
|
|
|
|
|
|
|
|
Scripts can be evaluated directly from the editor.
|
|
|
|
Scripts can be evaluated directly from the editor.
|
|
|
|