From fe88595a0b5b86fd4a9cd65b86aefdb19edd15cc Mon Sep 17 00:00:00 2001 From: Tobias Klauser Date: Thu, 28 Oct 2010 12:05:40 +0000 Subject: unittest: Add README git-svn-id: https://parma.zhaw.ch/svn/csnippets@4 bb4c1ae6-6eb5-4d93-a66e-2307d6765a9c --- unittest/README | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 unittest/README diff --git a/unittest/README b/unittest/README new file mode 100644 index 0000000..6997f68 --- /dev/null +++ b/unittest/README @@ -0,0 +1,33 @@ + README for unittest csnippet +============================== + +This is a simple unit testing framework for C code. The header unittest.h +contains all assertion functions to use in your unit test. A python script - +runtest.py - is used to to run all unit tests passed to it and print their +respective result. + +The basic usage is as follows: + +1) Create your unit test using the following skeleton code: + +#include "unittest.h" + +int main(int argc, char **argv) +{ + return TEST_PASS; +} + +2) Add some assertions testing your code. You might need to include further + headers. + +3) Compile the unit test, linking it against the code you want to test. + Alternatively your unit test could also be part of the software your writing + and activated/deactivated through preprocessor macros. + +4) Run the unit test either manually or using runtest.py: + + ./runtest.py + + When manually running the unit test, it returns 0 if the test was passed and + 1 if there was an assertion error. Additionally an error message is printed + on the first assertion error. -- cgit v1.2.3-54-g00ecf