|0.1.12||Nov 1, 2023|
|0.1.11||Sep 25, 2023|
|0.1.9||Jun 26, 2023|
|0.1.8||May 3, 2023|
|0.1.0||Oct 13, 2022|
#80 in Embedded development
1,473 downloads per month
Used in 4 crates (via vsmtp-rule-engine)
🚧 This is a work in progress, the API is subject to change. Please do make recommendations on what you want it to be via issues, discussions or pull requests !
Loader is a trait that is used to build objects that load rhai modules from dynamic libraries in memory. A libloading implementation is available, which enables you to load modules via a
dylib rust crate.
simple example for more details.
This crate also expose a Rhai Module Resolver that loads dynamic libraries at the given path.
use rhai_dylib::module_resolvers::libloading::DylibModuleResolver; let mut engine = rhai::Engine::new(); // use `rhai::module_resolvers::ModuleResolversCollection` if you need to resolve using // other resolvers. // Check out https://docs.rs/rhai/latest/rhai/module_resolvers/struct.ModuleResolversCollection.html engine.set_module_resolver(DylibModuleResolver::new()); engine.run(r#" import "/usr/lib/libmy" as my; // Import your dynamic library. my::my_function(); // Use exported items ! "#).expect("failed to run script");
module_resolver example for more details.
There are multiple limitations with this implementation.
TL;DR To use this crate, you need to:
- Compile EVERYTHING, plugins and program that will load them, inside the SAME workspace or WITHOUT a workspace.
- Use the
rhai::config::hashing::set_ahash_seedfunction with the SAME four u64 array when building your plugins and the program that will load them. (i.e.
rhai::config::hashing::set_ahash_seed(Some([1, 2, 3, 4])))
TypeId is an object used to compare types at compile time. Rhai uses those to check which type a
Dynamic object is. This is a problem for dynamic libraries because
TypeIds sometime change between compilations.
That means that in certain situations, Rhai cannot compare two types, even though they are the same, because the
TypeId of said types is different between the plugin and the binary.
To fix this, you will need to compile your main binary AND plugins inside the SAME workspace, or compile everything OUTSIDE of a workspace. Compiling, for example, a binary in a workspace, and a plugin outside will probably result in
You can use
In your binary & plugins to check the type id value.
If you have any idea of how the compiler generates those typeids between workspaces and single crates, please help us complete this readme !
Rhai uses the
ahash crate under the hood to create identifiers for function calls. For each compilation of your code, a new seed is generated when hashing the types. Therefore, compiling your main program and your plugin different times will result in a hash mismatch, meaning that you won't be able to call the API of your plugin.
To bypass that, you need to use the
rhai::config::hashing::set_ahash_seed function with an array of four
If your plugin is still not working after you read the sections above, you could check those points too:
- Use the same toolchain version for all crates.
- Use the same rhai-dylib dependency version in all crates.
- Try to build the crates with the same target type. (both debug or both release)
- Enable/Disable link time optimization flag (-C lto) for all crates.
If none of those solutions works, do not hesitate to open an issue !
You also can implement a plugin using the Rust ABI, which is unstable and will change between compiler versions.
This means that all of the plugins that you will use in your main program need to be compiled with the EXACT same compiler version.