FitNesse
Welcome to FitNesse, the fully integrated stand-alone acceptance testing framework and wiki.
To get started, check out http://fitnesse.org!
Quick start
Bug tracker
Have a bug or a feature request? Please open a new issue.
Community
Have a question that's not a feature request or bug report? Join the Slack Community.
Edge builds
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 fitnesse.jar
.
Developers
Issues and pull requests are administered at GitHub.
Building
A proper internet connection is sufficient to build FitNesse. The build process will bootstrap itself by downloading Gradle and from there will download the dependencies required to build and test FitNesse.
To build and run all tests, run the command
$ ./gradlew
which builds the all
target.
NB. On windows call gradlew.bat
instead of ./gradlew
.
Running
To start the FitNesse wiki locally, for example to browse the local version of the User Guide
$ ./gradlew run
Testing
To run the unit tests:
$ ./gradlew test
To run the acceptance tests:
$ ./gradlew acceptanceTest
Direct any questions to the Slack Community..
Working with Eclipse and IntelliJ
There are a few things to keep in mind when working from an IDE:
-
The Gradle build 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.
Perform a
$ ./gradlew copyRuntimeLibs
to execute the copy action. 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.
Import FitNesse in Eclipse
- Clone the FitNesse Git repository from https://github.com/unclebob/fitnesse.
- Import FitNesse via File -> Import... -> Gradle Project.
- Select the just cloned project folder. Follow the wizard.
- Ensure the project properties have a Java 8 compiler or newer set.
Import FitNesse in IntelliJ IDEA (16)
- Clone the FitNesse Git repository from https://github.com/unclebob/fitnesse.
- From the welcome screen (the one you get when all projects are closed), click Import Project.
- Select the file
build.gradle
in the fitnesse folder. - Follow the wizard. Deselect the option
Create separate module per source set
. You can use theUse gradle wrapper task configuration
. Use Java 8 or newer. It should find source and test folders and show you two modules:fitnesse
and:buildSrc
; import both. - Open the Gradle Build tool, select the task
copyRuntimeLibs
and (right-click) mark it as Execute After Make.
The release process
Software artifacts (the FitNesse jar, the standalone jar and POM files) are uploaded to Bintray. There are two repositories:
- Edge contains snapshot builds
- Release contains the official release builds.
In both cases you'll need sufficient permissions to perform a release.
Edge builds
Edge builds can be done at any time
$ ./gradlew snapshotRelease
Release builds
Release builds denote "blessed" releases. Those are tagged in Git along with being released. The releases will be available from both Maven Central and JCenter.
$ ./gradlew release