.build/run-unittest*: accept extra args for the test runner

Author: generalmimon

.build/run-unittest

@@ -1,19 +1,57 @@
 #!/bin/sh -ef
 
-if [ "$#" -eq 0 ]; then
-	use_valgrind=
-elif [ "$#" -eq 1 ] && [ "$1" = '--valgrind' ]; then
-	use_valgrind=1
-else
-	echo "Usage: $0 [--valgrind]" >&2
+usage()
+{
+	echo "Usage: $0 [-h | --help] [--valgrind] [-- <gtest_args>...]"
+	echo
+	echo 'Options:'
+	echo '  -h, --help      Show this help message and exit.'
+	echo '  --valgrind      Run tests under Valgrind.'
+	echo '  --              Pass remaining arguments to the test runner.'
+	echo
+	echo 'Examples:'
+	echo '  * Basic usage:'
+	echo "        $0"
+	echo
+	echo "  * Run all tests (including disabled tests) under Valgrind:"
+	echo "        $0 --valgrind -- --gtest_also_run_disabled_tests"
+	echo
+}
+
+die()
+{
+	printf '%s\n' "$1" >&2
+	printf '\n%s\n' "$(usage)" >&2
 	exit 1
-fi
+}
+
+use_valgrind=
+
+while [ "$#" -gt 0 ]; do
+	case $1 in
+		-h|--help)
+			usage
+			exit
+			;;
+		--valgrind)
+			use_valgrind=1
+			;;
+		--)
+			shift
+			break
+			;;
+		*)
+			die "Error: unexpected argument '$1'"
+			;;
+	esac
+	shift
+done
 
 cd "$(dirname "$0")"/..
 
 cd build/tests
 if [ -n "$use_valgrind" ]; then
-	valgrind -s --leak-check=full --show-leak-kinds=all ./unittest
+	valgrind -s --leak-check=full --show-leak-kinds=all ./unittest ${@:+"$@"}
 else
-	./unittest
+	./unittest ${@:+"$@"}
 fi

.build/run-unittest.ps1

@@ -19,7 +19,12 @@ try {
     #ctest -C Debug --output-on-failure
 
     # Run gtest-generated binary directly, produces more detailed output
-    ./tests/Debug/unittest.exe
+    #
+    # NOTE: `$args` is a built-in PowerShell variable that contains all command-line arguments
+    # passed to the script (see https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-7.5#args).
+    # We use [splatting](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_splatting?view=powershell-7.5)
+    # to pass all received arguments to the test runner.
+    ./tests/Debug/unittest.exe @args
 } finally {
     Pop-Location
 }