Verbose mode

Author: vpiotr

README.md

@@ -175,6 +175,7 @@ make: *** [Makefile:84: test] Error 8
 - `UTEST_ALLOW_EMPTY_TESTS()` - Allow test runner to succeed even when no tests are run
 - `UTEST_USE_ASCII_CHECKMARKS()` - Use ASCII [OK]/[FAIL] instead of Unicode ✓/✗
 - `UTEST_SHOW_PERFORMANCE()` - Enable performance timing for each test
+- `UTEST_ENABLE_VERBOSE_MODE()` - Show test names before execution (useful for debugging)
 
 ### Function Definition Macros
 - `UTEST_FUNC_DEF(name)` - Define a test function: `void test_name()`
@@ -273,6 +274,28 @@ Output will show timing information:
 ✓ Test [my_test] succeeded (1.234ms)
 ```
 
+### Verbose Mode
+Enable verbose mode to see test names before execution:
+
+```cpp
+UTEST_PROLOG();
+UTEST_ENABLE_VERBOSE_MODE(); // Show test names before execution
+UTEST_FUNC(my_test);
+UTEST_EPILOG();
+```
+
+Output will show test names before execution:
+```
+Running test: my_test
+✓ Test [my_test] succeeded (1.234ms)
+```
+
+For grouped tests:
+```
+Running test: GroupName::TestName
+✓ Test [GroupName::TestName] succeeded (1.234ms)
+```
+
 ### ASCII Checkmarks
 For environments that don't support Unicode characters:
 

demo/CMakeLists.txt

@@ -57,4 +57,19 @@ target_include_directories(demo_unicode_checkmarks PRIVATE ${CMAKE_CURRENT_SOURC
 
 set_target_properties(demo_unicode_checkmarks PROPERTIES
     RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin"
+)
+
+# Demo for verbose mode
+add_executable(demo_verbose_mode
+    demo_verbose_mode.cpp
+)
+
+target_link_libraries(demo_verbose_mode
+    PRIVATE utest
+)
+
+target_include_directories(demo_verbose_mode PRIVATE ${CMAKE_CURRENT_SOURCE_DIR}/../include)
+
+set_target_properties(demo_verbose_mode PROPERTIES
+    RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin"
 )

demo/demo_verbose_mode.cpp

@@ -0,0 +1,50 @@
+// Demo showcasing verbose mode in utest library
+#include "utest.h"
+#include <string>
+
+UTEST_FUNC_DEF(VerboseBasicTest) {
+    UTEST_ASSERT_TRUE(true);
+    UTEST_ASSERT_EQUALS(2 + 2, 4);
+    UTEST_ASSERT_STR_EQUALS("hello", "hello");
+}
+
+UTEST_FUNC_DEF2(VerboseDemo, PassingTest) {
+    std::string greeting = "Hello, World!";
+    UTEST_ASSERT_EQUALS(greeting.length(), 13);
+    UTEST_ASSERT_GT(greeting.find("World"), 0);
+}
+
+UTEST_FUNC_DEF2(VerboseDemo, AnotherPassingTest) {
+    int numbers[] = {1, 2, 3, 4, 5};
+    UTEST_ASSERT_EQUALS(numbers[0], 1);
+    UTEST_ASSERT_EQUALS(numbers[4], 5);
+}
+
+UTEST_FUNC_DEF2(VerboseDemo, MathTest) {
+    UTEST_ASSERT_LT(3.14, 4.0);
+    UTEST_ASSERT_GTE(10, 10);
+    UTEST_ASSERT_NEQ(1, 2);
+}
+
+int main() {
+    UTEST_PROLOG();
+    
+    // Enable verbose mode for prettier output
+    UTEST_ENABLE_VERBOSE_MODE();
+    
+    // Enable Unicode checkmarks for prettier output
+    UTEST_USE_UNICODE_CHECKMARKS();
+    
+    // Keep performance timing enabled (default)
+    UTEST_SHOW_PERFORMANCE();
+    
+    std::cout << "=== Verbose Mode Demo ===\n";
+    std::cout << "This demo shows test names before execution\n\n";
+    
+    UTEST_FUNC(VerboseBasicTest);
+    UTEST_FUNC2(VerboseDemo, PassingTest);
+    UTEST_FUNC2(VerboseDemo, AnotherPassingTest);
+    UTEST_FUNC2(VerboseDemo, MathTest);
+    
+    UTEST_EPILOG();
+}

include/utest.h

@@ -62,6 +62,7 @@
  * The library can be configured using these macros in your test main():
  * - UTEST_USE_ASCII_CHECKMARKS() - Use [OK]/[FAIL] instead of checkmarks
  * - UTEST_SHOW_PERFORMANCE() - Show timing information for each test
+ * - UTEST_ENABLE_VERBOSE_MODE() - Show test names before execution
  * - UTEST_ALLOW_EMPTY_TESTS() - Don't fail if no tests are run
  * 
  * By default, ASCII checkmarks and performance timing are enabled for
@@ -685,6 +686,12 @@ namespace details {
         static bool showPerf = true;  // Default to showing performance info
         return showPerf;
     }
+    
+    // Configuration for verbose mode (showing test names before execution)
+    inline bool& getVerboseMode() {
+        static bool verbose = false;  // Default to non-verbose
+        return verbose;
+    }
 
     template<typename Func>
     void testFunc(const char *name, Func f, bool &failed) {
@@ -698,6 +705,11 @@ namespace details {
         const char* successMark = getUseAsciiCheckmarks() ? "[OK]" : "✓";
         const char* failMark = getUseAsciiCheckmarks() ? "[FAIL]" : "✗";
 
+        // Show test name before execution if verbose mode is enabled
+        if (getVerboseMode()) {
+            std::cout << "Running test: " << std::string(name) << "\n";
+        }
+        
         auto start = std::chrono::high_resolution_clock::now();
 
         try {
@@ -757,6 +769,11 @@ namespace details {
         const char* successMark = getUseAsciiCheckmarks() ? "[OK]" : "✓";
         const char* failMark = getUseAsciiCheckmarks() ? "[FAIL]" : "✗";
 
+        // Show test name before execution if verbose mode is enabled
+        if (getVerboseMode()) {
+            std::cout << "Running test: " << std::string(group) << "::" << std::string(name) << "\n";
+        }
+        
         auto start = std::chrono::high_resolution_clock::now();
 
         try {
@@ -996,6 +1013,23 @@ namespace details {
  */
 #define UTEST_HIDE_PERFORMANCE() utest::details::getShowPerformanceInfo() = false
 
+/**
+ * @brief Enable verbose mode to show test names before execution
+ * 
+ * Shows the name of each test before it runs, useful for debugging
+ * and understanding test execution flow.
+ * 
+ * @code{.cpp}
+ * int main() {
+ *     UTEST_PROLOG();
+ *     UTEST_ENABLE_VERBOSE_MODE();  // Show test names before execution
+ *     // ... run tests ...
+ *     UTEST_EPILOG();
+ * }
+ * @endcode
+ */
+#define UTEST_ENABLE_VERBOSE_MODE() utest::details::getVerboseMode() = true
+
 /** @} */ // end of test_execution group
 
 /**