JarCastingExperimental Object Oriented Testing Framework for Java
oot: 
Concepts
- Use single entry points for all tests
- Use composition to construct test cases
- Control test runs behavior in the code
- Write test-cases objects instead of classes with test functions
Prerequirements
Usage
Disable maven-surefire-plugin by adding skipTests property to configuration, add oot-maven-plugin and oot library dependency to pom.xml:
<project>
<dependencies>
<dependency>
<groupId>wtf.g4s8.oot</groupId>
<artifactId>oot</artifactId>
<!-- use latest release version or add snapshots repo -->
<version>1.0-SNAPSHOT</version>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<configuration>
<skipTests>true</skipTests>
</configuration>
</plugin>
<plugin>
<groupId>wtf.g4s8.oot</groupId>
<artifactId>oot-maven-plugin</artifactId>
<!-- use latest release version or add snapshots repo -->
<version>1.0-SNAPSHOT</version>
<executions>
<execution>
<goals>
<goal>test</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
Maven Plugin will be executed on test phase, supported properties are:
skipTests- disable tests (optional, defaultfalse)
It will search for public class with public static void test method, same as java cli searches for main method.
Hint: check ./oot-example project for real example Maven project.
To write first test, create public test class with method test:
public final MainTest {
public static void test() {
// run tests here
}
}
oot library use TestReport implementations to report test results and fail test phase on test failure. And TestCase implementation to wrap test logic:
public final MainTest {
public static void test() {
try (FailingReport report = new FailingReport(new ConsoleReport())) {
new SimpleTest<>("basic test", () -> 1 + 1, Matchers.is(2));
}
}
}
In this example:
FailingReportwill failtestphase after all tests if any test failsConsoleReportwill print all test results to stdoutSimpleTest- generic object to apply Hamcrest matcher to target object
To run multiple tests sequentially use:
new SequentialTests(
new FooTest(),
new BarTest(),
new BazTest()
)
To run it parallelly use:
new ParallelTests(
new FooTest(),
new BarTest(),
new BazTest()
)
Decorating
TestCase has default decorator TestCase.Wrap. It can be used to move all tests composition into main test constructor:
public final class MainTest extends TestCase.Wrap {
private MainTest() {
super(
new ParallelTests(
new TestOne(),
new TestTwo(),
new TestThree()
)
);
}
public static void test() throws IOException {
try (FailingReport report = new FailingReport(new ConsoleReport())) {
new MainTest().run(report);
}
}
}