2011-08-03 8 views
7

私は最近、FitNesse & Spockなどのツールを使用して仕様とテストに目を向けました。人間が読める文書はSpockで可能ですか?

私はFitNesseで最初の刺し傷を負った。だから幸運にも私はSpockの上に乗ってきて、それと恋に落ちました。

私が好まれたことの1つは、FitNesseのwikiスタイルのドキュメント機能でした。これらの仕様テストには、コードとドキュメントの両方が用意されていました。

プロジェクトマネージャー/ステークホルダーに誇示するために、あらゆるタイプの人間が読めるドキュメントを生成する方法はありますか(プラグインは?/すぐに使用できますか?

答えて

3

スポックは、例えば、あなたがブロックに説明を追加することができます。:

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

+0

私はコメント機能を使用していて、どのように出力されたのか不思議でした。ありがとうピーター! –

+0

NFJSがあなたが持っていたpps添付ファイルをダウンしたように見えます。私は、エクステンションとレポートの研究についていくつかの検索をします。あなたが提供する可能性のあるどんな情報も素晴らしいでしょう。再度、感謝します。 –

+0

私は上記にリンクしたGitHubリポジトリには、スライドを含む私の最新の話のすべての資料が含まれています。 –

9

まあ、私は、HTML形式のレポートを生成するために、あなたのテストで各スポックブロックを説明する文字列を使用しています。 私のプロジェクトを訪問し、それが助け場合は私に知らせてください:

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

あなたはreportsディレクトリからjarファイルをダウンロードして、ちょうどあなたのクラスパスに追加することができます。あなたのテストを実行し、ディレクトリ "build/spock-reports"で生成されたレポートを "奇跡的に"あなたは持っています!

READMEで説明したように、レポートをカスタマイズする場合は、独自のCSSスタイルシートを提供することもできます。

Here's a blogpostこのSpock拡張機能の書き方について書きました。

UPDATE

スポック-レポートJCenterだけでなく、今しばらくMaven Centralに利用されています。

+1

更新:jarをダウンロードする必要はありません。spock-reportsはJCenterから入手できます。 – Renato

+0

こんにちは、私はspockのレポートと一緒にコンソールのログを含める可能性があるのだろうかと思っていた。私は、次のときに展開ボタンのようなものを視覚化しています。タグ:展開すると、対応するコンソールログが表示されます。また、GITに実装して移動することが可能な場合は、これに貢献したいと思います。 –

+0

機能リクエストには[Github](https://github.com/renatoathaydes/spock-reports)を使用してください。 – Renato

0

ここではすばらしい答えがいくつかありますが、BDD定義に配管が全くないようにしたい場合は、peaseをご覧ください.Gherkin仕様言語をSpockで使用できます。

関連する問題