ozh/phpunit-overassertive

Find over assertive tests in your PHPUnit test suite

dev-master 2020-03-25 13:08 UTC

This package is auto-updated.

Last update: 2024-12-09 20:29:55 UTC


README

Having several assertions in the same test is fine, but when an assertion fails, the whole test aborts and other assertions in the same test are not tested.

Depending on what you test and how you coded it, you may want to split some tests in several sub tests.

OverAssertive is a PHPUnit extension that reports right in the console which tests have "too many" assertions, where "too many" is what you define, to help you inspect and maybe refactor some tests.

overassertive

Usage

Enable it with all defaults by adding the following to your test suite's phpunit.xml file:

<phpunit bootstrap="vendor/autoload.php">
...
    <listeners>
        <listener class="Ozh\PHPUnit\Listener\OverAssertiveTestsListener" />
    </listeners>
</phpunit>

If you're not using an autoloader you can also specify the library location:

<phpunit bootstrap="boostrap.php">
...
    <listeners>
        <listener class="Ozh\PHPUnit\Listener\OverAssertiveTestsListener" file="/path/to/OverAssertiveTestsListener.php" />
    </listeners>
</phpunit>

Now run your test suite as normal. OverAssertive will report over assertive tests in the console after the suite completes.

Configuration

OverAssertive has two configurable parameters:

  • alertThreshold - Number of assertions that will make a test over assertive (default: 10 assertions)
  • reportLength - Number of over assertive tests included in the report (default: 10 tests)

These configuration parameters are set in phpunit.xml when adding the listener:

<phpunit ...>
    <!-- ... other suite configuration here ... -->

    <listeners>
        <listener class="Ozh\PHPUnit\Listener\OverAssertiveTestsListener">
            <arguments>
                <array>
                    <element key="alertThreshold">
                        <integer>10</integer>
                    </element>
                    <element key="reportLength">
                        <integer>10</integer>
                    </element>
                </array>
            </arguments>
        </listener>
    </listeners>
</phpunit>

Inspiration

Much thanks to phpunit-speedtrap

License

Do whatever the hell you want to.