单元测试类中的断言困境

Question

我想在我的单元测试框架中使用 PHP 的断言函数。它的优点是能够在错误消息中看到正在计算的表达式（包括注释）。

问题是每个包含测试的方法可能有多个断言语句，我想跟踪已经运行了多少个实际的断言语句。断言没有给我一种方法来计算它已经运行了多少次，只计算它失败了多少次（在失败回调中）。

我尝试将assert语句抽象成一个函数，这样我就可以添加计数机制。

private function assertTrue($expression) {
    $this->testCount++;
    assert($expression);
}

然而，这不起作用，因为表达式内的任何变量现在都超出了范围。

$var = true;
$this->assertTrue('$var == true'); // fails

关于如何在单元测试中使用断言同时能够计算实际测试的数量有什么建议吗？

我提出的两个想法是让用户自己计数

$this->testCount++;
assert('$foo');
$this->testCount++;
assert('$bar');

或让用户在每个测试方法中只放置一个断言（然后我可以计算运行的方法的数量）。但这些解决方案都不是非常可执行，并且使编码变得更加困难。关于如何实现这一目标有什么想法吗？或者我应该从我的测试框架中删除assert()？

Answer 1

在 PHPUnit 中，所有 assert*() 方法都带有一个额外的 $message 参数，您可以利用该参数：

$this->assertTrue($var, 'Expected $var to be true.');

如果断言失败，则输出消息测试后报告中的失败。

这通常比输出实际表达式更有用，因为这样您就可以评论失败的重要性：

$this->assertTrue($var, 'Expected result of x to be true when y and z.');

Answer 2

这里的答案有点厚颜无耻，但是打开 vim 并输入：（

:%s/assert(\(.+\));/assert(\1) ? $assertSuccesses++ : $assertFailures++;/g

原则上，用 assert() 替换所有 assert() 调用？ $success++ : $fail++;）

更严重的是，提供一种对测试进行计数的机制确实超出了 assert() 函数的范围。大概您希望将其用于“X/Y 测试成功”类型指示器。您应该在测试框架中执行此操作，记录每个测试的内容、其结果以及任何其他调试信息。

Answer 3

您受到以下事实的限制：assert() 必须在您正在测试的变量所在的同一范围内调用。据我所知，剩下的解决方案需要额外的代码，在运行时修改源代码（预处理），或者在 C 级别扩展 PHP 的解决方案。这是我提出的解决方案，涉及额外的代码。

class UnitTest {
    // controller that runs the tests
    public function runTests() {
        // the unit test is called, creating a new variable holder
        // and passing it to the unit test.
        $this->testAbc($this->newVarScope());
    }

    // keeps an active reference to the variable holder
    private $var_scope;

    // refreshes and returns the variable holder
    private function newVarScope() {
        $this->var_scope = new stdClass;
        return $this->var_scope;
    }

    // number of times $this->assert was called
    public $assert_count = 0;

    // our assert wrapper
    private function assert($__expr) {
        ++$this->assert_count;
        extract(get_object_vars($this->var_scope));
        assert($__expr);
    }

    // an example unit test
    private function testAbc($v) {
        $v->foo = true;
        $this->assert('$foo == true');
    }
}

这种方法的缺点：单元测试中使用的所有变量都必须声明为 $v->* 而不是 $*，而在断言语句中写入的变量仍然被写入如$*。其次，assert() 发出的警告不会报告调用 $this->assert() 的行号。

为了获得更高的一致性，您可以将assert()方法移至变量持有者类，这样您就可以考虑在测试台上运行的每个单元测试，而不是进行某种神奇的断言调用。

Answer 4

这不是单元测试的东西的目的是（记住它起源于编译语言）。
PHP 的语义对您想要做的事情也没有多大帮助。

但是您仍然可以通过一些语法开销来完成它：

 assert('$what == "ever"') and $your->assertCount();

甚至：

 $this->assertCount(assert('...'));

要获取成功条件的断言字符串，您只能使用 < code>debug_backtrace 和一些启发式字符串提取。

这也没有太多强制执行（缺少在测试脚本上运行预编译器/正则表达式）。但我会从好的方面来看待这个问题：并不是每一项检查都足够重要，值得记录。因此，包装方法允许选择退出。

Answer 5

如果不知道你的框架是如何构建的，很难给出答案，但我会尝试一下。

您可以使用 PHP 的神奇方法 __call()。使用这个，你可以在每次调用assertTrue()方法时增加一个内部计数器。实际上，每次调用任何方法时，您都可以做任何您想做的事情。
请记住，如果您尝试调用不存在的方法，则会调用 __call()。因此，您必须更改所有方法名称，并从 __call() 内部调用它们。例如，您有一个名为 fAssertTrue() 的方法，但单元测试类将使用 assertTrue()。因此，由于未定义assertTrue()，因此将调用__call()方法，然后调用fAssertTrue()。

Answer 6

既然你已经传递了表达式（这可能会导致引用地狱，如果我错了，请纠正我）：

$this->assertTrue('$var == true'); // fails with asset($expression);

为什么不添加一点额外的复杂性，并通过使用闭包来避免引用地狱呢？

$this->assertTrue(function() use ($var) {
  return $var == true;
}); // succeeds with asset($expression());

Answer 7

简单：（

$this->assertTrue($var == true);

不带引号！）

它将在调用者空间中进行评估，因此assertTrue() 将仅传递 false 或 true。

正如其他人指出的那样，这可能不是最好的测试方法，但这完全是另一个问题......；）