Writing a test for the Maven fitnesse plugin

Question

I just installed the fitnesse-launcher-maven-plugin from uk.co.javahelp.fitnesse and I can see it runs fine.

Now I'd like to write some tests and have them seen and executed during the build.

My pom.xml file contains the following plugin:

  <profiles>
    <profile>
      <id>wiki</id>
      <build>
        <plugins>
          <plugin>
            <groupId>uk.co.javahelp.fitnesse</groupId>
            <artifactId>fitnesse-launcher-maven-plugin</artifactId>
            <version>1.4.2</version>
            <executions>
              <execution>
                <goals>
                  <goal>set-up</goal>
                  <goal>wiki</goal>
                  <goal>tear-down</goal>
                </goals>
              </execution>
            </executions>
          </plugin>
        </plugins>
      </build>
    </profile>
    <profile>
      <id>auto</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <build>
        <plugins>
          <plugin>
            <groupId>uk.co.javahelp.fitnesse</groupId>
            <artifactId>fitnesse-launcher-maven-plugin</artifactId>
            <configuration>
              <failIfNoTests>false</failIfNoTests>
            </configuration>
            <executions>
              <execution>
                <goals>
                  <goal>set-up</goal>
                  <goal>run-tests</goal>
                  <goal>tear-down</goal>
                  <goal>verify</goal>
                </goals>
              </execution>
            </executions>
          </plugin>
        </plugins>
      </build>
    </profile>
  </profiles>

Following the plugin website documentation at

http://fitnesse-launcher-maven-plugin.googlecode.com

I have also created the following directories and empty (for now) files:

stephane@stephane-ThinkPad-X301:toolbox> tree src/test/java/fitnesse/
src/test/java/fitnesse/
├── FirstTestSuite
│   ├── content.txt
│   ├── NestedSuite
│   │   ├── AnIndividualTest
│   │   │   ├── content.txt
│   │   │   └── properties.xml
│   │   ├── content.txt
│   │   └── properties.xml
│   ├── properties.xml
│   └── Setup
│       ├── content.txt
│       └── properties.xml
└── plugins.properties

If running the command:

mvn verify -P wiki

then I can see at

http://localhost:9123/

some default Fitnesse tests which are not mine.

On the other hand, if I execute the command:

mvn verify

then there are no tests to be executed:

[INFO] Executed tasks
[INFO] 
[INFO] --- fitnesse-launcher-maven-plugin:1.4.2:run-tests (default) @ toolbox ---
[INFO] ------------------------------------------------------------------------
[INFO] Setting FitNesse variable [maven.classpath] to [
!path /home/stephane/dev/java/projects/toolbox/target/test-classes
!path /home/stephane/dev/java/projects/toolbox/target/classes
!path /home/stephane/.m2/repository/org/fitnesse/fitnesse/20140201/fitnesse-20140201.jar
!path /home/stephane/.m2/repository/org/htmlparser/htmlparser/2.1/htmlparser-2.1.jar
!path /home/stephane/.m2/repository/org/htmlparser/htmllexer/2.1/htmllexer-2.1.jar
!path /home/stephane/.m2/repository/org/apache/velocity/velocity/1.7/velocity-1.7.jar
!path /home/stephane/.m2/repository/commons-collections/commons-collections/3.2.1/commons-collections-3.2.1.jar
!path /home/stephane/.m2/repository/commons-lang/commons-lang/2.4/commons-lang-2.4.jar
!path /home/stephane/.m2/repository/org/json/json/20090211/json-20090211.jar
!path /home/stephane/.m2/repository/com/googlecode/java-diff-utils/diffutils/1.2.1/diffutils-1.2.1.jar
!path /home/stephane/.m2/repository/org/eclipse/jgit/org.eclipse.jgit/2.3.1.201302201838-r/org.eclipse.jgit-2.3.1.201302201838-r.jar
!path /home/stephane/.m2/repository/com/jcraft/jsch/0.1.46/jsch-0.1.46.jar
]
[INFO] Setting FitNesse variable [org.springframework.version] to [4.2.0.RELEASE]
[INFO] Setting FitNesse variable [java.version] to [1.8.0_60]
[INFO] Setting FitNesse variable [org.springframework.security.version] to [3.2.5.RELEASE]
[INFO] Setting FitNesse variable [project.build.sourceEncoding] to [UTF-8]
[INFO] Setting FitNesse variable [artifact] to [toolbox]
[INFO] Setting FitNesse variable [version] to [0.0.1-SNAPSHOT]
[INFO] Setting FitNesse variable [basedir] to [/home/stephane/dev/java/projects/toolbox]
[INFO] ------------------------------------------------------------------------
[WARNING] No FitNesse Suites or Tests to run! (Set -Dfitnesse.fitnesse.failIfNoTests=false to ignore.)
[INFO] 0 right, 0 wrong, 0 ignored, 0 exceptions
[INFO] 
[INFO] --- fitnesse-launcher-maven-plugin:1.4.2:tear-down (default) @ toolbox ---
[INFO] 
[INFO] --- fitnesse-launcher-maven-plugin:1.4.2:verify (default) @ toolbox ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 8.061 s
[INFO] Finished at: 2015-10-26T10:25:17+01:00
[INFO] Final Memory: 19M/205M
[INFO] ------------------------------------------------------------------------
stephane@stephane-ThinkPad-X301:toolbox>

I would like to write a very simple Java test with a Slim fixture, say to check that my business logic add(2, 2) method returns 4.

In which file should I have my wiki test ? In which file should I have my fixture ? How to tell Fitnesse to execute my test ?

UPDATE: My example fixture is:

public class ExampleFixture {

    private String value;
    private String result;

    public ExampleFixture() {
    }

    public void execute() {
        if (value != null) {
            result = Common.trimSpaces(value);
        }
    }

    public void setValue(String value) {
        this.value = value;
    }

    public String getResult() {
        return result;
    }

}

and its content:

|Example fixture|
|value|result?|
|some space|somespace|

The last issue, the one about the result[0] not being found, was due to my getter reading result instead of getResult in the fixture content, which now reads: |Example fixture| |value|getResult?| |some space|somespace|

Answer 1

You have placed your fitnesse code under src/test/java/fitnesse/

The default location is actually: src/test/fitnesse/ (Remove the java)

Alternatively, in your pom.xml, configure the directory you wish to use:

<testResourceDirectory>src/test/fitnesse</testResourceDirectory>

See Plugin Configuration docs.

---

Update:

Since googlecode has been decommissioned, the archive site returns a 404 for some links. I may get around to fixing that some day. Meanwhile, the project is available on Github. If you run maven site and access the created HTML with a browser, the docs should all be complete.