a concolic testing engine for Java
Java Groovy Other
Switch branches/tags
Clone or download
Latest commit 80a53b1 Feb 20, 2018
Permalink
Failed to load latest commit information.
.idea updated LICENSE file. Sep 14, 2012
src test: add a class that trigger bug Feb 14, 2018
testdata new testdata Jan 14, 2013
tests/database/table updated LICENSE file. Sep 14, 2012
.travis.yml Added gradle build file, Travis configuration, setup script and updat… Oct 17, 2015
COPYRIGHT COPYRIGHT and LICENCE placeholders Jul 5, 2012
Janala.iml changed API for data annotations Jan 15, 2015
LICENSE Fixed CastException bug. Sep 14, 2012
Manifest.txt first commit Jun 3, 2012
README.md fixed bug related to emma coverage Jul 25, 2017
asmify updated LICENSE file. Sep 14, 2012
build.gradle Added gradle build file, Travis configuration, setup script and updat… Oct 17, 2015
build.xml Update build.xml Mar 13, 2015
catg.conf Integrated with emma coverage tool Jan 15, 2015
concolic direct concolic execution mode (single phase) implemented. See ./dcon… Mar 2, 2014
concolic.cygwin string constraints Nov 30, 2012
concolic.py fixed bug related to emma coverage Jul 25, 2017
dconcolic direct concolic execution mode (single phase) implemented. See ./dcon… Mar 2, 2014
janala.pptx partly ported to cvc4. some tests are failing. May 24, 2014
setup.sh Added gradle build file, Travis configuration, setup script and updat… Oct 17, 2015
testall Prediction failure is now handled by backtracking. Mar 8, 2014
testall.py fixed bugs in path regex annotations and state equivalence annotation… Jan 14, 2015
tracify updated LICENSE file. Sep 14, 2012

README.md

CATG

CATG is a concolic unit testing engine for Java programs. The implementation uses ASM for instrumentation. ASM instrumentation instruments (see janala.instrument.) class files at runtime and dumps (see janala.logger.) to a file a log of all instructions executed by the program and all values loaded from local stacks and heaps. A concolic execution engine (see janala.interpreters.*) then takes the log and performs both symbolic and concrete interpretation of the logged instructions.

You must have java, gradle, cvc4 (http://cvc4.cs.nyu.edu/downloads/), and python 2.7 in your PATH. Two extra jar files are needed to run the tool. Create a lib directory in the root directory and download the following jar files

place them in the lib directory. Then invoke

gradle build

and

gradle integrationTest

To run the the full integration tests, use

./setup.sh  # This builds CATG and copy it to lib/
python testall.py

To run tests and see coverage report, use

gradle build
gradle jacocoTestReport

This runs the tests using online concolic execution. To run tests with offline concolic execution, use

python --offline testall.py

If you want to generate tests on a Java class file having a main method, you need to use the concolic.py script. For example, the following command generates test inputs for the class tests.Testme (the java source of this class can be found in src/integration/java/tests/Testme.java.

python concolic.py --coverage 100 tests.Testme

Usage

python janala/concolic.py -h usage: concolic.py [-h] [--offline] [-v] [-c] [-D D] maxIterations className [arguments [arguments ...]]

positional arguments:

maxIterations   Maximum number of times the program under test can be
              executed.
className       Java class to be tested.
arguments       Arguments passed to the program under test.

optional arguments:

-h, --help      show this help message and exit
--offline       Perform concolic testing offline. An intermediate trace file
              is generated during the execution of the program. offilne
              mode results in 2X slowdown that non-offline mode
-v, --verbose   Print commands that are executed.
-c, --coverage  Compute detailed coverage by rerunning tests.
-D D            JVM options