summaryrefslogtreecommitdiff
path: root/doc/testing.txt
diff options
context:
space:
mode:
authorMarius Kintel <marius@kintel.net>2011-11-26 18:25:31 (GMT)
committerMarius Kintel <marius@kintel.net>2011-11-26 18:25:31 (GMT)
commit6e030b571639be3336a5b34bd2404a7dea54aebd (patch)
treeb1f3fe1a2bb4f46697d096070abb254018e92cb0 /doc/testing.txt
parent07800da50835e63e9d554fab948ff27da9846a36 (diff)
Updated testing docs
Diffstat (limited to 'doc/testing.txt')
-rw-r--r--doc/testing.txt50
1 files changed, 32 insertions, 18 deletions
diff --git a/doc/testing.txt b/doc/testing.txt
index b2974fc..66ceac2 100644
--- a/doc/testing.txt
+++ b/doc/testing.txt
@@ -3,32 +3,46 @@ Running regression tests:
Prerequisites: cmake, python
-cd tests
-mkdir build
-cd build
-cmake ..
-make
-make test
+A) Building test environment
-Running on Windows:
+Linux, Mac:
+$ cd tests
+$ cmake .
+$ make
+
+Windows:
First, get a normal build working by following instructions at
http://en.wikibooks.org/wiki/OpenSCAD_User_Manual/Building_on_Windows
Then, from the QT command prompt:
-cd tests
-mkdir build
-cd build
-cmake .. -DCMAKE_BUILD_TYPE=Release
-sed -i s/\/MD/\/MT/ CMakeCache.txt
-cmake ..
-nmake -f Makefile
-nmake -f Makefile test
+$ cd tests
+$ cmake . -DCMAKE_BUILD_TYPE=Release
+$ sed -i s/\/MD/\/MT/ CMakeCache.txt
+$ cmake .
+$ nmake -f Makefile
+
+B) Running tests
+
+Easy version:
+$ make test
+
+Windows:
+$ nmake -f Makefile test
-Running on headless (no X) servers:
+Headless servers (no X11):
+$ Xvnc :5 -screen 0 800x600x24 &
+$ DISPLAY=:5 make test
-Xvnc :5 -screen 0 800x600x24 &
-DISPLAY=:5 make test
+Partial or extended test runs:
+$ ctest Runs tests enabled by default
+$ ctest -R <regex> Runs only matching tests, e.g. ctest -R dxf
+$ ctest -C <configs> Adds extended tests belonging to configs.
+ Valid configs:
+ Default - Run default tests
+ Heavy - Run more time consuming tests (> ~10 seconds)
+ Examples - test all examples
+ All - test everything
Adding a new regression test:
contact: Jan Huwald // Impressum