shockedplot7560 / pmmpunit Goto Github PK

Run only on Unix (Linux, Mac)

This plugin has been created with the sole aim of making integration and functional tests possible during the pocketmine runtime.

It can be used to correctly test the expected result of a command executed by a fake player, interaction with events and multi-threading support.

Tests are run asynchronously using promises to enable support with different systems in place. The libraries used for the promises are : ReactPHP/promise

Using of official docker image is strongly recommended.

Mount your tests in /data/plugin_data/PmmpUnit/tests/ and copy your plugin in /plugins/.

Exemple:

docker run -it --rm \
  -v /tests/pmmpunit/suitetest/normal/tests:/data/plugin_data/PmmpUnit/tests/ \
  # -v /path/to/plugin:/plugins/ \
  --name pmunit-test \
  ghcr.io/shockedplot7560/pmmpunit/tests-runner:latest

Tests are retrieved from the folder: plugin_data/PmmpUnit/tests/ and are executed when the server start.

All test classes must inherit from ShockedPlot7560\PmmpUnit\framework\TestCase.
All test methods must be prefixed with test and must not have any parameters, it must return a PromiseInterface<null>.
If the code is executed synchronously and does not have to wait for a result, use resolve(null). Use Deferred instead for asynchronous code and $deferred->resolve(null) to resolve the promise.

Each test class can execute code when the server is onLoad, onEnable or onDisable. Simply use the corresponding classes.

setUp and tearDown are called when each class test is run, respectively before and after the test, whatever the result.

For exemple tests, look at tests/pmmpunit/suitetest/*/tests

To retrieve one player during a test, call getPlayer().
To test player commands or behavior, create your promise/listener before executing the action. Return the promise in the test method.