akondas/exspecto

Small PHP DSL for synchronizing asynchronous operations (busy-waiting)

1.0.0 2021-08-23 11:23 UTC

This package is auto-updated.

Last update: 2021-09-23 11:26:42 UTC


README

Minimum PHP Version

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();
});

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)