Question

Specs2’s documentation and samples show some codes about the use of Given/Then/When style in an acceptance test.

Here one of them:

"A given-when-then example for the addition"                   ^
    "Given the following number: ${1}"                         ^ number1 ^
    "And a second number: ${2}"                                ^ number2 ^
    "And a third number: ${3}"                                 ^ number3

  val number1: Given[Int]               = (_:String).toInt
  val number2: When[Int, (Int, Int)]    = (n1: Int) => (s: String) => (n1, s.toInt)
  val number3: When[Seq[Int], Seq[Int]] = (numbers: Seq[Int]) => (s: String) => numbers :+ s.toInt

However, it only deal with some primitive objects as Int here (normal since it’s a sample).

But how to deal with complex objects? Using Datatables?

Ideal would be to define, within some file of “fixtures”, datatables (or similar things) defining complex objects.

External datatable defining the User “Mik”

"name" |   "job"    | "e-mail"
"mik"  | "engineer" | "[e-mail]"

I would like to create a Given statement like this one:

"Given the following user: ${Mik}"       ^ retrieve_user_from_database ^

val user: Given[User]               = .....Some ideal codes here to map Mik's values to User model.

What is a good practice and what does Specs2 currently provide?

Answer 1

If you want to retrieve a user from an existing database, you can do the following:

"Given the following user: ${Mik}" ^ user ^

val user: Given[User] = (name: String) => database.getUserByName(name) 

Now you might want to populate your database with users before doing that. One possibility is indeed to use Datatables:

def populateDatabase = 
  "name" ||   "job"    | "e-mail"        |
  "mik"  !! "engineer" ! "[e-mail]"   |
  "eric" !! "engineer" ! "[e-mail]" | { (name, job, email) => 
    database.saveUser(User(name, job, email)) must not(throwAn[Exception])
  }

and put this in a Step before your G/W/T group:

Step(populateDatabase) ^
"Given the following user: ${Mik}"  ^ user ^
"This user should be an ${engineer} ^ jobOk ^
                                      end

val user: Given[User] = (name: String) => database.getUserByName(name)
val jobOk: Then[User] = (user: User) => (job: String) => user.job must_== job