Skip to content
A lightweight Scala DSL for system testing REST web services
Scala Groovy
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
gradle/wrapper
project
src
.gitignore
LICENSE.txt
README.md
build.gradle
build.sbt
gradlew
gradlew.bat

README.md

RestTest

A lightweight Scala DSL for system testing REST web services

Example

val Jason: Person = ???
val personJson = Json.stringify(Jason)
val EmptyList = List[Person]()

using(_ url "http://api.rest.org/person") { implicit rb =>
  GET asserting (statusCode is Status.OK, jsonBodyAsList[Person] is EmptyList)
  val id = POST body personJson asserting (statusCode is Status.Created) returning (header("X-Person-Id"))
  GET / id asserting (statusCode is Status.OK, jsonBodyAs[Person] is Jason)
  GET asserting (statusCode is Status.OK, jsonBodyAsList[Person] is Seq(Jason))
  DELETE / id asserting (statusCode is Status.OK)
  GET / id asserting (statusCode is Status.NotFound)
  GET asserting (statusCode is Status.OK, jsonBodyAsList[Person] is EmptyList)
}

The Plan

I plan for this to be a useful resource for writing REST web service system tests. However my initial focus is learning and documenting the creation of a Scala DSL. The progress on the implementation is slow because I am documenting my understanding of DSLs as I go.

You can follow the progress on my blog:

How to build

This project has been migrated to Scala 2.11 and the build ported to SBT.

To download and build RestTest just:

git clone git@github.com:IainHull/resttest.git
cd resttest
sbt test

To create a fully configured eclipse project just:

sbt eclipse with-source=true

Old build using Gradle

This project used to be built with gradle. It still includes the gradle files and the gradle wrapper which will download gradle and build the project for you (the only prereq is Java).

To download and build RestTest just:

git clone git@github.com:IainHull/resttest.git
cd resttest
./gradlew build

To create a fully configured eclipse project just:

./gradlew eclipse

License

RestTest is licensed under the permissive Apache 2 Open Source License.

Something went wrong with that request. Please try again.