Ruby 1.8.7 リファレンスマニュアル > ライブラリ一覧 > test/unit/autorunnerライブラリ > Test::Unit::AutoRunnerクラス

class Test::Unit::AutoRunner

クラスの継承リスト: Test::Unit::AutoRunner < Object < Kernel

要約

テストの実行を操作したいときにこの AutoRunner クラスを使います。大量のテストの中から特定のテストスクリプトのみを実行したい場合、特定のテストクラスのみを実行したい場合などに使います。 AutoRunner は Collector::Dir オブジェクトなどの Collector にテストを集めさせて、UI::Console::TestRunner オブジェクトなどの Runner にテストを実行させているクラスです。

例

ディレクトリ ./somedir 以下にある全てのテストを実行したい場合は次のようなファイル(runner.rb)を用意して実行します。テストは test_*.rb というファイル名である必要があります。

第一引数に true を与えると、./somedir 以下にある全てのテストを実行します。

require 'test/unit'
Test::Unit::AutoRunner.run(true, './somedir')

単に実行します。

$ ruby runner.rb

ディレクトリ ./somedir 以下にあるテストをファイル somefile を除いて実行したい場合は次のように runner.rb にオプションを与えます。

$ ruby runner.rb --exclude=somefile

同じことは、runner.rb に直接オプションを書いても実現できます。

require 'test/unit'
Test::Unit::AutoRunner.run(true, './somedir', ['--exclude=somefile'])

上のやり方では拡張子が .rb のファイルしか集めません。拡張子が .rbx のファイルもテストとして集めたい場合は次のようにします。

require 'test/unit'
Test::Unit::AutoRunner.run(true, './somedir', ['--pattern=/test_.*\.rbx\Z/'])

特異メソッド

run(force_standalone = false, dir = '.', argv = ARGV) -> bool[permalink][rdoc]

テストを実行します。全てのテストが成功した場合、true を返します。そうでない場合は、 false を返します。

[PARAM] force_standalone:: true を与えると、dir 以下にある全てのテストを実行します。false を与えた場合は既に読み込まれたファイルの中からテストを探して実行します。テストが読み込まれておらず、スクリプトを -e から実行している場合は、dir 以下にある全てのテストを実行します。デフォルトは false です。
[PARAM] dir:: force_standalone に true を与えた時に再帰的に探査するディレクトリ名を与えます。デフォルトではカレントディレクトリを再帰的に探査します。
[PARAM] argv:: オプションを配列として与えます。解釈するオプションは先に出てきたものと同じです。

-r, --runner=RUNNER              Use the given RUNNER.
                                 (c[onsole], f[ox], g[tk], g[tk]2, t[k])
-b, --basedir=DIR                Base directory of test suites.
-w, --workdir=DIR                Working directory to run tests.
-n, --name=NAME                  Runs tests matching NAME.
                                 (patterns may be used).
-t, --testcase=TESTCASE          Runs tests in TestCases matching TESTCASE.
                                 (patterns may be used).
-v, --verbose=[LEVEL]            Set the output level (default is verbose).
                                 (s[ilent], p[rogress], n[ormal], v[erbose])
    --                           Stop processing options so that the
                                 remaining options will be passed to the
                                 test.
-h, --help                       Display this help.

force_standalone に false を与えた時には次のオプションが追加されます。

-a, --add=TORUN                  Add TORUN to the list of things to run;
                                 can be a file or a directory.
-p, --pattern=PATTERN            Match files to collect against PATTERN.
-x, --exclude=PATTERN            Ignore files to collect against PATTERN.

例

require 'test/unit'
Test::Unit::AutoRunner.run(true, './', ['--runner=tk', '-v',
                                        '--exclude=/test_hoge.*\.rb\Z/i'])

argv にデフォルトのまま ARGV を渡しておけばコマンドラインからオプションを指定できます。

require 'test/unit'
Test::Unit::AutoRunner.run(true, './')

と、runner.rb に書いておいて、コマンドラインから以下のように実行。

$ ruby runner.rb --runner=tk -v --exclude=/test_hoge.\*\\.rb\\Z/i

class Test::Unit::AutoRunner

要約

例

目次

特異メソッド