edit[[PageOutline]]
= 概要 =
== これは一体何？ ==
本プロジェクト成果物は、Ruby の minitest モジュールによるテストを使った継続的インテグレーションをサポートします。
一言で言うと '''minitest のテスト結果を可視化する Ruby CGI''' です。
----
== スクリーンショット ==
=== テスト結果画面 ===
[[Embed(screenshot1.png)]]
----
=== エラーレポート画面 ===
[[Embed(screenshot2.png)]]
----
= 提供する物 =
== 提供物と基本的な使い方 ==
本プロジェクトが提供するものは以下の２つです。
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 メソッドがない！？（パート２）]
----
= 備考 =
本プロジェクトは mail2weblog([http://sourceforge.jp/projects/mail2weblog/]) の派生成果物です。
mail2weblog([http://sourceforge.jp/projects/mail2weblog/]) で継続的インテグレーションを行っています。
環境は HYCE.ORG([http://www.hyec.org/]) という無料のレンタルサーバを利用しています。
その他にも
* VlexoFree([http://vlexofree.com/])
** 無料海外サーバ（英語）
* ロリポップ！レンタルサーバ([http://lolipop.jp/])
** 有料レンタルサーバ（格安）
* SourceForge.JP([http://sourceforge.jp/]) 自体
** 無料
などにも cron の環境があるはずです。
VlexoFree は現在利用申請中で、利用が可能になれば試してみようと思っています。
ロリポップ！レンタルサーバでの動作実績はあります。
しかし、cron の実行時間に 5 分という制限時間があるためテストが 5 分以内で終わるものに利用が限定されます。
SourceForge.JP では Web と cron の実行が可能な Shell の環境が異なるという情報があるので Shell サーバから Web サーバへ実行結果の転送を行う FTP スクリプトが別途必要になりそうな気がしています。
SourceForge.JP で試したことはありません。
もしも、試した人が現れれば情報をくださると嬉しいです。