SuperAPI AI 工具集

hegel-review

通用与其它

查看项目

更新于 10-16 05:54

技能介绍

用途:hegel-review 用于在编写属性测试之后进行质量审查,重点找出让属性测试变弱或产生误导的失败模式。它面向使用 hegel(或 proptest 等)写的基于属性的测试。

主要检查项:按清单逐条核对每个测试。窄化生成器——为了避开失败而收窄抽取域(缩小范围、过滤字符、在域而非物化阶段限制大小,或在失败后排除某类值,如次正规数、极小量级、精确边界),带不带注释都算;域应与契约一样宽。披着属性外衣的固定输入——所谓属性只见一个值或少数手工挑选的用例。缺少方向——解析器或校验器只测有效输入,或只检查无效输入“不崩溃”而未断言应被拒绝。一个测试含多个属性——互不相关的契约共用一个测试和同一个失败信号。无证据属性——断言没有任何文档或隐含依据的行为,或用实现本身复述代替契约。容差投机——把 epsilon 放宽到测试通过;契约本应精确时用近似相等。相等、顺序、哈希律、精确往返以及端点或恒等断言(比值 0 或 1 返回端点)属于精确契约;把失败归为“精度限制”,或在观察到失败后加容差且无记录将之锚定到契约,都属于此投机。弱化断言——只断言 is_ok()、只断言长度、或只断言“不 panic”,而实际值可廉价校验。should_panic 或被忽略的测试——存在 bug 时仍通过,或被排除在默认运行之外。配置参数被固定——构造器和配置项固定为默认值而非生成。未测变体——契约覆盖多种类型或变体时只实例化一种,或同一属性复制粘贴后出现漂移。静默分类残留——被注释掉的断言、删除的失败测试、掩盖红测试的 TODO。资源边界放错位置——递归深度或集合大小在抽取域而非物化阶段限制。

使用方式:写完后逐条对照以上清单审查;某项不通过时,引用有问题的代码,并给出能修复它的最小改动。

限制:资料未提供安装、运行命令、收费与平台等信息。