TDOG is a lightweight, portable and open source C++ xUnit Testing Framework.
C++ Makefile HTML
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bcc
doc
inc
mvc
src
LICENSE
NOTICE
README
makefile
makefile.conf
makefile.readme
makevars.conf
selftest.conf

README

#############################################################################
PROJECT     : TDOG C++ xUnit Testing Framework
COPYRIGHT   : Kuiper (c) 2016
LICENSE     : Apache 2.0
WEBSITE     : kuiper.zone
#############################################################################


###############################
ABOUT TDOG
###############################

TDOG is a lightweight, portable and open source C++ xUnit Testing
Framework. It features:

 - Macros for easy unit test creation
 - C++ namespaced test suites (test groups)
 - Test fixtures
 - Test, suite & global level setup/teardown
 - Repeated tests
 - Multi-report generation:
   - Text
   - HTML
   - JUnit/Jenkins compatible XML
 - Comprehensive range of asserts macros
 - Test specific and global time limits
 - Test time warnings
 - Exceptions (i.e. "throw" and "no throw" tests)
 - Not dependent on RTTI
 - Lightweight & highly portable
 - No dependencies on other libraries or tools
 - Comprehensive documentation
 - Unencumbered open source license

TDOG is maintained for g++ for LINUX, MSVC and MinGW on Windows.

See https://kuiper.zone for documentation.


###############################
BUILDING
###############################

To build the TDOG static library on LINUX, from the "tdog" directory, simply call:

make

Then build the self-test application, with:

make CONF=selftest.conf

Alternatively, to build everything in one step, use:

make rebuildall CONF=selftest.conf

Under MinGW on Windows, use "mingw32-make" instead.

This will build a "release" version of the software. To build with debug
information, append "TARGET=debug" to the above. You can also cross-compile
for both 32 and 64 bits by appending "ARCH=32" or "ARCH=64". See the
"makefile.readme" for more information about the make configuration.

Project files also exist for MSVC 2013, under the "mvc" directory. These
target MD and MT, 32 and 64 bit, and "release" and "debug".

TDOG uses the STL and exceptions. However, it does not need RTTI (run-time
type indentification) or C++11 features.

Once built, you can run the binary under the "bin" directory to perform
a self-test of the framework. Test reports will be generated to the
"bin/reports" directory. Run "selftest" directly from "bin", so that
this is the working directory. The tests will generate one "warning",
which is intentional.


###############################
RELEASE NOTES
###############################

Version 3.1 - Updated and moved website to kuiper.zone.

Version 3.0 - First public release of TDOG.


###############################
PLATFORMS
###############################

I've built and tested TDOG under the following platforms:

CentOS 6 -    g++ 4.4.7 (32 bit)
CentOS 7 -    g++ 4.8.5 (64 bit)
Fedora 23 -   g++ 5.3.1 (64 bit)
Windows 10 -  TDM64 g++ 5.1.0 (32 and 64)
Windows 10 -  MSVC 2013 (32 and 64)
Windows XP -  Ancient Borland BCB 5 (32 bit)

Kuiper