plugy

plugy是一个插件系统，旨在使基于Rust的插件能够无缝集成到您的应用程序中。它为使用WebAssembly（Wasm）编写的插件提供运行时环境，使您的Rust项目能够实现动态扩展和模块化。

特性

• 加载和执行编译为WASM的插件。
• 灵活的插件运行时管理。
• 插件函数调用是异步的。
• 用于生成插件接口的易于使用的宏。

入门

要在您的Rust项目中使用plugy，请按照以下步骤操作

1. 编写您的插件trait

#[plugy::plugin]
trait Greeter {
    fn greet(&self) -> String;
}

2. 编写您的第一个插件实现

#[derive(Debug, Deserialize)]
struct FooPlugin;

#[plugin_impl]
impl Greeter for FooPlugin {
    fn greet(&self) -> String {
        "Hello From Foo Plugin".to_owned()
    }
}

编译它！

cargo build --target wasm32-unknown-unknown

3. 导入并运行

#[plugin_import(file = "target/wasm32-unknown-unknown/debug/foo_plugin.wasm")]
struct FooPlugin;

#[tokio::main]
async fn main() {
    let runtime = Runtime::<Box<dyn Greeter>>::new().unwrap();
    let handle = runtime.load(FooPlugin).await.unwrap();
    let res = handle.greet().await;
    assert_eq!(res, "Hello From Foo Plugin")
}

您就完成了！

示例

请查看示例目录以了解plugy的示例用法。

里程碑

功能

Plugy由三个基本crate组成，每个crate在用Rust和WebAssembly构建动态插件系统时都扮演着不同的角色

• core：此crate包含位操作工具和客户机模块等基本组件，是Plugy功能的基础。

• runtime：运行时crate协调您的插件系统的执行，允许插件无缝集成到您的应用程序中。

• macros：macros crate提供了一组宏，简化了绑定和接口的生成，简化了与动态插件一起工作的过程。

贡献

欢迎对plugy的贡献！如果您发现了一个错误或想提出一个新功能，请随意创建一个问题或提交一个pull request。

感谢

• Wasmtime
• Bincode
• Serde
• Wasmtime-Serde启发了这个项目的许多内部工作

许可

本项目采用MIT OR Apache-2.0许可。