Testing framework

CMakeLists.txt

@@ -272,3 +272,50 @@ if (APPLE)
 
     set(CMAKE_SKIP_RPATH "NO" CACHE INTERNAL "")
 endif(APPLE)
+
+# --------------------------------------------------
+# Unit Testing and Coverage
+# --------------------------------------------------
+
+option(HARP_BUILD_TESTS "Build HARP unit tests" OFF)
+option(HARP_ENABLE_COVERAGE "Enable coverage instrumentation" OFF)
+
+function(enable_harp_coverage target_name)
+    if(NOT TARGET ${target_name})
+        message(FATAL_ERROR
+            "Cannot enable coverage because target '${target_name}' does not exist."
+        )
+    endif()
+
+    if(CMAKE_CXX_COMPILER_ID MATCHES "GNU|Clang")
+        target_compile_options(${target_name} PRIVATE
+            -O0
+            -g
+            --coverage
+        )
+
+        target_link_options(${target_name} PRIVATE
+            --coverage
+        )
+    else()
+        message(WARNING
+            "HARP_ENABLE_COVERAGE is enabled, but coverage is only configured for GCC and Clang."
+        )
+    endif()
+endfunction()
+
+# Instrument the complete HARP application target so the coverage baseline
+# includes production files that have not yet been exercised by unit tests.
+if(HARP_ENABLE_COVERAGE)
+    enable_harp_coverage(${PROJECT_NAME})
+endif()
+
+if(HARP_BUILD_TESTS)
+    enable_testing()
+    add_subdirectory(tests)
+
+    # harp_tests does not exist until tests/CMakeLists.txt has been processed.
+    if(HARP_ENABLE_COVERAGE)
+        enable_harp_coverage(harp_tests)
+    endif()
+endif()

tests/CMakeLists.txt

@@ -0,0 +1,36 @@
+include(FetchContent)
+
+FetchContent_Declare(
+    googletest
+    URL https://github.com/google/googletest/archive/refs/tags/v1.14.0.zip
+    DOWNLOAD_EXTRACT_TIMESTAMP TRUE
+)
+
+FetchContent_MakeAvailable(googletest)
+
+file(GLOB_RECURSE HARP_TEST_SOURCES
+    CONFIGURE_DEPENDS
+    "${CMAKE_CURRENT_SOURCE_DIR}/*_tests.cpp"
+)
+
+add_executable(harp_tests
+    test_main.cpp
+    test_harp_logger.cpp
+    ${HARP_TEST_SOURCES}
+)
+
+target_link_libraries(harp_tests PRIVATE
+    GTest::gtest
+    juce::juce_core
+    juce::juce_data_structures
+    juce::juce_events
+    juce::juce_gui_basics
+)
+
+target_compile_definitions(harp_tests PRIVATE
+    JUCE_WEB_BROWSER=0
+    JUCE_USE_CURL=1
+    JUCE_LOAD_CURL_SYMBOLS_LAZILY=1
+)
+
+add_test(NAME harp_tests COMMAND harp_tests)