应在弃用生成器时向用户明确传达。此补丁提供易于弃用生成器的高级功能。
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,我失败了。
expected: (= "a" (sample deprecated-generator 5))
actual: clojure.lang.ExceptionInfo: deprecated-generator已被弃用。请使用current-generator。{:deprecated "0.5.9"}