Rust插件库holochain_test_wasm_common的使用：用于Holochain框架WASM模块测试的通用工具库

holochain_test_wasm_common是一个用于Wasm测试的通用代码库。

安装方法

在项目目录中运行以下Cargo命令：

cargo add holochain_test_wasm_common

或者在Cargo.toml中添加以下行：

holochain_test_wasm_common = "0.5.4"

基本信息

• 当前版本：0.5.4
• 发布时间：22天前
• 支持的Rust版本：2021 edition
• 开源许可证：Apache-2.0
• 库大小：1.91 KiB

开发团队

• holochain核心开发团队
• Eric Harris-Braun
• holochain自动化发布团队

示例代码

以下是内容中提供的完整示例：

// 在Cargo.toml中添加依赖项：
// [dependencies]
// holochain_test_wasm_common = "0.5.4"

use holochain_test_wasm_common::*;

// 示例测试函数
#[test]
fn test_wasm_operations() {
    // 初始化测试环境
    let mut test_env = TestEnvironment::new();
    
    // 创建测试数据
    let test_data = TestData::new("example_data".to_string());
    
    // 执行WASM操作测试
    let result = test_env.execute_wasm("example_wasm_module", test_data);
    
    // 验证结果
    assert!(result.is_ok());
    assert_eq!(result.unwrap(), "expected_output");
    
    // 清理测试环境
    test_env.cleanup();
}

// 示例WASM模块模拟
struct ExampleWasmModule;

impl WasmModule for ExampleWasmModule {
    fn execute(&self, input: TestData) -> Result<String, String> {
        if input.data == "example_data" {
            Ok("expected_output".to_string())
        } else {
            Err("Invalid input".to_string())
        }
    }
}

// 注册测试模块
#[cfg(test)]
mod tests {
    use super::*;
    
    #[test]
    fn test_example_module() {
        let module = ExampleWasmModule;
        let test_data = TestData::new("example_data".to_string());
        
        assert_eq!(module.execute(test_data).unwrap(), "expected_output");
    }
}

完整示例代码

以下是一个更完整的示例，展示如何使用holochain_test_wasm_common进行更复杂的WASM测试：

// 在Cargo.toml中添加依赖项：
// [dependencies]
// holochain_test_wasm_common = "0.5.4"

use holochain_test_wasm_common::*;

// 定义自定义WASM模块
struct AdvancedWasmModule {
    config: ModuleConfig,
}

impl AdvancedWasmModule {
    pub fn new(config: ModuleConfig) -> Self {
        Self { config }
    }
}

impl WasmModule for AdvancedWasmModule {
    fn execute(&self, input: TestData) -> Result<String, String> {
        // 根据配置处理输入
        match self.config.mode {
            ProcessingMode::Simple => Ok(input.data),
            ProcessingMode::Complex => {
                if input.data.len() > self.config.max_length {
                    Err("Input too long".to_string())
                } else {
                    Ok(input.data.chars().rev().collect())
                }
            }
        }
    }
}

// 定义模块配置
#[derive(Debug, Clone)]
struct ModuleConfig {
    mode: ProcessingMode,
    max_length: usize,
}

#[derive(Debug, Clone)]
enum ProcessingMode {
    Simple,
    Complex,
}

// 主测试模块
#[cfg(test)]
mod tests {
    use super::*;
    
    #[test]
    fn test_simple_mode() {
        let config = ModuleConfig {
            mode: ProcessingMode::Simple,
            max_length: 10,
        };
        let module = AdvancedWasmModule::new(config);
        let test_data = TestData::new("hello".to_string());
        
        assert_eq!(module.execute(test_data).unwrap(), "hello");
    }
    
    #[test]
    fn test_complex_mode() {
        let config = ModuleConfig {
            mode: ProcessingMode::Complex,
            max_length: 5,
        };
        let module = AdvancedWasmModule::new(config);
        
        // 测试正常输入
        let test_data1 = TestData::new("abc".to_string());
        assert_eq!(module.execute(test_data1).unwrap(), "cba");
        
        // 测试超长输入
        let test_data2 = TestData::new("too_long".to_string());
        assert!(module.execute(test_data2).is_err());
    }
    
    #[test]
    fn test_environment() {
        let mut test_env = TestEnvironment::new();
        
        // 注册模块
        let config = ModuleConfig {
            mode: ProcessingMode::Complex,
            max_length: 10,
        };
        test_env.register_module("reverse_module", AdvancedWasmModule::new(config));
        
        // 测试模块
        let test_data = TestData::new("holochain".to_string());
        let result = test_env.execute_wasm("reverse_module", test_data);
        
        assert!(result.is_ok());
        assert_eq!(result.unwrap(), "niahcoloh");
        
        test_env.cleanup();
    }
}

这个更完整的示例展示了：

1. 如何创建自定义的WASM模块实现
2. 如何添加模块配置参数
3. 不同处理模式的实现
4. 更全面的测试用例
5. 测试环境的注册和使用方法