組み込みのアサーションのように動作するカスタムPHPUnitアサーションを作成するには？

Question

assertFoo($expected, $actual)のようなカスタムアサーションを作成するにはどうしたらよいですか？エラーは「スタックトレース」に関して組み込みのアサーションのように振る舞いますか？

私は現在、（PHPUnit_Framework_TestCaseを拡張するクラス内）が定義され、以下の方法があります。

：私はテストからこれを呼び出すと、テストが失敗した場合、私は、コールスタック内の2つのアイテムを取得

public static function assertFoo($expected, $actual) { 
    self::assertEquals($expected, $actual); 
} 

を

1) PreferencesTest::testSignupTeacher 
Failed asserting that 5 matches expected 3. 

/vagrant/myproject/tests/integration/PreferencesTest.php:17 
/vagrant/myproject/tests/integration/PreferencesTest.php:136 

ここで、assertFoo()は組み込みのassertEquals()を呼び出して失敗します。 136行目にはassertFoo()が呼び出されています。

私が直接assertEquals()を呼び出すためのテストを変更した場合、私は一つだけを得る：

1) PreferencesTest::testSignupTeacher 
Failed asserting that 3 is true. 

/vagrant/myproject/tests/integration/PreferencesTest.php:136 

一部documentation in the manualがありますが、これをカバーしていないようです。

Answer 1

私が最初に（PHPUnit_Framework_Constraint_*のオブジェクトとself::assertThatのいずれかを使用していない）という推測は完全に無関係であることが判明しました。実際の答えは、phpUnitがスタックトレースから何かを自分のコードベースの中でフィルタリングして、ユーザ空間に関数を残すことです。

これは（/パス/に/は自分のマシン上を/ usr/share/PHPある）/path/to/PHPUnit/Util/Filter.phpで見つけることができないコードと関心のある機能はgetFilteredStacktraceとisFilteredです。

この動作を制御したい場合は、カスタムアサートをPHPUnit_Framework_TestCaseから派生したクラスに入れて、そのクラスからテストを引き出します。あなたが持っている別のファイルに続いて

class My_Base_TestCase extends PHPUnit_Framework_TestCase{ 
    public static function assertFoo($expected, $actual) { 
    self::assertEquals($expected, $actual); 
    } 
} 

PHPUnit_Util_Filter::addFileToFilter(__FILE__, 'DEFAULT'); 

を：ここに示すように、カスタムクラスファイルでは、どこかaddFileToFilterへの呼び出しを入れ

class CustomTest extends My_Base_TestCase{ 

    /** */ 
    public function testSomething2(){ 
    $this->assertFoo(8, 5+4); 
    } 
} 

、それだけで、内蔵assertEquals()のように動作します。

免責事項：これは文書化されていない動作を使用しています。私は、このメカニズムが将来的に合理的であるかどうかを試してみるつもりです。