kbruch/testcases/README

   1 In this directory I will store the testcases for KBruch. A file containing a
   2 test suite for a "class" has the following file name:
   3
   4 "class"_test.cpp
   5
   6 In this file there is a class (struct) named "class"_test_suite and the class
   7 containing the test cases. This class is called "class"_test. Every member
   8 function of the original class is tested in a seperated member function of the
   9 "class"_test class. Those functions are named
  10
  11 "class"_test::test_"memberFunction"() {...}
  12
  13 Before you can compile it, you have to make symlinks from the source directory
  14 to this directory. The simplest way is to use the following bash script:
  15
  16 -----SNIP-----
  17
  18 #!/bin/bash
  19
  20 # save the current directory
  21 #
  22 current=`pwd`
  23
  24 # delete all symbolic links
  25 #
  26 rm `find . -type l`
  27
  28 # now go the source directory
  29 #
  30 cd ../src
  31
  32 echo "Createing symlinks to the source files..."
  33
  34 # make a symlink from every *.cpp file to this directory
  35 #
  36 for a in `ls *.cpp`
  37 do
  38    ln -s ../src/$a ../testcases/$a
  39 done
  40
  41 # make a symlink from every *.h file to this directory
  42 #
  43 for a in `ls *.h`
  44 do
  45    ln -s ../src/$a ../testcases/$a
  46 done
  47
  48 # and back to the testcases directory
  49 #
  50 cd $current
  51
  52 -----SNIP-----
  53
  54 And you need the boost library installed. I think this will be the hardest
  55 thing. You can get boost from http://www.boost.org/
  56
  57 If you want to compile the whole tests not under Linux using gcc, you maybe
  58 have to edit the Makefile.am in this directory to correctly link against
  59 libboost_unit_test_framework-YOURCOMPILER. Edit the following line in
  60 Makefile.am:
  61
  62 kbruch_test_LDADD   = -lboost_unit_test_framework-gcc $(LIB_KDEUI)
  63
  64 I hope someone finds a portable way to do this Makefile stuff. Please fix it,
  65 I'm not a Automake/Autoconf guru!
  66
  67 You can compile the test program by typing:
  68
  69 make check
  70
  71 If you were able to compile it, you can execute the test case program
  72 kbruch_test from within this directory.
  73
  74 I hope this helps a little bit.
  75
  76 Sebastian Stein <seb.kde@hpfsc.de>