Punner

Punner is a new parallel JUnit test runner saves your waiting time:

• Usually we have multiple cpu cores.
• We usually have to write test cases contains "sleep" or "wait" to check async results.

Punner also provide good isolation for paralleled running test cases:

• Seperated & clear log outputs. All test logs will NOT be mixed together like other thread based parallel test runners, even in your favorite IntellJ.
• No multi-thread conflict. It is not encouraged to use static or global shared variables which may cause conflict in multiple thread scenario, but if your legacy code can work well with default(seqencial) test runner, it can work with Punner without modifications.

I have used Punner in some projects, usually it can make 2~15x speedup based on test case and cpu cores.

Install

mvn install

Usage

Punner Runner

If you want to enable Punner in your IDE's JUnit Launcher, you can use @RunWith annotation.

Add Punner dependency in your pom file:

<dependency>
  <groupId>com.github.marks-yag</groupId>
  <artifactId>punner</artifactId>
  <version>${version}</version>
</dependency>

Kotlin:

import com.github.yag.punner.core.Punner

@RunWith(Punner::class)
class Fun {}

Java:

import com.github.yag.punner.core.Punner

@RunWith(Runner.class)
class Fun {}

Then you can run your test cases in IDE with Punner.

Punner Maven Plugin

<!-- Disable default surefire based testing -->
<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>2.20</version>
  <configuration>
    <skip>true</skip>
  </configuration>
</plugin>

<plugin>
  <groupId>com.github.marks-yag</groupId>
  <artifactId>punner-maven-plugin</artifactId>
  <version>${version}</version>
  <configuration>
  </configuration>
  <executions>
    <execution>
      <id>test</id>
      <phase>test</phase>
      <goals>
        <goal>test</goal>
      </goals>
    </execution>
  </executions>
</plugin>

Configurations

Utilities

Punner also provide some useful utility function for unit test:

Eventually

eventually(5000) {
    Assert.assertTrue(job.done())
}

Aways

always(5000) {
    Assert.assertTrue(consistency.ok())
}

Delay

setTimeout(3000) {
    queue.resize(10)
}

Probability

repeat(1000) {
    probability(0.01) {
        injectTimeout()
    }.otherwise {
        injectError()
    }
}