akondas / exspecto
Small PHP DSL for synchronizing asynchronous operations (busy-waiting)
Installs: 1 628
Dependents: 0
Suggesters: 0
Security: 0
Stars: 5
Watchers: 3
Forks: 0
Open Issues: 0
Requires
- php: >=7.4
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.2
- phpstan/phpstan: ^1.10
- phpunit/phpunit: ^9.5
This package is auto-updated.
Last update: 2024-10-23 10:38:11 UTC
README
Small PHP DSL for synchronizing asynchronous operations (busy-waiting).
A simple and useful library recommended especially for testing asynchronous systems. Exspecto allows you to express expectations of an asynchronous system in a concise and easy to read manner. Example:
await()->atMost(1)->until(function() { return customerStatusIsUpdated(); });
You can use pollInterval
to set how often the condition should be checked (default value is 100 milliseconds):
await()->atMost(3)->pollInterval(200)->until(function() { return customerStatusIsUpdated(); });
You can also await for given value in case the returning method (closure) could throw an exception:
$value = await()->atMost(3)->pollInterval(200)->on(fn() => getValue());
exspecto - from latin: wait for, await
Install
composer require akondas/exspecto
Roadmap
-
untilAsserted
for example:untilAsserted('UserRepository::size', equaltTo(3))
- support different poll interval strategy (fixed, fibonacci, iterative)
-
ignoreExceptions
do not stop when exceptions occur (ignoreException(string $exceptionClass)
) -
atLeast
-
unitlNotNull
,untilNull
etc.
License
Exspecto is released under the MIT Licence. See the bundled LICENSE file for details.
Author
Arkadiusz Kondas (@ArkadiuszKondas)