Rust通用测试框架generic-tests使用指南

概述

generic-tests是一个Rust测试框架，专注于简化多场景单元测试和集成测试的编写与运行。它通过泛型和宏提供了强大的测试组织能力，特别适合需要针对不同类型或多种输入参数运行相同测试逻辑的场景。

主要特性

• 支持参数化测试（同一测试用例运行多组输入）
• 简化测试组织和管理
• 提供清晰的测试报告输出
• 支持单元测试和集成测试
• 与标准cargo test命令无缝集成

安装

在Cargo.toml中添加依赖：

[dev-dependencies]
generic-tests = "0.3"

基本使用方法

1. 简单测试示例

use generic_tests::test_case;

#[test_case]
fn test_addition() {
    assert_eq!(2 + 2, 4);
}

2. 参数化测试

use generic_tests::{test_case, test_matrix};

#[test_matrix(
    [(2, 2, 4), (3, 5, 8), (10, -2, 8)]
)]
fn test_addition(a: i32, b: i32, expected: i32) {
    assert_eq!(a + b, expected);
}

3. 泛型测试

use generic_tests::{test_case, generic_test};

trait Addable: std::ops::Add<Output = Self> + Sized + PartialEq + Copy {}
impl<T: std::ops::Add<Output = T> + PartialEq + Copy> Addable for T {}

#[generic_test]
fn test_generic_addition<T: Addable>(a: T, b: T, expected: T) {
    assert_eq!(a + b, expected);
}

// 为不同类型实例化测试
test_generic_addition!(i32: (2, 2, 4));
test_generic_addition!(f64: (2.5, 3.5, 6.0));

4. 集成测试

在tests/目录下创建集成测试文件：

// tests/integration_test.rs
use generic_tests::test_case;
use my_crate::some_function;

#[test_case]
fn test_some_function() {
    assert!(some_function().is_ok());
}

高级用法

1. 测试前后设置

use generic_tests::{test_case, setup, teardown};

#[setup]
fn setup() {
    // 测试前的初始化代码
    println!("Setting up test");
}

#[teardown]
fn teardown() {
    // 测试后的清理代码
    println!("Tearing down test");
}

#[test_case]
fn test_with_setup() {
    // 这个测试会自动运行setup和teardown
    assert!(true);
}

2. 异步测试

use generic_tests::{test_case, async_test_case};

#[async_test_case]
async fn test_async_function() {
    let result = some_async_function().await;
    assert!(result.is_ok());
}

3. 测试过滤

运行特定测试：

cargo test test_addition  # 运行名称包含"test_addition"的测试

最佳实践

1. 为每个功能模块创建对应的测试模块
2. 使用参数化测试减少重复代码
3. 将复杂测试分解为多个小测试
4. 为测试使用有意义的名称
5. 在集成测试中模拟真实使用场景

与标准测试框架对比

generic-tests在标准#[test]属性基础上增加了：

• 更简洁的参数化测试语法
• 内置泛型测试支持
• 更好的测试组织能力
• 更丰富的测试生命周期控制

但仍完全兼容标准测试框架的所有功能。

性能考虑

generic-tests在编译时会展开所有测试用例，运行时性能与标准测试框架相同。大量参数化测试可能会增加编译时间，但不会影响测试执行性能。

完整示例demo

下面是一个完整的示例，展示了如何使用generic-tests框架进行不同类型的测试：

// tests/example_tests.rs
use generic_tests::{test_case, test_matrix, generic_test, setup, teardown, async_test_case};

// 1. 简单测试示例
#[test_case]
fn test_simple_addition() {
    assert_eq!(2 + 2, 4);
}

// 2. 参数化测试
#[test_matrix(
    [(2, 2, 4), (3, 5, 8), (10, -2, 8)]
)]
fn test_parametrized_addition(a: i32, b: i32, expected: i32) {
    assert_eq!(a + b, expected);
}

// 3. 泛型测试
trait Addable: std::ops::Add<Output = Self> + Sized + PartialEq + Copy {}
impl<T: std::ops::Add<Output = T> + PartialEq + Copy> Addable for T {}

#[generic_test]
fn test_generic_add<T: Addable>(a: T, b: T, expected: T) {
    assert_eq!(a + b, expected);
}

test_generic_add!(i32: (2, 2, 4));
test_generic_add!(f64: (2.5, 3.5, 6.0));

// 4. 测试前后设置
#[setup]
fn global_setup() {
    println!("全局测试设置");
}

#[teardown]
fn global_teardown() {
    println!("全局测试清理");
}

#[test_case]
fn test_with_global_setup() {
    println!("运行测试");
    assert!(true);
}

// 5. 异步测试
#[async_test_case]
async fn test_async_operation() {
    async fn mock_async_fn() -> Result<(), &'static str> {
        Ok(())
    }
    
    let result = mock_async_fn().await;
    assert!(result.is_ok());
}

// 6. 模块内测试设置
mod module_tests {
    use super::*;
    
    #[setup]
    fn module_setup() {
        println!("模块测试设置");
    }
    
    #[teardown]
    fn module_teardown() {
        println!("模块测试清理");
    }
    
    #[test_case]
    fn test_with_module_setup() {
        println!("运行模块测试");
        assert!(true);
    }
}

这个完整示例展示了：

1. 基本测试用例
2. 参数化测试
3. 泛型测试
4. 全局测试设置和清理
5. 异步测试支持
6. 模块级别的测试设置

要运行这些测试，只需执行常规的cargo test命令：

cargo test

或者运行特定测试：

cargo test test_simple_addition