thomasnordahldk/tester

An object oriented approach to testing for PHP.

thomasnordahldk/tester

, _(*1)

An object oriented approach to testing PHP code., _(*2)

Tester aims to be: easy to learn, light weight, object oriented, and extensible., _(*3)

Documentation here, _(*4)

Installation

The library is released as a composer package., _(*5)

composer require --dev thomasnordahldk/tester

Tests

Tests are defined by creating TestCase classes., _(*6)

class MyTestCase implements TestCase
{
    public function getDescription(): string
    {
        return "My new unit test";
    }

    public function run(Tester $tester): void
    {
        $tester->assert(true, "This assertion passes!");
        $tester->assert(false, "This assertion fails!");
    }
}

The test case is defined as a description of the test and a run test method., _(*7)

Docs: Creating a test case., _(*8)

Test suites

Tests suites are defined by the TestSuite class which is created with a description and an array of TestCase classes., _(*9)

$unit_tests = new TestSuite("Unit tests", [new UserUnitTest, AddressUnitTest]);

Docs: Test Suites., _(*10)

Running tests

The library comes with a native test runner that is run from the command line interface, and outputs a summary of the test., _(*11)

Which tests to run is defined in the file test.php in the root composer directory. The file is expected to return an array of test suites., _(*12)

# test.php
$unit_tests = new TestSuite("Unit tests", [new UserUnitTest, new AddressUnitTest]);

return [$unit_tests];

$composer-root/~ bin/tester

---------------------------------------------------------------------------
 - Unit tests - cases: 2
 --- Unit test of User ✔
 --- Unit test of Address ✔
---------------------------------------------------------------------------
success: 2, failure: 0, assertions: 8, time: 0.04s
---------------------------------------------------------------------------

For a comprehensive description of the options available for the native test runner script:, _(*13)

Docs: How to run tests., _(*14)

Inspiration

This library is inspired by the testing library mindplay-dk/testies., _(*15)