Spock可以提供人类可读的文档吗？

Question

所以我最近使用FitNesse和Spock等工具进行了规范和测试.

我第一次尝试FitNesse,这是一次又一次无证件的挑战.幸运的是,我绊倒了Spock,很快就爱上了它.

话虽如此,我首选的一件事是FitNesse的wiki风格的文档功能.它为这些规范测试提供了代码和文档.

Spock中是否有一种方法(使用插件？/开箱即用？)生成任何类型的人类可读文档,以向项目经理/利益相关者展示？

Answer 1

好吧,我在测试中使用了描述每个Spock块的字符串来生成HTML报告.请访问我的项目,如果有帮助请告诉我:

您可以从reports目录下载jar ,然后将其添加到类路径中.运行您的测试,并"奇迹般地"您将在目录中生成报告build/spock-reports!

如果要自定义报告,甚至可以提供自己的CSS样式表,如README中所述.

这是我写的关于编写Spock扩展的博客文章.

UPDATE

spock-reports现在已经在Maven Central上提供了一段时间,还有JCenter.

Answer 2

Spock允许您向块添加描述，例如：

when: "5 dollars are withdrawn from the account"
account.withdraw(5)

then: "3 dollars remain"
account.balance == 3

虽然我们尚未使用此信息，但可以通过扩展轻松访问（请参阅下面的链接）。剩下要做的就是把它变成一份漂亮的报告。