PHP code example of phrozenbyte / phpunit-throwable-asserts
1. Go to this page and download the library: Download phrozenbyte/phpunit-throwable-asserts library. Choose the download type require.
2. Extract the ZIP file and open the index.php.
3. Add this code to the index.php.
<?php
require_once('vendor/autoload.php');
/* Start to develop here. Best regards https://php-download.com/ */
phrozenbyte / phpunit-throwable-asserts example snippets
// using `PhrozenByte\PHPUnitThrowableAsserts\ThrowableAssertsTrait` trait
ThrowableAssertsTrait::assertCallableThrows(
callable $callable, // the Callable to call
string $throwableClassName = Throwable::class, // assert that a Throwable of the given class is thrown
Constraint|string $throwableMessage = null, // assert that its message matches the given constraint
int|string $throwableCode = null, // assert that its code matches the given one
bool $throwableExactMatch = false, // whether an exact match of the class name is
$controller = new BookController();
$bookName = "The Hitchhiker's Guide to the Galaxy";
$bookReleaseDate = '1979-10-12';
$this->assertCallableThrows(
$this->callableProxy([ $controller, 'create' ], $bookName, $bookReleaseDate),
BookAlreadyExistsException::class,
'Unable to create book: Book already exists'
);
$service = new HitchhikersGuideService();
$towel = false;
$answer = 42;
$this->assertCallableThrows(
static function () use ($service, $towel, $answer) {
$service->checkAnswer($answer); // throws a OpaqueAnswerException
$service->checkTowel($towel); // throws a PanicException (unreachable code)
},
PanicException::class,
'I forgot my towel'
);
// Will fail with the following message:
//
// Failed asserting that {closure}() throws a PanicException whose message is 'Time to panic'.
// Encountered invalid OpaqueAnswerException: I do not understand.
// --- Expected
// +++ Actual
// @@ @@
// -'Time to panic'
// +'I do not understand'
// using `PhrozenByte\PHPUnitThrowableAsserts\ThrowableAssertsTrait` trait
ThrowableAssertsTrait::assertCallableThrowsNot(
callable $callable, // the Callable to call
string $throwableClassName = Throwable::class, // assert that no Throwable of the given class is thrown
Constraint|string $throwableMessage = null, // catch Throwables matching the given message constraint only
int|string $throwableCode = null, // catch Throwables matching the given code only
bool $throwableExactMatch = false, // whether only Throwables of the given class are caught
string $message = '' // additional information about the test
);
// using new instance of `PhrozenByte\PHPUnitThrowableAsserts\Constraint\CallableThrowsNot`
new CallableThrowsNot(
string $className = Throwable::class,
Constraint|string $message = null,
int|string $code = null,
bool $exactMatch = false
);
$controller = new BookController();
$bookName = "The Hitchhiker's Guide to the Galaxy";
$bookReleaseDate = '1979-10-12';
$this->assertCallableThrowsNot(
$this->callableProxy([ $controller, 'create' ], $bookName, $bookReleaseDate),
BookAlreadyExistsException::class
);
// Will fail with the following message:
//
// Failed asserting that BookController::create() does not throw a BookAlreadyExistsException
// Encountered invalid BookAlreadyExistsException: Unable to create book: Book already exists
// create new instance of `PhrozenByte\PHPUnitThrowableAsserts\CallableProxy`
// using the `PhrozenByte\PHPUnitThrowableAsserts\ThrowableAssertsTrait` trait
ThrowableAssertsTrait::callableProxy(
callable $callable, // the Callable to invoke
mixed ...$arguments // the arguments to pass to the Callable
);
// create new instance of `PhrozenByte\PHPUnitThrowableAsserts\CachedCallableProxy`
// using the `PhrozenByte\PHPUnitThrowableAsserts\ThrowableAssertsTrait` trait
$proxy = ThrowableAssertsTrait::cachedCallableProxy(
callable $callable, // the Callable to invoke
mixed ...$arguments // the arguments to pass to the Callable
);
// get return value of the Callable (`CachedCallableProxy` only)
$proxy->getReturnValue();
// get a possibly thrown Throwable (`CachedCallableProxy` only)
$proxy->getThrowable();
$computer = new DeepThought();
$question = 'What is the Answer to the Ultimate Question of Life, the Universe, and Everything?';
// using `PhrozenByte\PHPUnitThrowableAsserts\CallableProxy`
// if the assertion fails, `ExpectationFailedException`'s message will point to DeepThought::ask() as source
$askQuestion = $this->cachedCallableProxy([ $computer, 'ask' ], $question);
$this->assertCallableThrowsNot($askQuestion);
$answer = $askQuestion->getReturnValue();
// using anonymous function
// if the assertion fails, `ExpectationFailedException` will just name {closure} as source
$answer = null;
$this->assertCallableThrowsNot(static function () use ($computer, $question, &$answer) {
// use variable reference to pass the return value
$answer = $computer->ask($question);
});
$this->assertCallableThrows(
static function () {
// triggers a E_NOTICE PHP error
echo $undefinedVariable;
},
\PHPUnit\Framework\Error\Notice::class,
'Undefined variable: undefinedVariable'
);
Loading please wait ...
Before you can download the PHP files, the dependencies should be resolved. This can take some minutes. Please be patient.