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
Warning
This plugin should not be used in production, as it will shutdown the server as soon as testing is complete.
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:latestNote
An action to simplify the execution of integration tests in a github workflow should be available soon.
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.