Placeholders

Most built-in steps can use placeholders in their arguments, those will be automatically resolved from the session:

• URL
• Expected body
• HTTP params (name and value)
• HTTP headers (name and value)
• JSON Path

import com.github.agourlay.cornichon.CornichonFeature

class PlaceholderFeature extends CornichonFeature {

  def feature =
  Feature("Placeholders examples") {

    Scenario("abstract favorite superheroes") {

      Given I save("favorite-superhero" -> "Batman")

      Then assert session_value("favorite-superhero").is("Batman")

      When I get("http://localhost:8080/superheroes/<favorite-superhero>")

      Then assert body.is(
        """
        {
          "name": "<favorite-superhero>",
          "realName": "Bruce Wayne",
          "city": "Gotham city",
          "publisher": "DC"
        }
        """
      )

      And I save_body_path("city" -> "batman-city")

      Then assert session_value("batman-city").is("Gotham city")

      Then assert body.is(
        """
        {
          "name": "<favorite-superhero>",
          "realName": "Bruce Wayne",
          "city": "<batman-city>",
          "publisher": "DC"
        }
        """
      )
    }
  }
}

It is also possible to inject random values inside placeholders using:

• <random-uuid> for a random UUID (e.g. f47ac10b-58cc-4372-a567-0e02b2c3d479)
• <random-positive-integer> for a random Integer between 0 and 9999
• <random-string> for a random String of 5 characters
• <random-alphanum-string> for a random alphanumeric String of 5 characters
• <random-boolean> for a random Boolean string (true or false)
• <random-timestamp> for a random timestamp in seconds (Unix epoch)
• <current-timestamp> for the current timestamp in seconds (Unix epoch)
• <scenario-unique-number> for a unique number scoped per scenario
• <global-unique-number> for a globally unique number across all features

post("http://url.io/somethingWithAnId").withBody(
"""
  {
    "id" : "<random-uuid>"
  }
""")

If you save several times a value under the same key, the session will behave like a Multimap by appending the values.

It becomes then possible to retrieve past values :