FitNesse -- The Acceptance Test Wiki
Java JavaScript CSS Other
Clone or download
Pull request Compare This branch is 15 commits ahead, 2888 commits behind unclebob:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.idea
FitNesseRoot
crap4j
dotnet
extra
lib
plugins
src
srcFitServerTests/fit
srcSlimPortTests
templates
.classpath
.gitignore
.project
CONTRIBUTING.md
README.md
build.xml
config
crap4j_build.xml
fitnesse.iml
installer.xml
ivy.xml
ivysettings-sonatype.xml
ivysettings.xml
licenseHeader.txt
parserTokens.txt
plugins.properties
testability.sh

README.md

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? Ask on the mailing list.

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

Check out the FitNesse Story Backlog and Issue Tracking on Pivotal Tracker.

Building

The 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

$ ant

which builds the all target.

Testing

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 under the src directory.

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:

  1. The ant build generates two files from the templates in the "templates" directory:

    • FrontPage.content.txt.template is used to generate FitNesseRoot/FrontPage/context.txt;
    • FitNesseVersion.java.template is used to generate src/fitnesse/FitNesseVersion.java.

    You can execute

    $ ant all
    

    to generate those files.

  2. Apache Ivy is used for dependency management. You can either install an Ivy plugin in your preferred IDE or run

    $ ant retrieve
    

    that will download the dependencies and copy them to lib/, from where your IDE can pick them up.

.NET Support (8/6/2008)

We re-installed the dotnet/.dll and dotnet/.exe files, taking them from the fitnessedotnet release on Sourceforge. This will allow the .NET Acceptance Tests to run right out of this distribution. However, you should consider using FitSharp. See the page FitNesseRoot/FitNesse/DotNet/context.txt for more information.