class Assert

Assertion test helpers.

Constants

EPSILON

used by equal() for comparing floats

Properties

static $patterns

used by match(); in values, each $ followed by number is backreference

static callable $onFailure
static int $counter

Methods

static void
same($expected, $actual, $description = NULL)

Checks assertion. Values must be exactly the same.

static void
notSame($expected, $actual, $description = NULL)

Checks assertion. Values must not be exactly the same.

static void
equal($expected, $actual, $description = NULL)

Checks assertion. The identity of objects and the order of keys in the arrays are ignored.

static void
notEqual($expected, $actual, $description = NULL)

Checks assertion. The identity of objects and the order of keys in the arrays are ignored.

static void
contains($needle, $actual, $description = NULL)

Checks assertion. Values must contains expected needle.

static void
notContains($needle, $actual, $description = NULL)

Checks assertion. Values must not contains expected needle.

static void
true($actual, $description = NULL)

Checks TRUE assertion.

static void
false($actual, $description = NULL)

Checks FALSE assertion.

static void
null($actual, $description = NULL)

Checks NULL assertion.

static void
nan($actual, $description = NULL)

Checks Not a Number assertion.

static void
truthy($actual, $description = NULL)

Checks truthy assertion.

static void
falsey($actual, $description = NULL)

Checks falsey (empty) assertion.

static void
count($count, $value, $description = NULL)

Checks if subject has expected count.

static void
type($type, $value, $description = NULL)

Checks assertion.

static Exception
exception($function, $class, $message = NULL, $code = NULL)

Checks if the function throws exception.

static Exception
throws($function, $class, $message = NULL, $code = NULL)

Checks if the function throws exception, alias for exception().

static null|Exception
error($function, $expectedType, $expectedMessage = NULL)

Checks if the function generates PHP error or throws exception.

static void
noError($function)

Checks that the function does not generate PHP error and does not throw exception.

static void
match($pattern, $actual, $description = NULL)

Compares result using regular expression or mask: %a% one or more of anything except the end of line characters %a?% zero or more of anything except the end of line characters %A% one or more of anything including the end of line characters %A?% zero or more of anything including the end of line characters %s% one or more white space characters except the end of line characters %s?% zero or more white space characters except the end of line characters %S% one or more of characters except the white space %S?% zero or more of characters except the white space %c% a single character of any sort (except the end of line) %d% one or more digits %d?% zero or more digits %i% signed integer value %f% floating point number %h% one or more HEX digits

static void
matchFile($file, $actual, $description = NULL)

Compares results using mask sorted in file.

static void
fail($message, $actual = NULL, $expected = NULL)

Failed assertion

static 
with($obj, Closure $closure)

No description

static bool
isMatching($pattern, $actual)

Compares using mask.

static bool
isEqual($expected, $actual, $level = 0, $objects = NULL)

Compares two structures. Ignores the identity of objects and the order of keys in the arrays.

Details

at line 50
static void same($expected, $actual, $description = NULL)

Checks assertion. Values must be exactly the same.

Parameters

$expected
$actual
$description

Return Value

void

at line 63
static void notSame($expected, $actual, $description = NULL)

Checks assertion. Values must not be exactly the same.

Parameters

$expected
$actual
$description

Return Value

void

at line 76
static void equal($expected, $actual, $description = NULL)

Checks assertion. The identity of objects and the order of keys in the arrays are ignored.

Parameters

$expected
$actual
$description

Return Value

void

at line 89
static void notEqual($expected, $actual, $description = NULL)

Checks assertion. The identity of objects and the order of keys in the arrays are ignored.

Parameters

$expected
$actual
$description

Return Value

void

at line 102
static void contains($needle, $actual, $description = NULL)

Checks assertion. Values must contains expected needle.

Parameters

$needle
$actual
$description

Return Value

void

at line 123
static void notContains($needle, $actual, $description = NULL)

Checks assertion. Values must not contains expected needle.

Parameters

$needle
$actual
$description

Return Value

void

at line 146
static void true($actual, $description = NULL)

Checks TRUE assertion.

Parameters

$actual
$description

Return Value

void

at line 161
static void false($actual, $description = NULL)

Checks FALSE assertion.

Parameters

$actual
$description

Return Value

void

at line 176
static void null($actual, $description = NULL)

Checks NULL assertion.

Parameters

$actual
$description

Return Value

void

at line 191
static void nan($actual, $description = NULL)

Checks Not a Number assertion.

Parameters

$actual
$description

Return Value

void

at line 206
static void truthy($actual, $description = NULL)

Checks truthy assertion.

Parameters

$actual
$description

Return Value

void

at line 221
static void falsey($actual, $description = NULL)

Checks falsey (empty) assertion.

Parameters

$actual
$description

Return Value

void

at line 237
static void count($count, $value, $description = NULL)

Checks if subject has expected count.

Parameters

$count
$value
$description

Return Value

void

at line 253
static void type($type, $value, $description = NULL)

Checks assertion.

Parameters

$type
$value
$description

Return Value

void

at line 286
static Exception exception($function, $class, $message = NULL, $code = NULL)

Checks if the function throws exception.

Parameters

$function
$class
$message
$code

Return Value

Exception

at line 315
static Exception throws($function, $class, $message = NULL, $code = NULL)

Checks if the function throws exception, alias for exception().

Parameters

$function
$class
$message
$code

Return Value

Exception

at line 328
static null|Exception error($function, $expectedType, $expectedMessage = NULL)

Checks if the function generates PHP error or throws exception.

Parameters

$function
$expectedType
$expectedMessage

Return Value

null|Exception

at line 383
static void noError($function)

Checks that the function does not generate PHP error and does not throw exception.

Parameters

$function

Return Value

void

at line 410
static void match($pattern, $actual, $description = NULL)

Compares result using regular expression or mask: %a% one or more of anything except the end of line characters %a?% zero or more of anything except the end of line characters %A% one or more of anything including the end of line characters %A?% zero or more of anything including the end of line characters %s% one or more white space characters except the end of line characters %s?% zero or more white space characters except the end of line characters %S% one or more of characters except the white space %S?% zero or more of characters except the white space %c% a single character of any sort (except the end of line) %d% one or more digits %d?% zero or more digits %i% signed integer value %f% floating point number %h% one or more HEX digits

Parameters

$pattern
$actual
$description

Return Value

void

at line 426
static void matchFile($file, $actual, $description = NULL)

Compares results using mask sorted in file.

Parameters

$file
$actual
$description

Return Value

void

at line 443
static void fail($message, $actual = NULL, $expected = NULL)

Failed assertion

Parameters

$message
$actual
$expected

Return Value

void

at line 460
static with($obj, Closure $closure)

No description

Parameters

$obj
Closure $closure

at line 474
static bool isMatching($pattern, $actual)

internal  
 

Compares using mask.

Parameters

$pattern
$actual

Return Value

bool

at line 513
static bool isEqual($expected, $actual, $level = 0, $objects = NULL)

internal  
 

Compares two structures. Ignores the identity of objects and the order of keys in the arrays.

Parameters

$expected
$actual
$level
$objects

Return Value

bool