rhai/src/lib.rs

52 lines
1.5 KiB
Rust
Raw Normal View History

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
//!
2017-12-21 12:28:59 +01:00
//! ```rust,no_run
2017-12-20 21:09:53 +01:00
//! use rhai::{Engine, RegisterFn};
2017-12-20 12:16:14 +01:00
//!
2017-10-28 22:33:00 +02:00
//! fn compute_something(x: i64) -> bool {
//! (x % 40) == 0
//! }
2017-12-20 12:16:14 +01:00
//!
2017-10-28 22:33:00 +02:00
//! let mut engine = Engine::new();
//! engine.register_fn("compute_something", compute_something);
2017-12-20 12:16:14 +01:00
//! assert_eq!(engine.eval_file::<bool>("my_script.rhai"), Ok(true));
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)
2019-09-18 12:21:07 +02:00
#![allow(non_snake_case)]
2017-10-02 23:44:45 +02:00
// needs to be here, because order matters for macros
macro_rules! debug_println {
() => (#[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)*)});
}
2017-12-20 12:16:14 +01:00
mod any;
2017-12-20 21:52:26 +01:00
mod call;
mod engine;
mod fn_register;
mod parser;
pub use any::Dynamic;
pub use engine::{Array, Engine, EvalAltResult, Scope};
pub use fn_register::{RegisterDynamicFn, RegisterFn};
pub use parser::{ParseError, ParseErrorType, AST};