#scripting-language #plugin #scripting #scripting-engine #proc-macro

macro no-std rhai_codegen

Procedural macros support package for Rhai, a scripting language and engine for Rust

24 releases (13 stable)

2.2.0 Jul 4, 2024
2.0.0 Feb 2, 2024
1.17.0 Jan 31, 2024
1.6.0 Sep 9, 2023
0.3.0 Nov 23, 2020

#1018 in Embedded development

Download history 19876/week @ 2024-04-05 22860/week @ 2024-04-12 23521/week @ 2024-04-19 22004/week @ 2024-04-26 21827/week @ 2024-05-03 25052/week @ 2024-05-10 21593/week @ 2024-05-17 19967/week @ 2024-05-24 23239/week @ 2024-05-31 21605/week @ 2024-06-07 22687/week @ 2024-06-14 22115/week @ 2024-06-21 19289/week @ 2024-06-28 23288/week @ 2024-07-05 22720/week @ 2024-07-12 20322/week @ 2024-07-19

89,475 downloads per month
Used in 154 crates (2 directly)

MIT/Apache

260KB
6.5K SLoC

Procedural Macros for Plugins

Rhai logo

This crate holds procedural macros for code generation, supporting the plugins system for Rhai.

This crate is automatically referenced by the Rhai crate. Normally it should not be used directly.


lib.rs:

This crate contains procedural macros to make creating Rhai plugin modules much easier.

Export an Entire Rust Module to a Rhai Module

use rhai::{EvalAltResult, FLOAT};
use rhai::plugin::*;
use rhai::module_resolvers::*;

#[export_module]
mod advanced_math {
    pub const MYSTIC_NUMBER: FLOAT = 42.0;

    pub fn euclidean_distance(x1: FLOAT, y1: FLOAT, x2: FLOAT, y2: FLOAT) -> FLOAT {
        ((y2 - y1).abs().powf(2.0) + (x2 -x1).abs().powf(2.0)).sqrt()
    }
}

let mut engine = Engine::new();
let m = exported_module!(advanced_math);
let mut r = StaticModuleResolver::new();
r.insert("Math::Advanced", m);
engine.set_module_resolver(r);

assert_eq!(engine.eval::<FLOAT>(
    r#"
        import "Math::Advanced" as math;
        math::euclidean_distance(0.0, 1.0, 0.0, math::MYSTIC_NUMBER)
    "#)?, 41.0);

Dependencies

~260–710KB
~17K SLoC