What is it?

It is a small specific Maven plugin (of course it is relative small one because it of course will download and save on your machine a half-of-internet as dependencies) for specific testing tasks. Since 1.1.0 it allows annotations to mark tests, for annotations use jute-annotations artifact.

Changelog

1.1.1

• reworked test class path generating mechanism, removed usage of jcabi-aether because sometime it throws NPE with complex settings.xml

1.1.0

• reworked project structure
• added @JUteTest annotation to mark tests to be started with JUte (provided by the jute-annotations artefact)
• improvements in test result logging
• all tests every time alphabetically sorted in bounds of their order
• added support of parallel execution for tests with the same order value
• tests marked by @JUteTest support JUnit test life cycle - @BeforeClass @Before @After @AfterClass
• added support of 'skipTests' and 'maven.test.skip' properties, like in maven-surefire
• added support of 'jute.test' property to be used from command line, like 'test' in maven-surefire
• removed hard dependency to JUnit, now JUte can process tests and without JUnit as dependency
• added configuration parameter 'onlyAnnotated' to work only with JUte annotated test methods and classes

1.0.0

• initial version

What is the specific tasks?

Let's imagine that we want to write JUnit tests for some code which has so bizzare structure and architecture that it is very expensive to dig it and avoid influence of one test to another, may be it is a legacy code or just a system with very very complex behaviour. All your tests work separately but they are red in bunch execution.

In such situation you can use Jute. the Plugin works during test phase and executes all methods of JUnit tests as external separated processes. It finds all test methods marked as @Test and ignores all test methods marked by @Ignore. You can also exclude (or include) from its processing whole test classes or methods. Also it provides possibility to set different JRE for external processes start. Please remember that it works only with JUnit annotations.

How to bring Jute in my project?

It is very easy, the plugin has been published in the Maven Central and you can just add its reference in pom.xml

<build>
  <plugins>
...
    <plugin>
      <groupId>com.igormaznitsa</groupId>
      <artifactId>jute</artifactId>
      <version>1.1.1</version>
      <executions>
        <execution>
          <goals>
            <goal>jute</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
...
  </plugins>
</build>

after that JUte will be executing every test phase of your project during test phase.

How to use JUte annotations?

JUte annotations provided by jute-annotations artifact and you can just add it as dependency

<dependencies>
  <dependency>
    <groupId>com.igormaznitsa</groupId>
    <artifactId>jute-annotations</artifactId>
    <version>1.1.1</version>
    <scope>test</scope>
  </dependency>
</dependencies>

Tests to be processed by JUte should be marked by @com.igormaznitsa.jute.annotations.JUteTest but keep in memory that by default JUte processes and JUnit tests so if you want work only with @JUteTest marked tests then add <onlyAnnotated>true</onlyAnnotated> into JUte plugin configuration. If you have similar parameters in jute plugin configuration, then they will be overrided by parameters defined in the annotation.

@JUteTest(order=12,jvm="java",jvmOpts={"-Xss=10m","-Xmx256m"},timeout=3000,printConsole=true)
public void testSome() throws Exception {
...
}

#Test order Since 1.1.0 version, all test methods are sorted in ABC (case-sensetive) order, if you provide order parameter of annotation then tests with the same order value will be started in parallel.

@JUteTest
public void testA() throws Exception {
...
}
@JUteTest(order=2)
public void testB() throws Exception {
...
}
@JUteTest(order=2)
public void testC() throws Exception {
...
}

In the example tests B and C will be started in parallel and process will be continued only when both tests are completed and order of the testA is -1 by default and it will be executed as the first one.

Hey! I want to use it only for several classes!

No problems, just define name of your class in includes section of the plugin configuration

<build>
  <plugins>
...
    <plugin>
      <groupId>com.igormaznitsa</groupId>
      <artifactId>jute</artifactId>
      <version>1.1.1</version>
      <executions>
        <execution>
          <goals>
            <goal>jute</goal>
          </goals>
          <configuration>
            <includes>
              <include>/**/MyTestWhichShouldBeStartedInExternalProcess.java</include>
            </includes>
          </configuration>
        </execution>
      </executions>
    </plugin>
...
  </plugins>
</build>

In the case onle test methods defined in file named MyTestWhichShouldBeStartedInExternalProcess will be processed by Jute.

I don't want execute all tests, only a pair!

Ok! In the case you just should define names or a mask for your test method names.

<build>
  <plugins>
...
    <plugin>
      <groupId>com.igormaznitsa</groupId>
      <artifactId>jute</artifactId>
      <version>1.1.1</version>
      <executions>
        <execution>
          <goals>
            <goal>jute</goal>
          </goals>
          <configuration>
            <includes>
              <include>/**/MyTestWhichShouldBeStartedInExternalProcess.java</include>
            </includes>
              <includeTests>
                <includeTest>*JuteTest</includeTest>
              </includeTests>
          </configuration>
        </execution>
      </executions>
    </plugin>
...
  </plugins>
</build>

After that, only test methods suffixed by JuteTest will be executed by Jute.

It doesn't process my methods and I have not idea why!

In the case start your maven process with -X (it will turn on debug logging) and add <verbose>true</verbose> into Jute configuration

It prints console output only if there is an error! and I want see test output everytime!

No problems! Just add flag to enforce pring console output of external processes into maven log <enforcePrintConsole>true</enforcePrintConsole> and you will see external process console output every time.

I want to start only jute goal! How to do that?!

Just execute mvn test:jute and only jute goal will be executeed by maven for your project.