应明确告知用户何时停止使用生成器。此补丁提供了易于停止使用生成器的辅助工具。
def-throwing-generator 接收生成器被调用时会抛出的元数据。例如,假设 deprecated-generator 在 0.5.9 中被停止使用。
(def-throwing-generator deprecated-generator
"deprecated-generator 已被弃用。请使用 current-generator。"
{:deprecated "0.5.9"})
然后,如果用户查看其文档,会从 cider 看到以下信息
clojure.test.check.generators/deprecated-generator
自 0.5.9 被弃用
deprecated-generator 已被弃用。请使用 current-generator。
或者如果他们使用了生成器并运行 cider-test,他们则会看到
测试摘要
foobar.core-test
运行 1 个测试,在 1 个测试函数中
1 个错误
结果
在 a-test 中发生错误
FIXME,我失败了。
预期: (= "a" (sample deprecated-generator 5))
实际: clojure.lang.ExceptionInfo: deprecated-generator 已被弃用。请使用 current-generator。{:deprecated "0.5.9"}