FitLibrary For FitNesse

This contains the latest release of the FitLibrary for FitNesse users.

Note the change to the name of the fitlibrary jar to fitlibrary-2.0.jar, which requires a change to your path in FitNesse, as shown below.

This release of FitLibrary needs to be added to a FitNesse system before it can be used.
FitLibrary has been tested with the FitNesse release 20110104. Some parts, such as batch running and load-defined-actions-slowly, will not work with earlier versions of FitNesse.
The FolderRunner parts of FitLibrary have not been tested with this version.
In the following, it's assumed that you are already familiar with FitNesse.

FitNesse configuration for using FitLibrary

To run FitLibrary from Fitnesse, it is necessary to include the following in your test page or in one of it's ancestor pages (notice the change here):

!path fitlibrary-2.0.jar
!path fitnesse.jar
!path lib/*.jar
!define TEST_RUNNER {fitlibrary.suite.FitLibraryServer}

Note the !path for the lib directory, which needs to contain log4j-1.2.16.jar for FitLibrary to work.

Latest Changes to FitLibrary

See the page .FitLibrary.WhatIsNew for details of the latest changes, along with links to the corresponding specifications.

Supplied FitLibrary files

The fitnesse directory within the FitLibrary release contains the following files and subdirectories (notice the change in name of the fitlibrary jar file):

  build.xml - Ant build file for FiLibrary
  fitnesse
    fitLibrary-2.0.jar
    run.bat
    FitLibraryLogger.properties -- properties for logging
    FixturingLogger.properties
    log4j.properties
    FitNesseRoot
        files
            dots
                -- files used in graphics examples
            gameImages
                -- files used in graphics examples
        FitLibrary
            UserGuide
                 -- Pages for the user guide
            SpecifiCations
                 -- Pages for storytests that specify FitLibrary
     lib
        -- Extra jars that may be needed (log4j is essential)
        fitBook.jar
        hamcrest-all-1.2.jar
        jmock-2.5.1.jar
        jmock-junit4-2.5.1.jar
        junit-4.6jar
        log4j-1.2.16.jar
        ognl-2.7.2.jar
        poi-3.1-FINAL-20080629.jar
        rentEz.jar
        src
           -- source code and ant build for FitLibrary
           fitBookSrc.jar -- source code for examples from the Fit Book
           fitLibrarySrc-2.0.jar -- source code for FitLibrary
           rentEzSrc.jar -- source code for example RentEz application

Updating FitLibraryForFitNesse in your existing FitNesse system

If you want to keep any changes you've made to the pages in the user guide, or associated example code, you may like to save them first.

On Windows, to update just the FitLibrary release:

Ensure you have a backup copy of your existing FitNesse system first.
Drop the folder fitnesse inside this FitLibrary release onto the folder fitnesse of your existing FitNesse system.
A Confirm Folder Replace dialog will appear: "This folder already contains a folder named 'fitnesse'. If the files in the existing folder have the same name as files in the folder you are moving or copying, they will be replaced. Do you still want to move or copy the folder?"
If you're happy to replace the FitLibrary files concerned, click Yes to All. This will not change or remove any other files/pages.
If not, click No.

Links on Front Page

To make it easy to access the FitLibrary user guide, you may like to add the following to the front page:

    |FitLibrary.UserGuide|

Source Code

The Java source for the FitLibrary and example fixtures are supplied in this release, in the lib/src subdirectory.

Any Suggestions?

Any suggestions for improvements in this release approach are most welcome.

Rick Mugridge, http://www.RimuResearch.com.
Altered October 2011