Differences

This shows you the differences between two versions of the page.

--- codebase:testing [2024/09/28 22:56] – fponzi
+++ codebase:testing [2025/03/25 10:49] (current) – fponzi
@@ Line 1: / Line 1: @@
-====== Testing ======
+====== Building and running tests ======
+You will need ant build system. ''customBuild.xml'' supports different parameters to tune the tests. They can also be combined.
+===== customBuild.xml common commands ====
+  * compile: recompiles the production code for project. Required if you changed any code in src folder.
+  * compile-test: recompiles the test code for the project. Required if you updated any code test folder.
+  * test-set: by using the parameter ''-Dtest.testcases="tlc2/tool/InliningTest*"'' we can specify a single test to run. It also supports regexes.
+Example:
+<code>
+ant -f customBuild.xml compile compile-test test-set -Dtest.testcases="tlc2/tool/Github1109Test.java"
+</code>
+===== Running a test with a debugger =====
+''%%-Dtest.suspend=y%%'' will suspend the execution and give you time to hook up a debugger before running a test.
+<code>
+ant -f customBuild.xml compile-test test-set -Dtest.suspend=y -Dtest.testcases="tlc2/tool/InliningTest*"
+</code>
+===== Specify number of threads =====
+By default uses all your cores. You can specify a custom amount using ''%%-Dthreads=4%%'':
+<code>
+ant -f customBuild.xml test -Dthreads=4
+</code>
+===== Halt tests when a failure is found =====
+By default the test target will run all the test and report success or failure only at the end. It can be convinient to just stop execution as soon as an error is found, with''%%-Dtest.halt=true%%''.
+<code>
+ant -f customBuild.xml test -Dtest.halt=true
+</code>
 ===== test-dist: =====