bafs/testify

Testify makes writing unit tests fun again. It has an elegant syntax and keeps things simple

v1.0 2016-03-14 11:52 UTC

Requires

• php: >=5.3.0

GPL-3.0

• framework
• testing
• unit

README

Testify is a micro unit testing framework for PHP 5.3+. It strives for elegance instead of feature bloat. Testing your code is no longer a chore - it's fun again.

Requirements

• PHP 5.3+ is required
• Composer to install Testify is recommended (but you can do this manually)

Usage

Here is an example for a test suite with two test cases:

require 'vendor/autoload.php';

use Math\MyCalc;
use Testify\Testify;

$tf = new Testify("MyCalc Test Suite");

$tf->beforeEach(function($tf) {
	$tf->data->calc = new MyCalc(10);
});

$tf->test("Testing the add() method", function($tf) {
	$calc = $tf->data->calc;

	$calc->add(4);
	$tf->assert($calc->result() == 14);

	$calc->add(-6);
	$tf->assertEquals($calc->result(), 8);
});

$tf->test("Testing the mul() method", function($tf) {
	$calc = $tf->data->calc;

	$calc->mul(1.5);
	$tf->assertEquals($calc->result(), 12);

	$calc->mul(-1);
	$tf->assertEquals($calc->result(), -12);
});

$tf();

Documentation

• __construct( string $title ) - The constructor
• test( string $name, [Closure $testCase = null] ) - Add a test case.
• before( Closure $callback ) - Executed once before the test cases are run
• after( Closure $callback ) - Executed once after the test cases are run
• beforeEach( Closure $callback ) - Executed for every test case, before it is run
• afterEach( Closure $callback ) - Executed for every test case, after it is run
• run( ) - Run all the tests and before / after functions. Calls report() to generate the HTML report page
• assert( boolean $arg, [string $message = ''] ) - Alias for assertTrue() method
• assertTrue( boolean $arg, [string $message = ''] ) - Passes if given a truthfull expression
• assertFalse( boolean $arg, [string $message = ''] ) - Passes if given a falsy expression
• assertEquals( mixed $arg1, mixed $arg2, string [string $message = ''] ) - Passes if $arg1 == $arg2
• assertNotEquals( mixed $arg1, mixed $arg2, string [string $message = ''] ) - Passes if $arg1 != $arg2
• assertSame( mixed $arg1, mixed $arg2, string [string $message = ''] ) - Passes if $arg1 === $arg2
• assertNotSame( mixed $arg1, mixed $arg2, string [string $message = ''] ) - Passes if $arg1 !== $arg2
• assertInArray( mixed $arg, array $arr, string [string $message = ''] ) - Passes if $arg is an element of $arr
• assertNotInArray( mixed $arg, array $arr, string [string $message = ''] ) - Passes if $arg is not an element of $arr
• pass( string [string $message = ''] ) - Unconditional pass
• fail( string [string $message = ''] ) - Unconditional fail
• report( ) - Generates a pretty CLI or HTML5 report of the test suite status. Called implicitly by run()
• __invoke( ) - Alias for run() method