Skip to content
A FitNesse fixture for testing REST services
Branch: master
Clone or download
Pull request Compare This branch is 168 commits behind smartrics:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


RestFixture: A FitNesse fixture for testing REST services

The RestFixture is a FitNesse (  fixture that allows
developers and/or product owners to write test fixtures for REST services
with simplicity in mind. The idea is to write tests that are self
documenting and easy to write and read, without the need to write Java code.

The fixture allows test writers to express tests as actions (any of the
allowed HTTP methods) to operate on resource URIs and express expectations on
the content of the return code, headers and body. All without writing one
single line of Java code.

And it also works as a living/executable documentation of the API.


    * Get Fitnesse With Some Rest
    * Rest Fixture, Latest Additions
    * Rest Fixure with namespaces support



To build RestFixture add a property file in the properties directory named <your.os.username>.properties 
by copying and customising if necessary.

> ant


> ant full

to run the default target (this will build the Rest Fixture, start a local instance
of FitNesse on port 7070 and run the fitnesse tests in src/test/cat. 

You can also pass a build properties file to ant with 

> ant -Dproperties=<my.bespoke.file>.properties

If it all succeeds a distribution of the RestFixture is available in dist/ alongside with the latest 
documentation. Reports of tests and metrics are available in build/reports

Note on dependencies
RestFixture distribution contains the file etc/restfixture/sequence.pic
part of UMLGraph (, distributed under BSD license (see


To use the RestFixture, simply add RestFixture-<ver>.jar to your FitNesse tests classpath,
alongside its dependencies. Dependencies are bundled in the RestFixture-<ver>.zip, or
in the lib/ directory.

For example,

1) Unzip the RestFixture-<ver>.zip
    let's assume that you have unzipped it in C:\lib\RestFixture
1) Start FitNesse 
    let's assume that fitnesse is now running on port 8090)
2) Go to http://localhost/RestFixtureInstallTest 
    this will create a new test page
3) Type the following:

!define TEST_SYSTEM {slim}

!path C:/lib/RestFixture/lib/*
!path C:/lib/RestFixture/RestFixture.jar

| | http://localhost:8090 |
| GET | /RestFixtureInstallTest?rss | | | //title[text()='RestFixtureInstallTest']|
4) Execute the test
    If it passes, you have succesfully installed the RestFixture. You'll also know how to reference it's jar and dependencies.
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.