backtesting.py 项目中 functools.partial 对象属性缺失问题解析

在 backtesting.py 0.6.2 版本中，用户在使用 Python 3.9.15 运行回测时遇到了一个 AttributeError 异常。这个问题的根源在于代码中对 functools.partial 对象的属性检查不够严谨。

问题现象

当用户尝试从 backtesting 模块导入 Strategy 类时，程序抛出了 AttributeError，提示 'functools.partial' 对象没有 'module' 属性。这个错误发生在 backtesting.py 文件的 all 列表生成过程中。

技术分析

在 Python 中，functools.partial 是一个高阶函数，它用于部分应用一个函数，固定某些参数并返回一个新的可调用对象。然而，partial 对象与普通函数不同，它并不自动继承原函数的所有属性，特别是 module 属性。

backtesting.py 的原始代码中直接尝试访问 v.module 属性，而没有先检查该属性是否存在。这在处理普通函数时没有问题，但当遇到 partial 对象时就会抛出异常。

解决方案

社区贡献者提出了一个稳健的解决方案：在访问 module 属性前，先使用 hasattr() 函数进行检查。修改后的代码如下：

__all__ = [getattr(v, '__name__', k)
           for k, v in globals().items()
           if ((callable(v) and (hasattr(v, '__module__') and v.__module__ == __name__) or
                k.isupper()) and
               not getattr(v, '__name__', k).startswith('_'))]

这个修改确保了代码在处理 partial 对象时更加健壮，同时也保持了原有的功能逻辑。

版本兼容性建议

虽然这个问题已经在 master 分支中修复，但值得注意的是，Python 3.9 已经接近其生命周期终点。建议用户考虑升级到更高版本的 Python（如 3.10 或 3.12），以获得更好的性能、安全性和语言特性支持。

总结

这个案例展示了在编写 Python 库时需要考虑的各种边界情况。特别是当处理可调用对象时，不能假设所有可调用对象都具有相同的属性集。通过添加属性存在性检查，可以大大提高代码的健壮性和兼容性。