From 5a9555c10ea29f1789875d62b40819084f9a31da Mon Sep 17 00:00:00 2001 From: speeddragon Date: Thu, 23 Jul 2026 11:19:54 +0100 Subject: [PATCH] docs: Update docs to AI agent can pick the right test command --- docs/misc/hacking-on-hyperbeam.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/misc/hacking-on-hyperbeam.md b/docs/misc/hacking-on-hyperbeam.md index ebb69cbcd5..40e914eb9e 100644 --- a/docs/misc/hacking-on-hyperbeam.md +++ b/docs/misc/hacking-on-hyperbeam.md @@ -36,6 +36,20 @@ This should run all of the tests in every HyperBEAM module. If you would like to run only tests from a specific set of modules, just add `--module=list,of,mods`. To run only a specific test use `--test=your_module:your_test`. +Preloaded device modules under `src/preloaded` are packaged and renamed before +execution, so run their tests through the device test harness instead of plain +`eunit --module`. For example: + +``` + rebar3 device test --devices dev_manifest --module dev_manifest +``` + +To run specific device tests, pass the source module and test function: + +``` + rebar3 device test --devices dev_manifest --module dev_manifest --test manifest_should_fallback_on_not_found_path_test_parallel +``` + Do not send a PR in which the tests do not pass. ## Event logging and debugging