EasyUnit
- An easy C++ unit testing framework
EasyUnit
a unit testing
framework for C++ which is extremely simple and easily customizable;EC++ compatible for embedded version (no STL, RTTI, multiple inheritance
and exceptions);no boilerplate code : 0 line, none, niet, nada;results
output and test execution are entirely customizable;default configuration are optimized for general needs;based
on Michael Feathers' CppUnitLite framework.
EasyUnit
: Simple, Easy, Efficient
EasyUnit was created to ease creation and use of unit testing in C++.
Most of the existing frameworks ask programmers to create objects and use macros to administer test cases in addition to write their own test cases. It is the author belief that boilerplate code and taking care of test administration discourage programmers
and students to use unit testing even if it is representing one line of code per test case.
EasyUnit
: Embedded and Standard version
EasyUnit is delivered
in two versions:EasyUnit embedded version is fully compatible with EC++ and contains only a minimum of classes.EasyUnit
standard version adds exception handling and more customization. Key differences from embedded version are:Exceptions detection. This makes
EasyUnit incompatible with EC++.More testprinters (output customization) and testrunners (testcase filter). Those add-ons are available
in a separate package for the embedded version.
EasyUnit
Examples (v. 1.0 Beta2)
Simple example
// Stack.h
class Stack {
public:
int size();
bool isEmpty();
};
|
// Stack.cpp
#include "Stack.h"
int Stack::size() { return 0; }
bool Stack::isEmpty() { return true; }
|
|
// StackTest.cpp
#include "easyunit/test.h"
#include "Stack.h"
using namespace easyunit;
TEST(Stack,size)
{
Stack s;
ASSERT_TRUE(s.size() == 1);
}
TEST(Stack,isEmpty)
{
Stack s;
ASSERT_TRUE(s.isEmpty());
}
|
// main.cpp
#include "easyunit/testharness.h"
using namespace easyunit;
int main()
{
TestRegistry::runAndPrint();
} |
// Console output:
-- EasyUnit Results --
SUMMARY
Test summary: FAIL
Number of test cases ran: 1
Test cases that succeeded: 0
Test cases with errors: 0
Test cases that failed: 1
DETAILS
Test case "Stack" FAILED with 0 error(s), 1 failure(s) and 1 success(es):
Test "size" FAILED :
Failure: "s.size() == 1" line 11 in StackTest.cpp
Test "isEmpty" SUCCEEDED!
|
|
Example with fixtures
// Stack.h
class Stack {
public:
int size();
bool isEmpty();
};
|
// Stack.cpp
#include "Stack.h"
int Stack::size() { return 0; }
bool Stack::isEmpty() { return true; }
|
// Queue.h
class Queue {
public:
void setSize(long s) {size_ = s);
long size() {return size_;}
bool isEmpty() {return true;}
private:
long size;
};
|
// QueueTest.cpp
#include "easyunit/test.h"
#include "Queue.h"
using namespace easyunit;
DECLARE(CustomQueue)
Queue *q;
END_DECLARE
SETUP(CustomQueue)
{
q = new Queue();
q->setSize(100);
}
TEARDOWN(CustomQueue)
{
delete q;
}
TESTF(CustomQueue,test1)
{
ASSERT_TRUE(q->isEmpty());
ASSERT_TRUE(q->size() == 0);
}
TESTF(CustomQueue,test2)
{
FAIL_M("Buffer overflow");
}
|
|
// StackTest.cpp
#include "easyunit/test.h"
#include "Stack.h"
using namespace easyunit;
TEST(Stack,size)
{
Stack s;
ASSERT_TRUE(s.size() == 0);
}
TEST(Stack,isEmpty)
{
Stack s;
ASSERT_TRUE(s.isEmpty());
}
|
// main.cpp
#include "easyunit/testharness.h"
using namespace easyunit;
int main()
{
TestRegistry::runAndPrint();
} |
// Console output:
-- EasyUnit Results --
SUMMARY
Test summary: FAIL
Number of test cases ran: 2
Test cases that succeeded: 1
Test cases with errors: 0
Test cases that failed: 1
DETAILS
Test case "Stack" SUCCEEDED with 0 error(s), 0 failure(s) and 2 success(es):
Test "size" SUCCEEDED!
Test "isEmpty" SUCCEEDED!
Test case "CustomQueue" FAILED with 0 error(s), 2 failure(s) and 0 success(es):
Test "test1" FAILED :
Failure: "q->size() == 0" line 26 in QueueTest.cpp
Test "test2" FAILED :
Failure: "Buffer overflow" line 31 in QueueTest.cpp
|
|
