BDD Assertions for PHPUnit or Codeception
This is very tiny wrapper for PHPUnit assertions, that are aimed to make tests a bit more readable. With BDD assertions influenced by Chai, Jasmine, and RSpec your assertions would be a bit closer to natural language.
Requires PHP 7.4 or higher
composer require codeception/verify --dev ⬆️ Upgrade from 1.x by following the upgrade guide.
Use in any test verify function instead of $this->assert* methods:
useCodeception\Verify\Verify; $user = User::find(1); // equalsverify($user->getName())->equals('davert'); verify($user->getNumPosts()) ->equals(5, 'user have 5 posts') ->notEquals(3); // contains Verify::Array($user->getRoles()) ->contains('admin', 'first user is admin') ->notContains('banned', 'first user is not banned'); // greater / lessverify($user->getRate()) ->greaterThan(5) ->lessThan(10) ->equals(7, 'first user rate is 7'); // true / false / nullverify($user->isAdmin())->true(); verify($user->isBanned())->false(); verify($user->invitedBy)->null(); verify($user->getPosts())->notNull(); // emptyverify($user->getComments())->empty(); verify($user->getRoles())->notEmpty(); // throws Verify::Callable($callback) ->throws() ->throws(Exception::class) ->throws(Exception::class, 'exception message') ->throws(newException()) ->throws(newException('message')); // does not throw Verify::Callable($callback) ->doesNotThrow() ->throws(Exception::class) ->doesNotThrow(newException()); // and many more !📄 See Verifiers full list here.
If you follow TDD/BDD you'd rather use expect instead of verify:
expect($user->getNumPosts()) ->notToBeNull() ->toBeInt() ->toEqual(5, 'user have 5 posts');📄 See Expectations full list here.
Or verify_that which is just an alias function:
verify_that($user->getRate())->equals(7, 'first user rate is 7');In order to add more assertions you can extend the abstract class Verify:
useCodeception\Verify\Verify; usePHPUnit\Framework\Assert; class MyVerify extends Verify{//you can type $actual to only receive a specific data typepublicfunction__construct($actual = null){parent::__construct($actual)} publicfunctionsuccess(string$message = ''){Assert::assertTrue(true, $message)} }And use it!
$myVerify = newMyVerify; $myVerify->success('it works!'); $myVerify::Mixed('this also')->notEquals('works');Verify is open-sourced software licensed under the MIT License. © Codeception PHP Testing Framework
