stubby - 无伤害的 stubbing

一个连 IDE 都能理解的微型 stubbing 库！

为什么使用 stub？

来自 维基百科

在单元测试中，模拟对象可以模拟复杂、真实对象的行为，因此当无法将真实对象纳入单元测试时非常有用。如果对象具有以下任何特征，则可能需要使用模拟对象

• 对象提供非确定性结果（例如当前时间或当前温度）；
• 具有难以创建或再现的状态（例如网络错误）；
• 运行缓慢（例如完整数据库，测试前需要准备）；
• 尚不存在或可能改变行为；
• 需要包含仅用于测试目的的信息和方法（而不是其实际任务）。

使用示例

您可以使用 cargo add stubby，或者在您的 Cargo.toml 中

[dependencies]
stubby = "0.3"

注意，stubby 必须放入您的常规依赖项，而不是开发依赖项。

现在，一些使用 stubby 的代码

use stubby::*;

struct TestStruct(StubbyState);

impl TestStruct {
    fn foo(&self) -> i32 {
        stub!(&self.0);
        10
    }
}

fn main() {
    let ts = TestStruct(StubbyState::default());
    assert_eq!(ts.foo(), 10);
}

#[test]
fn demo() {
    let mut mock = StubbyState::default();
    mock.insert(fn_name!(TestStruct::foo), 15);
    let ts = TestStruct(mock);
    assert_eq!(ts.foo(), 15);
}

Rust 中的模拟/stubbing 为什么如此困难？（与 mockall 的比较）

Rust 中的模拟困难是因为强类型和编译成机器码不提供任何灵活性来处理数据/行为，就像您在鸭子类型语言或具有某种解释器的语言中那样。

因此，在Rust中使用模拟库的常见方法是通过使用过程宏生成一个新的MockFoo，该宏从你的implFoo块生成，该块具有额外的功能，允许你自定义返回类型和进行复杂的操作。然后，在编译时，你可以选择使用#[cfg(not(test))]use lib::Foo或#[cfg(test)]use lib::MockFoo as Foo，这是可行的，因为生成的MockFoo提供了与真实Foo相同的所有方法。然而，由于Rust Analyzer和Jetbrains IDEs的Rust插件，这些编译时条件导入完全破坏了自动完成、类型提示，有时甚至语法高亮。此外，即使你不使用条件导入，宏展开在自动完成/预测方面的支持也往往较差，尤其是在处理非常复杂的生成类型时。这意味着虽然你的模拟在运行时没有开销，但在最重要的阶段——开发时，它却有很大的开销。