[Script] Add a tool to test the code coverage.

CMakeLists.txt

@@ -19,6 +19,7 @@ option(XGRAMMAR_BUILD_CXX_TESTS "Build C++ tests" OFF)
 option(XGRAMMAR_ENABLE_CPPTRACE
        "Enable C++ trace (Now only support Linux, and RelWithDebugInfo or Debug build)" OFF
 )
+option(XGRAMMAR_ENABLE_COVERAGE "Enable code coverage with gcov" OFF)
 
 set(XGRAMMAR_CUDA_ARCHITECTURES
     native
@@ -93,3 +94,16 @@ if(XGRAMMAR_BUILD_CXX_TESTS)
   include(GoogleTest)
   gtest_discover_tests(xgrammar_test)
 endif()
+
+if(XGRAMMAR_ENABLE_COVERAGE)
+  target_link_libraries(xgrammar_bindings PRIVATE gcov)
+  set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fprofile-arcs -ftest-coverage")
+  set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fprofile-arcs -ftest-coverage")
+
+  set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} --coverage")
+  set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} --coverage")
+
+  if(XGRAMMAR_BUILD_PYTHON_BINDINGS)
+    set(CMAKE_MODULE_LINKER_FLAGS "${CMAKE_MODULE_LINKER_FLAGS} --coverage")
+  endif()
+endif()

cmake/config.cmake

@@ -1,4 +1,5 @@
 set(CMAKE_BUILD_TYPE RelWithDebInfo)
 set(XGRAMMAR_BUILD_PYTHON_BINDINGS ON)
+set(XGRAMMAR_ENABLE_COVERAGE OFF)
 set(XGRAMMAR_BUILD_CXX_TESTS OFF)
 set(XGRAMMAR_ENABLE_CPPTRACE OFF)

scripts/run_coverage.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+
+# Usage: bash ./scripts/run_coverage.sh
+lcov --directory . --zerocounters
+ctest --test-dir build -V --timeout 60 --stop-on-failure
+pytest
+
+lcov --gcov-tool /usr/bin/gcov-13 --directory . --capture --output-file coverage.info --ignore-errors mismatch,gcov
+genhtml coverage.info --output-directory coverage_report --ignore-errors version
+rm coverage.info
+echo "Coverage report generated at: $(pwd)/coverage_report/index.html"