Docker Test Harness for Minetest Mods

Overview

This mod provides an automated testing framework for Minetest mods by simulating player behavior on a Minetest server. It allows developers to create, register, and run tests to ensure the correct behavior of their mods in various scenarios.

Features

• Test Registration: Easily register custom tests for your mod.
• Player Behavior Simulation: Simulate player actions for automatic testing.
• Modular Structure: Each test is associated with a specific mod and can be customized.
• Area and Node Manipulation: Test areas can be defined, and node checks can be performed.
• Test Context and State Management: Manage and track the progress of tests across multiple mods.

Prerequisite

The tests are run using Docker or Podman. Therefor you'll need to have either one of them installed.

Usage

This mod's goal is to provide a test framework for implementing tests for minetest mods.

1. Declare test_harness as an optional dependencies for your mod
2. Clone or download the docker-test-harness mod.
3. Place the test_harness directory into the mods folder of your Minetest world.
4. copy the .util folder in your project
5. Customize the .util/Dockerfile to include the mods and game your project depends on (download and copy)
6. Customize the .util/Dockerfile to adapt the /etc/minetest/minetest.conf.base file to list the mods you want to test (test_harness_mods), and to adjust the server configuration to your project test settings.
7. Do not forget the following setting in /etc/minetest/minetest.conf.base to enable automatic test execution:/etc/minetest/minetest.conf.base

   test_harness_run_tests = true
   

8. In your source files (in the init.lua for example) add the following lines (or equivalent)

   if minetest.settings:get_bool("test_harness_run_tests", false) then
       dofile(minetest.get_modpath("my_mod").. "/test/init.lua")
   end
   

9. In your test file(s), get an instance of the method allowing the registration of your tests:

   local register_test = test_harness.get_test_registrator("my_mod", my_mod.version_string)
   

10. Register the test by calling register_test
11. Run the test by lauching the run_tests.sh script. For example with Podman

    $ .util/run_tests.sh --podman
    

    See the available options with .util/run_tests.sh --help

Sources

• The base pf the code comes from the WorldEdit mod project : https://github.com/Uberi/Minetest-WorldEdit.
• The client's Dockerfile has been adapted from Miney-pi (https://github.com/miney-py/minetest-client-docker)
• The color management code comes from lua-chroma: https://github.com/ldrumm/lua-chroma

License

Licensed under the AGPL (Affero General Public License).

Funding

This mod is published with funding from the NLNet Foundation.