[[PageOutline]]
= 概要 =
== これは一体何? ==
本プロジェクト成果物は、Ruby の minitest モジュールによるテストを使った継続的インテグレーションをサポートします。
一言で言うと '''minitest のテスト結果を可視化する Ruby CGI''' です。
----
== スクリーンショット ==
=== テスト結果画面 ===
[[Embed(screenshot1.png)]]
----
=== エラーレポート画面 ===
[[Embed(screenshot2.png)]]
----
= 提供する物 =
== 提供物と基本的な使い方 ==
本プロジェクトが提供するものは以下の2つです。
1. minitest テストの一括実行を行うスクリプト(run/run_all_tests.rb)
2. 1. の結果を可視化する Ruby CGI スクリプト(view/view_testresult.rb)
通常の使い方は以下の通りです。
* 1. のテスト実行スクリプトで minitest の一括実行を行い、結果をテキストに出力する。
* 本スクリプトは、設定ファイルで指定したパターンに合致する全ての minitest スクリプトを一括実行します。
* また、可視化に必要な情報を付加してテキストファイルに出力します。
* 2. のテスト結果表示 CGI スクリプトでテスト結果を可視化する。
* 1. のテキストファイルを入力として、可視化を行います。
* ※ 使い方の詳細は執筆中です…。
----
== 前提 ==
本スクリプトは cgi モジュールのみを使った単純なスクリプトです。
Ruby on Rails 等の環境は必要としません。
逆に言うと minitest による単体テストのみサポートします。少なくとも現時点ではそうです。
* Ruby 1.9 以上をサポートします。
* Ruby 1.8 はサポートしません。
* String#encode メソッドを利用しているためで以下の記事を参考にすれば動くかもしれません。
* [http://www.ownway.info/Blog/2011/06/ruby-182-stringencode-1.html Ruby 1.8.2 には String.encode メソッドがない!?(パート2)]
----
= 備考 =
本プロジェクトは、下記プロジェクトの派生成果物です。
[[Embed(mail2weblog.png)]]
* [http://sourceforge.jp/projects/mail2weblog/ mail2weblog(高機能メール投稿型モブログ)]
以下、実際の利用事例です。
* [http://www.hyec.org/~toydev/cgi-bin/m2w_test/index.cgi mail2weblog(高機能メール投稿型モブログ)のテスト結果]
[http://sourceforge.jp/projects/mail2weblog/ mail2weblog(高機能メール投稿型モブログ)]は、
複数種類のブログへの投稿に対応するためテストの自動化を推進しています。
効率的にテストを行い、問題を解決するためにこのような可視化を行なっています。
ちなみに minitest 継続的インテグレーションベースは、上記利用事例の「テスト詳細」リンク以降の部分になります。
[http://sourceforge.jp/projects/mail2weblog/ mail2weblog(高機能メール投稿型モブログ)]では、ブログの種別毎に minitest 継続的インテグレーションベースを利用し、テスト実行およびテスト結果の可視化を行なっています。
複数テスト環境の構築に興味がある方は、[mailto:toy@ownway.info トゥイー宛までメール]をどうぞ。
----