From 0d297708e5fff573c31f4a5ba5f2b7c13716efe3 Mon Sep 17 00:00:00 2001
From: Abtin Keshavarzian <abtink@google.com>
Date: Fri, 22 May 2026 18:08:44 -0700
Subject: [PATCH] [nexus] add help and argument validation to `build.sh`
 (#13133)

This commit improves the `tests/nexus/build.sh` script by adding a
`display_usage()` function and implementing stricter command-line
argument validation.
---
 tests/nexus/build.sh | 31 ++++++++++++++++++++++++++++++-
 1 file changed, 30 insertions(+), 1 deletion(-)

diff --git a/tests/nexus/build.sh b/tests/nexus/build.sh
index aa5b6209a..8d2f43ce8 100755
--- a/tests/nexus/build.sh
+++ b/tests/nexus/build.sh
@@ -27,6 +27,21 @@
 #  POSSIBILITY OF SUCH DAMAGE.
 #
 
+display_usage()
+{
+    echo ""
+    echo "Nexus Build script"
+    echo ""
+    echo "Usage: $(basename "$0") [config]"
+    echo "    <config> can be:"
+    echo "        (no arg)        : Build OpenThread Nexus platform with default config"
+    echo "        trel            : Build OpenThread Nexus platform with TREL radio (no 15.4)"
+    echo "        wasm            : Build OpenThread Nexus platform for WebAssembly"
+    echo "        long_routes     : Build OpenThread Nexus platform with LONG_ROUTES feature enabled"
+    echo "        no_tests        : Build OpenThread Nexus platform without test executables"
+    echo ""
+}
+
 die()
 {
     echo " *** ERROR: " "$*"
@@ -44,6 +59,11 @@ else
     top_builddir=.
 fi
 
+if [ "$#" -gt 1 ]; then
+    display_usage
+    exit 1
+fi
+
 long_routes=OFF
 build_tests=ON
 
@@ -66,10 +86,19 @@ case $1 in
         wasm=OFF
         build_tests=OFF
         ;;
-    *)
+    "")
         fifteenfour=ON
         wasm=OFF
         ;;
+    help | --help | -h)
+        display_usage
+        exit 0
+        ;;
+    *)
+        echo "Error: Unknown configuration \"$1\""
+        display_usage
+        exit 1
+        ;;
 esac
 
 echo "===================================================================================================="