Welcome to FitNesse, the fully integrated stand-alone acceptance testing framework and wiki.
To get started, check out http://fitnesse.org!
Have a bug or a feature request? Please open a new issue.
Have a question that's not a feature request or bug report? Ask on the mailing list.
The latest stable build of FitNesse can be downloaded here.
Note: the edge Jenkins build produces 2 jars.
fitnesse.jar is for use in Maven or Ivy. Users who just want to run FitNesse by itself should download
fitnesse-standalone.jar instead of
Check out the FitNesse Story Backlog and Issue Tracking on Pivotal Tracker.
build.xml and a proper internet connection is sufficient to build FitNesse.
The build process will bootstrap itself by downloading Ivy (dependency management) and from there will download the modules required to build and test FitNesse.
To build and run all tests, run the command
which builds the
To start the FitNesse wiki locally, for example to browse the local version of the User Guide
$ ant run
To run the unit tests:
$ ant unit_test
To run the acceptance tests:
$ ant acceptance_tests
There is a second source directory,
srcFitServerTests, which contains units
tests that test invocation of Fit servers written in Ruby, C++, and .NET. These
tests are not run as part of the normal ant test-related targets. When using an
IDE, make sure it does not invoke these tests when running the "normal" tests
Direct any questions to the FitNesse yahoo group or to unclebob.
Working with Eclipse and IntelliJ
There are a few things to keep in mind when working from an IDE:
The Ant build file does some extra things apart from compiling the code.
- It sets the FitNesse version in a META-INF/FitNesseVersion.txt
- It copies the dependencies to the lib folder so they can be used by the acceptance tests.
$ ant post-compile
to execute those actions. In your IDE it is possible to define "post-compilation" steps. If you set the "post-compile" target from the build file, you won't have any trouble with cleaning, building and executing tests from your IDE.
Apache Ivy is used for dependency management. Your IDE can be set up to support Ivy.
- In IntelliJ set IvyIDEA in "Project Structure" -> "Modules" -> "Dependencies".
- In Eclipse, install IvyDE and set it up.
$ ant retrieve
will download the dependencies and copy them to lib/, from where your IDE can pick them up.