Master branch build status:
The RestFixture is a FitNesse (http://fitnesse.org) 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.
The fixture can be used with both Fit (FitRestFixture) and Slim (Table:Rest Fixture) runners.
Overview:
- Get Fitnesse With Some Rest (http://smartrics.blogspot.com/2008/08/get-fitnesse-with-some-rest.html)
- Rest Fixture, Latest Additions (http://smartrics.blogspot.com/2008/11/restfixture-latest-additions.html)
- Rest Fixure with namespaces support (http://smartrics.blogspot.com/2011/01/restfixture-with-namespaces-support.html)
Documentation:
http://github.com/smartrics/RestFixtureLiveDoc
RestFixture v3.1 and below are compatible with any release of FitNesse to date (v20150424) and no further support for newer versions of FitNesse is guaranteed for these versions of RestFixture.
RestFixture v4.0 is compatible with FitNesse v20150424 and above having implemented proper support of Slim Symbols as described in Issue #52.
The profile latest-fitnesse configures the Versions plugin to fetch the latest FitNesse version. Tests can be executed to verify regression with:
mvn clean versions:use-latest-releases test -P latest-fitnesse
Two new profiles are available: 'bundle' and 'release'
mvn clean package
Once the build completes, the directory target contains:
smartrics-RestFixture-<version>.jar: the RestFixture jar
mvn clean package -P bundle
Once the build completes, the directory target contains:
smartrics-RestFixture-<version>.jar: the RestFixture jarsmartrics-RestFixture-<version>-sources.jar: the RestFixture sources jarsmartrics-RestFixture-<version>-javadoc.jar: the RestFixture javadoc jarsmartrics-RestFixture-<version>-bin.zip: a bundle the RestFixture and all dependencies.dependencies/: all the RestFixture dependencies (excluding a Logging framework implementation. See below for details)
To build RestFixture install Maven and execute
mvn clean package
Once the build completes, the directory target contains:
smartrics-RestFixture-<version>.jar: the RestFixture jardependencies/: all the RestFixture dependencies (excluding a Logging framework implementation. See below for details)smartrics-RestFixture-<version>-bin.zip: a bundle the RestFixture and all dependencies.
If the build fails because smartrics-RestClient can't be found, check the pom.xml file and make sure the repository sonatype-releases-restclient is enabled.
To build RestFixture add a property file in the properties directory named <your.os.username>.properties by copying and customising build.properties if necessary.
Use
ant
or
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
The RestFixture uses slf4j-api; if no logger implementation is provided slf4j defaults to nop binding. Please download and add to the classpath your binding of choice (and the respective configuration file).
The current version is slf4j-api-1.6.6, hence download the matching version of the binding implementation.
Check http://www.slf4j.org/ for more details.
http://stackoverflow.com/questions/35753103/workflow-of-creating-tests-using-restfixture