JTeC is a tool that enables researchers to obtain testwise coverage for programs that run in the JVM.
It targets research in regression testing, such as test selection, prioritization, or flaky test analysis.
To analyze tests beyond code coverage, JTeC also supports instrumenting APIs that open external files (e.g., java.io
and java.nio),
connect to sockets (e.g., java.net.socket), or spawn threads or processes (e.g., java.lang).
Notably, JTeC thus doesn't rely on the Java SecurityManager, which is outdated and will be removed in newer JDKs.
The project is developed as part of the BMBF funded project Q-Soft by CQSE and TUM. JTeC is mainly developed by Raphael Noemmer and Daniel Elsner.
JTeC is built to be used with Maven Surefire and Failsafe. Therefore, the simplest way to use JTeC in a Maven project is through the JTeC Maven plugin:
<build>
<plugins>
<plugin>
<groupId>edu.tum.sse</groupId>
<artifactId>jtec-maven-plugin</artifactId>
<version>0.0.5-SNAPSHOT</version>
<executions>
<execution>
<goals>
<goal>jtec
</goal> <!-- Instrument all JVMs spawned by Maven Surefire/Failsafe that execute tests -->
<goal>report
</goal> <!-- Create reports for each Maven project the reactor after test execution -->
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>Then, execute your tests as you would normally do, by optionally providing arguments to JTeC:
$ mvn clean verify -fn -Djtec.opts="test.trace,sys.trace,cov.trace"After the command has finished, you'll find a JSON test report in each target/jtec directory, as well as the raw logs
created by JTeC.
If you want to have a single aggregated test report, e.g., in a Maven multi-module project, simply add
the jtec:report-aggregate goal to your command line:
$ mvn clean verify -fn -Djtec.opts="test.trace,sys.trace,cov.trace" jtec:report-aggregateIf you do not want to use JTeC's default instrumentation for JUnit (4/5) test cases, you may pass the
option test.instr=false, which prevents bytecode transformation for JUnit classes.
Instead, for JUnit5 projects,
the service loader mechanism is used
to dynamically register
a TestExecutionListener
.
For JUnit4 projects, you can register a
JTeC RunListener
with Maven
in your pom.xml as follows:
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId> <!-- same for failsafe -->
<version>3.0.0-M5</version>
<configuration>
<properties>
<property>
<name>listener</name>
<value>edu.tum.sse.jtec.instrumentation.testevent.JUnitTestEventListener</value>
</property>
</properties>
</configuration>
</plugin>├── jtec-agent <- The JTeC agent is a simple Java agent that can be parameterized and attached to a JVM process.
├── jtec-core <- The JTeC core package contains instrumentation and auxiliary code.
├── jtec-instrumentation <- The JTeC instrumentation package contains instrumentation code injected via the JTeC agent at runtime.
├── jtec-maven-plugin <- The JTeC maven plugin provides a utility to attach the agent to the tests of a Maven project.
└── jtec-sample-project <- A sample project that demonstrates how to use JTeC in a Maven multi-module project.
To build JTeC simply run:
$ mvn clean install This will build the code for all JTeC projects, run all tests, and install the JARs to your local Maven repository.
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent