Pretend：让Python测试更简单

项目介绍

Pretend 是一个专为Python设计的库，它的目标是简化测试中的替代（stubbing）过程。这个库允许开发者创建简单的对象，这些对象可以返回预设的响应值，而无需进行任何实际计算。与复杂的替代工具不同，Pretend提供了一种直接、易懂的方式来编写和使用替代对象。

项目技术分析

在Pretend中，你可以通过调用stub函数来创建一个替代对象。例如：

from pretend import stub
x = stub(country_code="US")

上述代码会创建一个名为x的对象，它有一个属性country_code，其值为"US"。值得注意的是，x不会对其他任何未声明的属性或方法做出响应，也不会包含用于验证行为的方法。

如果你希望替代对象具备方法，只需传入一个函数即可：

x = stub(country_code=lambda: "US")
print(x.country_code())  # 输出: 'US'

此外，对于那些期望抛出异常的替代方法，Pretend提供了raiser辅助函数：

from pretend import stub, raiser
x = stub(func=raiser(ValueError))
x.func()  # 引发 ValueError 异常

项目及技术应用场景

Pretend主要适用于单元测试场景，帮助你在测试中控制外部依赖，使得测试更加关注你的代码如何处理特定输入，而非特定API的使用。你可以将替代对象作为参数传递给待测试的函数，以确保它们在预期条件下工作：

def test_something(x):
    result = some_function(x)
    assert result == expected_value

x = stub(country_code="US")  # 使用Pretend创建替代对象
test_something(x)

项目特点

• 简洁易用：Pretend的API设计简单直观，易于理解。
• 无副作用：替代对象仅返回预定义的值，不执行额外的计算。
• 灵活性：支持替代方法以及抛出异常的行为。
• 非侵入性：鼓励通过参数传递替代对象，而不是使用猴子补丁（monkey patching）。
• 记录调用历史：虽然不是默认功能，但提供了call_recorder来记录方法调用的历史。

安装也非常方便，只需要一行pip命令：

$ pip install pretend

如果你正在寻找一个既简单又强大的Python替代库，Pretend绝对值得尝试。它将使你的测试代码更加清晰，从而使整个开发流程更加顺畅。立即加入Pretend的世界，体验更优质的Python测试实践吧！