README

PHPUnit toolbox with short assertion aliases and useful testing utilities. This library provides a more concise and readable way to write tests by offering shorter function names for common PHPUnit assertions.

Features

• Short assertion aliases - Use isTrue() instead of $this->assertTrue()
• Extended assertions - Additional assertions for emails, dates, amounts, file contents
• Environment detection - Detect if running under TeamCity, Travis, PhpStorm
• Built-in utilities - Tools for test organization and debugging
• PHP 8.2+ support - Modern PHP features and strict typing

Installation

composer require jbzoo/phpunit --dev

Quick Start

namespace JBZoo\PHPUnit; /**  * Class PackageTest  * @package JBZoo\PHPUnit  */ class PackageTest extends PHPUnit { public function testSimple() { // Boolean isTrue(true); isFalse(false); // null isNull(null); // Check is variable empty isEmpty(0); isEmpty(''); isEmpty(null); isEmpty('0'); isEmpty(.0); isEmpty(array()); // Equals is(1, true); is(array(1, 2, 3), array(1, 2, 3)); isSame(array(1, 2, 3), array(1, 2, 3)); // Array, Object etc isKey('test', array('test' => true)); isNotKey('undef-kest', array('test' => true)); isAttr('test', (object)array('test' => true)); isNotAttr('undef-test', (object)array('test' => true)); // Instance Of ... isClass(JBZoo\PHPUnit\PHPUnit::class, $this); // Count props isCount(0, array()); isCount(1, array(1)); isCount(2, array(1, 3)); // regExp isLike('#t.st#i', 'TESTO'); isNotLike('#teeest#i', 'TESTO'); // Strings isContain('t', 'test'); isNotContain('x', 'test'); // Filesystem isFileEq(__FILE__, __FILE__); isFile(__FILE__); isDir(__DIR__); } public function testSkip() { skip('Some reason to skip this test'); } public function testFail() { fail('Some reason to fail this test'); } }

Available Assertions

Basic Assertions

• is($expected, $actual) - assertEquals
• isNot($expected, $actual) - assertNotEquals
• isSame($expected, $actual) - assertSame
• isNotSame($expected, $actual) - assertNotSame
• isTrue($value) - assertTrue
• isFalse($value) - assertFalse
• isNull($value) - assertNull
• isNotNull($value) - assertNotNull
• isEmpty($value) - assertEmpty
• isNotEmpty($value) - assertNotEmpty

Arrays & Objects

• isKey($key, $array) - assertArrayHasKey
• isNotKey($key, $array) - assertArrayNotHasKey
• isAttr($name, $object) - Check object attribute exists
• isNotAttr($name, $object) - Check object attribute doesn't exist
• isClass($expected, $actual) - assertInstanceOf
• isCount($expected, $countable) - assertCount

Strings & RegExp

• isLike($pattern, $value) - assertMatchesRegularExpression
• isNotLike($pattern, $value) - assertDoesNotMatchRegularExpression
• isContain($needle, $haystack) - String contains check
• isNotContain($needle, $haystack) - String doesn't contain check

Files & Filesystem

• isFile($path) - assertFileExists
• isNotFile($path) - File doesn't exist
• isDir($path) - Directory exists
• isNotDir($path) - Directory doesn't exist
• isFileEq($expected, $actual) - assertFileEquals
• isFileContains($expected, $filepath) - File contains string
• isFileNotContains($expected, $filepath) - File doesn't contain string

Extended Assertions

• isEmail($email) - Valid email check
• isNotEmail($email) - Invalid email check
• isCurrentDate($date, $timeDiff) - Date is close to current time
• isSameDate($expected, $actual, $format) - Date comparison
• isAmount($expected, $actual, $allowableDiff) - Amount comparison with tolerance
• isDiffBetweenDates($date1, $date2, $expectedDiff) - Time difference check

Test Control

• skip($message) - markTestSkipped
• fail($message) - fail test
• incomplete($message) - markTestIncomplete
• success($message) - Mark test as successful

Environment Detection

• isWin() - Running on Windows
• isTeamCity() - Running under TeamCity
• isTravis() - Running under Travis CI
• isPhpStorm() - Running in PhpStorm

Requirements

• PHP 8.2 or higher
• PHPUnit ^9.6.29
• ext-filter, ext-mbstring

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

MIT