Running Tests

GoogleTest framework, test structure, and how to run specific test suites.

Test Framework

sharp-runtime uses GoogleTest as its test framework. The test runner executable is SharpRuntimeTests, built automatically when SHARP_RUNTIME_BUILD_TESTS=ON (the default).

GoogleTest is provided as a git submodule at vendor/googletest/.

Running All Tests

./build/SharpRuntimeTests

Expected output:

[==========] Running 3132 tests from 471 test suites.
[----------] Global test environment set-up.
...
[  PASSED  ] 3132 tests.
[  FAILED  ] 0 tests.

Running a Specific Test Suite

# Run all tests whose name contains "String"
./build/SharpRuntimeTests --gtest_filter="String*"

# Run TcpClient tests only
./build/SharpRuntimeTests --gtest_filter="TcpClient*"

# Run a specific test
./build/SharpRuntimeTests --gtest_filter="ListTests.AddAndCount"

Running via CTest

cd build
ctest --output-on-failure

Test File Locations

Test files are in the tests/ directory, organized to mirror the include/System/ structure:

tests/

Test Coverage

Adding New Tests

Create a new .cpp file anywhere under tests/. CMake uses GLOB_RECURSE to find all test files automatically — no manual registration is needed.

// tests/System/MyNewTests.cpp
#include <gtest/gtest.h>
#include "System/MyNewClass.hpp"

TEST(MyNewClassTests, BasicTest) {
    // ...
    EXPECT_EQ(expected, actual);
}