------
  Inclusions and Exclusions of Tests
  ------
  Allan Ramirez
  ------
  July 2006
  ------

Inclusions and Exclusions of Tests

* Inclusions

  By default, the Failsafe Plugin will automatically include all test classes
  with the following wildcard patterns:

   * <"**/IT*.java"> - includes all of its subdirectory and all java
   filenames that start with "IT".

   * <"**/*IT.java"> - includes all of its subdirectory and all java
   filenames that end with "IT".

   * <"**/*ITCase.java"> - includes all of its subdirectory and all java
   filenames that end with "ITCase".

   []

  If the test classes does not go with the naming convention, then configure
  Failsafe Plugin and specify the tests you want to include.

+---+
<project>
  [...]
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-failsafe-plugin</artifactId>
        <version>${project.version}</version>
        <configuration>
          <includes>
            <include>Sample.java</include>
          </includes>
        </configuration>
        <executions>
          <execution>
            <id>integration-test</id>
            <phase>integration-test</phase>
            <goals>
              <goal>integration-test</goal>
            </goals>
          </execution>
          <execution>
            <id>verify</id>
            <phase>verify</phase>
            <goals>
              <goal>verify</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
  [...]
</project>
+---+

* Exclusions

  There are certain times when some tests are causing the build to fail.
  Excluding them is one of the best workarounds to continue the build.
  Exclusions can be done by configuring the <<excludes>> property of the
  plugin.

+---+
<project>
  [...]
  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-failsafe-plugin</artifactId>
        <version>${project.version}</version>
        <configuration>
          <excludes>
            <exclude>**/CircleIT.java</exclude>
            <exclude>**/SquareIT.java</exclude>
          </excludes>
        </configuration>
        <executions>
          <execution>
            <id>integration-test</id>
            <goals>
              <goal>integration-test</goal>
            </goals>
          </execution>
          <execution>
            <id>verify</id>
            <goals>
              <goal>verify</goal>
            </goals>
          </execution>
        </executions>
      </plugin>
    </plugins>
  </build>
  [...]
</project>
+---+