class Test::Unit::TestCase

要約

テストの基本単位(あるいは「テスト本体」)を表すクラスです。テストを行うメソッド(テストメソッド)は TestCase のサブクラスのインスタンスメソッドとして定義されます。テストメソッドの名前は「test」で始まっていなければなりません。逆に、「test」で始まっているメソッドは全てテストメソッドと見なされます。各テストメソッドは、Test::Unit::TestCase.suite により Test::Unit::TestSuite オブジェクトへとひとつにまとめられます。

require 'test/unit'
require 'test/unit/ui/console/testrunner'

class TC_String < Test::Unit::TestCase
  def test_size
    assert_equal('abc'.size, 3)
  end

  def test_concat
    assert_raise(TypeError) do
      'abc' + 1
    end
  end
end

suite = TC_String.suite
Test::Unit::UI::Console::TestRunner.run(suite)

各 TestCase オブジェクトは、ひとつのテストメソッドに対応しています。テストが実行される時には、テストメソッドの数だけ TestCase オブジェクトが生成されます。テストの実行時にはそれぞれの結果がTest::Unit::TestResultに集計されます。

目次

特異メソッド

• new
• suite

インスタンスメソッド

• default_test
• method_name
• name
• run
• setup
• size
• teardown

privateメソッド

• passed?

定数

• PASSTHROUGH_EXCEPTIONS

継承しているメソッド

Test::Unit::Assertionsから継承しているメソッド

• assert
• assert_block
• assert_equal
• assert_in_delta
• assert_instance_of
• assert_kind_of
• assert_match
• assert_nil
• assert_no_match
• assert_not_equal
• assert_not_nil
• assert_not_same
• assert_nothing_raised
• assert_nothing_thrown
• assert_operator
• assert_raise
• assert_raises
• assert_respond_to
• assert_same
• assert_send
• assert_throws
• build_message
• flunk

特異メソッド

new(test_method_name) -> Test::Unit::TestCase[permalink][rdoc]

このメソッドをユーザが直接呼ぶことはありません。

test_method_name に対応した TestCase オブジェクトを生成して返します。

[PARAM] test_method_name:

テストメソッドの名前を文字列で与えます。

suite -> Test::Unit::TestSuite[permalink][rdoc]

「test」ではじまるインスタンスメソッド全てに対して、それぞれに対応する TestCase オブジェクトを生成し、Test::Unit::TestSuite オブジェクトとしてまとめたものを返します。

「test」ではじまるインスタンスメソッドがない場合は、 Test::Unit::TestCase#default_test に対応づけされた TestCase オブジェクトのみを持つ、TestSuite オブジェクトを返します。

インスタンスメソッド

default_test -> ()[permalink][rdoc]

常に失敗するテストです。

method_name -> String[permalink][rdoc]

自身に対応しているテストメソッドの名前を文字列で返します。

Test::Unit::TestCase#setup や Test::Unit::TestCase#teardown において、実行する(あるいは、実行した)テストメソッドの名前を知るのに使うことができます。

name -> String[permalink][rdoc]

自身に対応しているテストメソッドの名前を人間が読みやすい形式で返します。

run(result) {|STARTED, name| ...}[permalink][rdoc]

このメソッドをユーザが直接呼ぶことはありません。

自身に対応したテストメソッドを実行して failures や errors を集計します。

[PARAM] result:

Test::Unit::TestResult オブジェクトを与えます。

setup -> ()[permalink][rdoc]

各テストメソッドが呼ばれる前に必ず呼ばれます。

size -> Integer[permalink][rdoc]

常に 1 を返します。

teardown -> ()[permalink][rdoc]

各テストメソッドが呼ばれた後に必ず呼ばれます。

privateメソッド

passed? -> bool[permalink][rdoc]

テストが成功したなら、true を返します。そうでないなら、false を返します。 Test::Unit::TestCase#teardown の中で使うことを意図されています。テスト実行前に何を返すかは不定です。

定数

PASSTHROUGH_EXCEPTIONS[permalink][rdoc]

Test::Unit::TestCase#run の実行時に rescue されない例外の一覧です。