Enhance C API tests with dynamic index functionality and coverage reporting

- Refactor CMake configuration to support coverage options for C API tests.
- Update test build options to allow dynamic index testing with configurable block sizes.
- Introduce a utility for managing temporary directories in tests.
- Improve dynamic index tests to include save/load functionality and multi-threading support.
- Update README and test commands for consistency with new test target names.

Author: rfsaliev

bindings/c/CMakeLists.txt

@@ -69,9 +69,6 @@ set_target_properties(${TARGET_NAME} PROPERTIES VERSION ${PROJECT_VERSION} SOVER
 target_link_libraries(${TARGET_NAME} PRIVATE
     svs::svs
 )
-if (SVS_EXPERIMENTAL_LINK_STATIC_MKL)
-    link_mkl_static(${TARGET_NAME})
-endif()
 
 if (SVS_RUNTIME_ENABLE_LVQ_LEANVEC)
     message(STATUS "Enabling LVQ/LeanVec support in C API")
@@ -95,7 +92,9 @@ if (SVS_RUNTIME_ENABLE_LVQ_LEANVEC)
             svs::svs
             svs_compile_options
         )
-        link_mkl_static(${TARGET_NAME})
+        if(SVS_EXPERIMENTAL_LINK_STATIC_MKL)
+            link_mkl_static(${TARGET_NAME})
+        endif()
     elseif(TARGET svs::svs)
         message(FATAL_ERROR
             "Pre-built LVQ/LeanVec SVS library cannot be used in SVS main build. "
@@ -191,8 +190,34 @@ install(FILES
 )
 
 # Build tests if requested
-option(SVS_BUILD_C_API_TESTS "Build C API tests" ON)
+if(DEFINED SVS_BUILD_TESTS)
+    option(SVS_BUILD_C_API_TESTS "Build C API tests" ${SVS_BUILD_TESTS})
+else()
+    option(SVS_BUILD_C_API_TESTS "Build C API tests" OFF)
+endif()
+
+
 if(SVS_BUILD_C_API_TESTS)
+    if(CMAKE_BUILD_TYPE STREQUAL "Debug")
+        target_compile_options(${TARGET_NAME} PRIVATE --coverage)
+        target_link_libraries(${TARGET_NAME} PRIVATE --coverage)
+        # add coverage target
+        add_custom_target(clean_coverage
+            COMMAND ${CMAKE_COMMAND} -E echo "Cleaning coverage data..."
+            COMMAND ${CMAKE_COMMAND} -E chdir ${CMAKE_BINARY_DIR} find . -name "*.gcda" -delete
+            COMMAND ${CMAKE_COMMAND} -E remove -f ${CMAKE_BINARY_DIR}/coverage.info
+            COMMENT "Cleaning coverage data..."
+        )
+        add_custom_target(coverage
+            COMMAND ${CMAKE_COMMAND} -E echo "Generating coverage report..."
+            COMMAND ${CMAKE_COMMAND} -E env GCOV_PREFIX=${CMAKE_BINARY_DIR}/coverage GCOV_PREFIX_STRIP=1 ${CMAKE_COMMAND} -E make_directory ${CMAKE_BINARY_DIR}/coverage
+            COMMAND ${CMAKE_COMMAND} -E chdir ${CMAKE_BINARY_DIR} lcov --capture --directory . --output-file coverage.info
+            COMMAND ${CMAKE_COMMAND} -E chdir ${CMAKE_BINARY_DIR} lcov --remove coverage.info '/usr/*' --output-file coverage.info
+            COMMAND ${CMAKE_COMMAND} -E chdir ${CMAKE_BINARY_DIR} lcov --remove coverage.info '*/_deps/*' --output-file coverage.info
+            COMMAND ${CMAKE_COMMAND} -E chdir ${CMAKE_BINARY_DIR} lcov --list coverage.info
+            COMMENT "Generating code coverage report..."
+        )
+    endif()
     add_subdirectory(tests)
 endif()
 

bindings/c/tests/CMakeLists.txt

@@ -29,11 +29,11 @@ if(NOT Catch2_FOUND)
     set(CATCH_CONFIG_PREFIX_ALL ON CACHE BOOL "" FORCE)
 
     set(PRESET_CMAKE_CXX_STANDARD ${CMAKE_CXX_STANDARD})
-    set(CMAKE_CXX_STANDARD 20)
+    set(CMAKE_CXX_STANDARD ${SVS_CXX_STANDARD})
     FetchContent_Declare(
         Catch2
         GIT_REPOSITORY https://github.com/catchorg/Catch2.git
-        GIT_TAG v3.11.0
+        GIT_TAG v3.4.0
     )
     FetchContent_MakeAvailable(Catch2)
     set(CMAKE_CXX_STANDARD ${PRESET_CMAKE_CXX_STANDARD})
@@ -97,7 +97,7 @@ include(Catch)
 catch_discover_tests(${TARGET_NAME})
 
 # Add a custom target to run tests
-add_custom_target(run_c_api_tests
+add_custom_target(run_c_api_test
     COMMAND ${TARGET_NAME}
     DEPENDS ${TARGET_NAME}
     WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}

bindings/c/tests/README.md

@@ -23,7 +23,7 @@ The tests are built as part of the C API build process. To build them:
 ```bash
 # From the build directory
 cmake -DSVS_BUILD_C_API_TESTS=ON ..
-make svs_c_api_tests
+make svs_c_api_test
 ```
 
 To disable building tests:
@@ -37,41 +37,41 @@ cmake -DSVS_BUILD_C_API_TESTS=OFF ..
 ### Run all tests
 
 ```bash
-./svs_c_api_tests
+./svs_c_api_test
 ```
 
 ### Run specific test cases
 
 ```bash
 # Run error handling tests only
-./svs_c_api_tests "[c_api][error]"
+./svs_c_api_test "[c_api][error]"
 
 # Run algorithm tests only
-./svs_c_api_tests "[c_api][algorithm]"
+./svs_c_api_test "[c_api][algorithm]"
 
 # Run all index tests
-./svs_c_api_tests "[c_api][index]"
+./svs_c_api_test "[c_api][index]"
 
 # Run dynamic index tests
-./svs_c_api_tests "[c_api][dynamic]"
+./svs_c_api_test "[c_api][dynamic]"
 ```
 
 ### Run with verbose output
 
 ```bash
-./svs_c_api_tests -s
+./svs_c_api_test -s
 ```
 
 ### List all available tests
 
 ```bash
-./svs_c_api_tests --list-tests
+./svs_c_api_test --list-tests
 ```
 
 ### Run with CTest
 
 ```bash
-ctest -R svs_c_api_tests
+ctest -R svs_c_api_test
 ```
 
 ## Test Coverage