jaltmayerpizzorno / JustUnit

Minimalistic framework for JUnit-like tests in C++

JustUnit: minimalistic framework for JUnit-like tests in C++

How to use

Create a test class like this:

...
#include "JustUnit.hxx"

class MyTestClass : public JustUnit::TestClass {
 public:
  JU_TEST(testSomething) {
    Foo foo;
    ju_assert_eq(42, foo.bar(), "foo.baz=" << foo.baz);
  }
  
  JU_TEST(testSomethingElse) {
    ju_assert(false, "test missing, write me!");
  }
  
  ...

} myTestClass;

and then compile/link it with JustUnit, e.g.:

g++ --std=c++11 ... -o tests mytestclass.cxx JustUnit.cxx

The JustUnit.cxx part is optional; currently it only provides a main() that invokes JustUnit::TestClass::runAll(), to run all test methods in all test classes. (I use constructors creatively to compensate for the lack of reflection).

That last parameter in the assertions is passed to a stream, so you can easily customize the assertion failure message, adding those details about the test you will wish you had once you see a failure. See JustUnit.hxx for details.

This should work with C++11 and later; I didn't test with earlier versions.

History

Years ago I co-developed a test framework while leading Port25. I was recently writing some C++ and wished I had that still, so I whipped this one together. This one is free, so use if you like it :)