2017-10-28 22:33:00 +02:00
|
|
|
//! # Rhai - embedded scripting for Rust
|
2017-12-20 12:16:14 +01:00
|
|
|
//!
|
2017-10-28 22:33:00 +02:00
|
|
|
//! Rhai is a tiny, simple and very fast embedded scripting language for Rust
|
|
|
|
//! that gives you a safe and easy way to add scripting to your applications.
|
|
|
|
//! It provides a familiar syntax based on JS and Rust and a simple Rust interface.
|
|
|
|
//! Here is a quick example. First, the contents of `my_script.rhai`:
|
2017-12-20 12:16:14 +01:00
|
|
|
//!
|
|
|
|
//! ```rust,ignore
|
2017-10-28 22:33:00 +02:00
|
|
|
//! fn factorial(x) {
|
|
|
|
//! if x == 1 { return 1; }
|
|
|
|
//! x * factorial(x - 1)
|
|
|
|
//! }
|
|
|
|
//!
|
|
|
|
//! compute_something(factorial(10))
|
|
|
|
//! ```
|
2017-12-20 12:16:14 +01:00
|
|
|
//!
|
2017-10-28 22:33:00 +02:00
|
|
|
//! And the Rust part:
|
2017-12-20 12:16:14 +01:00
|
|
|
//!
|
2020-03-17 19:26:11 +01:00
|
|
|
//! ```rust,ignore
|
2020-03-09 14:09:53 +01:00
|
|
|
//! use rhai::{Engine, EvalAltResult, RegisterFn};
|
2017-12-20 12:16:14 +01:00
|
|
|
//!
|
2020-03-09 14:09:53 +01:00
|
|
|
//! fn main() -> Result<(), EvalAltResult>
|
|
|
|
//! {
|
|
|
|
//! fn compute_something(x: i64) -> bool {
|
|
|
|
//! (x % 40) == 0
|
|
|
|
//! }
|
|
|
|
//!
|
|
|
|
//! let mut engine = Engine::new();
|
|
|
|
//!
|
|
|
|
//! engine.register_fn("compute_something", compute_something);
|
2017-12-20 12:16:14 +01:00
|
|
|
//!
|
2020-03-13 09:17:55 +01:00
|
|
|
//! assert_eq!(engine.eval_file::<bool>("my_script.rhai".into())?, true);
|
2020-03-09 14:09:53 +01:00
|
|
|
//!
|
|
|
|
//! Ok(())
|
|
|
|
//! }
|
2017-10-28 22:33:00 +02:00
|
|
|
//! ```
|
|
|
|
//!
|
2017-12-20 12:16:14 +01:00
|
|
|
//! [Check out the README on GitHub for more information!](https://github.com/jonathandturner/rhai)
|
2016-03-03 16:55:28 +01:00
|
|
|
|
2020-03-17 19:26:11 +01:00
|
|
|
#![cfg_attr(feature = "no_stdlib", no_std)]
|
2019-09-18 12:21:07 +02:00
|
|
|
#![allow(non_snake_case)]
|
2017-10-02 23:44:45 +02:00
|
|
|
|
2020-03-17 19:26:11 +01:00
|
|
|
#[cfg(feature = "no_stdlib")]
|
|
|
|
extern crate alloc;
|
|
|
|
|
2018-02-09 22:27:41 +01:00
|
|
|
// needs to be here, because order matters for macros
|
|
|
|
macro_rules! debug_println {
|
2020-03-03 14:39:25 +01:00
|
|
|
() => (
|
|
|
|
#[cfg(feature = "debug_msgs")]
|
|
|
|
{
|
|
|
|
print!("\n");
|
|
|
|
}
|
|
|
|
);
|
|
|
|
($fmt:expr) => (
|
|
|
|
#[cfg(feature = "debug_msgs")]
|
|
|
|
{
|
|
|
|
print!(concat!($fmt, "\n"));
|
|
|
|
}
|
|
|
|
);
|
|
|
|
($fmt:expr, $($arg:tt)*) => (
|
|
|
|
#[cfg(feature = "debug_msgs")]
|
|
|
|
{
|
|
|
|
print!(concat!($fmt, "\n"), $($arg)*);
|
|
|
|
}
|
|
|
|
);
|
2018-02-09 22:27:41 +01:00
|
|
|
}
|
|
|
|
|
2020-03-17 19:26:11 +01:00
|
|
|
#[macro_use]
|
|
|
|
mod stdlib;
|
2017-12-20 12:16:14 +01:00
|
|
|
mod any;
|
2020-03-02 07:28:42 +01:00
|
|
|
mod api;
|
2020-03-01 10:37:47 +01:00
|
|
|
mod builtin;
|
2017-12-20 21:52:26 +01:00
|
|
|
mod call;
|
2016-03-03 16:55:28 +01:00
|
|
|
mod engine;
|
2020-03-04 15:00:01 +01:00
|
|
|
mod error;
|
2016-03-03 16:55:28 +01:00
|
|
|
mod fn_register;
|
2020-03-09 14:57:07 +01:00
|
|
|
mod optimize;
|
2016-03-03 16:55:28 +01:00
|
|
|
mod parser;
|
2020-03-04 15:00:01 +01:00
|
|
|
mod result;
|
2020-03-03 08:20:20 +01:00
|
|
|
mod scope;
|
2016-03-03 16:55:28 +01:00
|
|
|
|
2020-03-04 15:00:01 +01:00
|
|
|
pub use any::{Any, AnyExt, Dynamic, Variant};
|
|
|
|
pub use call::FuncArgs;
|
2020-03-10 10:10:33 +01:00
|
|
|
pub use engine::Engine;
|
2020-03-04 15:00:01 +01:00
|
|
|
pub use error::{ParseError, ParseErrorType};
|
2020-03-08 15:47:13 +01:00
|
|
|
pub use fn_register::{RegisterDynamicFn, RegisterFn, RegisterResultFn};
|
2020-03-14 13:06:40 +01:00
|
|
|
pub use parser::{Position, AST, INT};
|
2020-03-04 15:00:01 +01:00
|
|
|
pub use result::EvalAltResult;
|
2020-03-14 07:57:59 +01:00
|
|
|
pub use scope::{Scope, ScopeEntry, VariableType};
|
2020-03-10 10:10:33 +01:00
|
|
|
|
|
|
|
#[cfg(not(feature = "no_index"))]
|
|
|
|
pub use engine::Array;
|
2020-03-14 13:06:40 +01:00
|
|
|
|
|
|
|
#[cfg(not(feature = "no_float"))]
|
|
|
|
pub use parser::FLOAT;
|
2020-03-15 15:39:58 +01:00
|
|
|
|
|
|
|
#[cfg(not(feature = "no_optimize"))]
|
|
|
|
pub use optimize::OptimizationLevel;
|