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

Question

因此，我最近使用FitNesse＆amp; amp;等工具开始进行规格和测试。斯波克。

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

话虽如此，我更喜欢的一件事是FitNesse的wiki风格的文档功能。它为这些规范测试提供了代码和文档。

Spock中是否有办法（带插件？/开箱即用？）生成任何类型的人类可读文档，以向项目经理/利益相关者展示？

Answer 1

好吧，我在测试中使用了描述每个Sp​​ock块的字符串来生成HTML报告。 请访问我的项目，如果有帮助请告诉我：

https://github.com/renatoathaydes/spock-reports

您可以从reports目录下载jar，然后将其添加到类路径中。运行您的测试，“奇迹般地”您将在目录build/spock-reports生成报告！

如果您想自定义报告，您甚至可以提供自己的CSS样式表，如README中所述。

Here's a blogpost我写了关于写这个Spock扩展的文章。

<强>更新

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

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

https://github.com/spockframework/spock-uberconf-2011/blob/master/src/test/groovy/extension/custom/ReportExtension.groovy

Answer 3

这里已经有了一些很好的答案，但是如果你想保持你的BDD定义不受任何管道的影响，你可以看一下pease，这将允许你使用Spock的Gherkin规范语言。