testcoe

Visual test progress and crash handling for Google Test.

What is testcoe?

testcoe enhances Google Test with real-time grid visualization and crash reporting:

Running 12 tests... Completed: 8/12 (P: 6, F: 2)
P - Passed, F - Failed, R - Running, . - Not run yet

MathTests    PPF.. (3/5)
StringTests  PRPP. (4/5)
VectorTests  ....  (0/2)

When tests crash, you get detailed stack traces instead of silent failures.

Dependencies

• Google Test (v1.16.0) - Test framework
• backward-cpp (v1.6) - Stack trace generation

Quick Start

1. Add to your project (CMake)

include(FetchContent)
FetchContent_Declare(
    testcoe
    GIT_REPOSITORY https://github.com/nircoe/testcoe.git
    GIT_TAG v0.1.0
)
FetchContent_MakeAvailable(testcoe)

target_link_libraries(your_test_executable PRIVATE testcoe)

2. Use in your tests

#include <testcoe.hpp>

int main(int argc, char** argv) {
    testcoe::init(&argc, argv);
    return testcoe::run();
}

That's it! Run your tests and see the enhanced output.

Features

• Grid Visualization - Real-time progress on interactive terminals; a single, duplication-free summary when output is piped or redirected (e.g. CI logs)
• Crash Handling - Get stack traces when tests crash
• Color Support - Automatic terminal detection
• Test Filtering - Run specific tests or suites
• Zero Config - Works out of the box with Google Test

Examples

See the examples/ directory for demonstrations:

• Basic usage - Grid visualization
• Crash handling - Stack traces on crashes
• Test filtering - Running specific tests

Requirements

• C++23 or later
• CMake 3.14+
• Google Test (automatically included)

API Reference

// Initialize testcoe
testcoe::init(&argc, argv);

// Run all tests
testcoe::run();

// Run specific suite
testcoe::run_suite("MathTests");

// Run specific test
testcoe::run_test("MathTests", "Addition");

Documentation

• Architecture - How testcoe works internally
• Contributing - Development setup and guidelines
• Roadmap - Version history and future plans

License

MIT License - see LICENSE file for details.