Add Unity-based unit test infrastructure (Phase 1: 117 tests passing)

Agent-Logs-Url: https://github.com/tbamud/tbamud/sessions/d5b86db2-e5ab-4729-b8b1-2ca7cf01c6b9

Co-authored-by: welcor <357770+welcor@users.noreply.github.com>

tests/CMakeLists.txt

@@ -0,0 +1,95 @@
+# tests/CMakeLists.txt
+# Unity-based unit tests for tbaMUD
+#
+# Each test executable is built from:
+#   vendor/unity/unity.c   — test framework
+#   test_stubs.c           — weak-symbol stubs for all unresolved mud globals
+#   src/<module>.c         — the source file(s) under test
+#   test_<name>.c          — the test file itself
+#
+# Only the source files being tested are compiled — in particular comm.c
+# (which contains main()) is never included.
+
+cmake_minimum_required(VERSION 3.12)
+
+enable_testing()
+
+# ---------------------------------------------------------------------------
+# Common settings shared by all test targets
+# ---------------------------------------------------------------------------
+
+set(UNITY_SRC  ${CMAKE_CURRENT_SOURCE_DIR}/vendor/unity/unity.c)
+set(STUBS_SRC  ${CMAKE_CURRENT_SOURCE_DIR}/test_stubs.c)
+
+set(MUD_SRCDIR ${CMAKE_SOURCE_DIR}/src)
+
+# Include paths: mud source dir for conf.h / structs.h etc.,
+# CMake binary dir for the generated conf.h (cmake builds place it there),
+# and the Unity header dir.
+set(TEST_INCLUDES
+    ${MUD_SRCDIR}
+    ${CMAKE_BINARY_DIR}
+    ${CMAKE_CURRENT_SOURCE_DIR}/vendor/unity
+)
+
+# Suppress warnings that fire in generated stubs / vendored code and in the
+# mud sources when compiled outside their normal full-build context.
+set(TEST_CFLAGS
+    -Wno-unused-parameter
+    -Wno-unused-function
+    -Wno-unused-variable
+)
+
+# Helper macro: add_mud_test(name SRC1 [SRC2 …])
+# Creates an executable, registers it with CTest.
+macro(add_mud_test TEST_NAME)
+    add_executable(${TEST_NAME}
+        ${UNITY_SRC}
+        ${STUBS_SRC}
+        ${ARGN}
+    )
+    target_include_directories(${TEST_NAME} PRIVATE ${TEST_INCLUDES})
+    target_compile_options(${TEST_NAME} PRIVATE ${TEST_CFLAGS})
+    add_test(NAME ${TEST_NAME} COMMAND ${TEST_NAME})
+endmacro()
+
+# ---------------------------------------------------------------------------
+# test_utils  — covers src/utils.c
+# ---------------------------------------------------------------------------
+add_mud_test(test_utils
+    ${MUD_SRCDIR}/utils.c
+    ${MUD_SRCDIR}/random.c
+    ${CMAKE_CURRENT_SOURCE_DIR}/test_utils.c
+)
+
+# ---------------------------------------------------------------------------
+# test_random — covers src/random.c and rand_number/dice in src/utils.c
+# ---------------------------------------------------------------------------
+add_mud_test(test_random
+    ${MUD_SRCDIR}/random.c
+    ${MUD_SRCDIR}/utils.c
+    ${CMAKE_CURRENT_SOURCE_DIR}/test_random.c
+)
+
+# ---------------------------------------------------------------------------
+# test_interpreter — covers string helpers in src/interpreter.c
+# ---------------------------------------------------------------------------
+add_mud_test(test_interpreter
+    ${MUD_SRCDIR}/interpreter.c
+    ${MUD_SRCDIR}/utils.c
+    ${MUD_SRCDIR}/random.c
+    ${CMAKE_CURRENT_SOURCE_DIR}/test_interpreter.c
+)
+
+# crypt() is referenced from interpreter.c (nanny password hashing)
+target_link_libraries(test_interpreter PRIVATE crypt)
+
+# ---------------------------------------------------------------------------
+# test_class — covers src/class.c
+# ---------------------------------------------------------------------------
+add_mud_test(test_class
+    ${MUD_SRCDIR}/class.c
+    ${MUD_SRCDIR}/utils.c
+    ${MUD_SRCDIR}/random.c
+    ${CMAKE_CURRENT_SOURCE_DIR}/test_class.c
+)