Java Gherkin Groovy
Clone or download
Latest commit 56a8a9d Jul 20, 2018
Permalink
Failed to load latest commit information.
assets Docs updated Sep 22, 2016
cukes-core [maven-release-plugin][skip ci]prepare for next development iteration Jul 19, 2018
cukes-documentation-generator [maven-release-plugin][skip ci]prepare for next development iteration Jul 19, 2018
cukes-environment-variables-plugin Update pom.xml Jul 19, 2018
cukes-graphql [maven-release-plugin][skip ci]prepare for next development iteration Jul 19, 2018
cukes-http-mock [maven-release-plugin][skip ci]prepare for next development iteration Jul 19, 2018
cukes-http [maven-release-plugin][skip ci]prepare for next development iteration Jul 19, 2018
cukes-ldap [maven-release-plugin][skip ci]prepare for next development iteration Jul 19, 2018
cukes-oauth [maven-release-plugin][skip ci]prepare for next development iteration Jul 19, 2018
cukes-rabbitmq [maven-release-plugin][skip ci]prepare for next development iteration Jul 19, 2018
cukes-rest-loadrunner [maven-release-plugin][skip ci]prepare for next development iteration Jul 19, 2018
cukes-rest [maven-release-plugin][skip ci]prepare for next development iteration Jul 19, 2018
cukes-samples [maven-release-plugin][skip ci]prepare for next development iteration Jul 19, 2018
cukes-sql [maven-release-plugin][skip ci]prepare for next development iteration Jul 19, 2018
docs Updating documentation Jul 19, 2018
.editorconfig Cukes GraphQL initial commit Jun 16, 2017
.gitignore Sample project for SOAP services testing Aug 4, 2017
.java-version build fix Jul 11, 2017
LICENSE trigger build Sep 27, 2017
README.md Update README.md Jul 28, 2017
pom.xml Merge branch 'master' into environment-variables-plugin Jul 19, 2018
wercker.yml Automate wiki content generation (mainly given/when/then steps) from … Sep 28, 2017

README.md

Stories in Ready Join the chat at https://gitter.im/ctco/cukes wercker status Maven

cukes-rest logo

cukes-rest takes simplicity of Cucumber and provides bindings for HTTP specification. As a sugar on top, cukes-rest adds steps for storing and using request/response content from a file system, variable support in .features, context inflation in all steps and a custom plug-in system to allow users to add additional project specific content.

Resources

Sample Test

Feature: Gadgets are great!

  Background:
    Given baseUri is http://my-server.com/rest/

  Scenario: Should create another Gadget object
    Given request body from file gadgets/requests/newGadget.json
    And content type is "application/json"

    When the client performs POST request on /gadgets
    Then status code is 201
    And header Location contains "http://localhost:8080/gadgets/"

    When the client performs GET request on {(header.Location)}
    Then status code is 200
    And response contains property "id" with value other than "2000"
    And response contains property "name" with value "Nexus 9"
    And response does not contain property "updatedDate"

There are three sections available to be used in a Feature files:

  • Feature - a description of a feature under test
  • Background - set of steps to be executed before every scenario (usually these are preconditions)
  • Scenario - a single automated test case

As well as three groups of steps available

  • Given - building up a HTTP request to be performed
  • When - executing the request
  • Then - assertions based on a response received

More information can be found in the presentation right here!

Prerequisites

  • JDK 1.6+

Dependency

The dependencies are stored in Maven Central

cukes-rest: core dependency with all you need to get started with the framework (Maven)

<dependency>
    <groupId>lv.ctco.cukes</groupId>
    <artifactId>cukes-rest</artifactId>
    <version>${cukes-rest.version}</version>
</dependency>

cukes-rest-loadrunner: experimental plugin for HP LoadRunner script generation out of cukes-rest test case

<dependency>
    <groupId>lv.ctco.cukes</groupId>
    <artifactId>cukes-rest-loadrunner</artifactId>
    <version>${cukes-rest.version}</version>
</dependency>

Getting Started

There are two options to start local server with Sample Application:

  1. Run SampleApplicaiton.java with following params server server.yml from $MODULE_DIR$
  2. Execute Package/Install Maven phase of the parent project cukes-rest-all

Running tests

Precondition: in order for all tests to pass successfully, please make sure you started fresh instance of Sample Application.

  • To start a specific Feature/Scenario, either change CucumberOption in RunCukesTest.java or run Feature file directly from you IDE
  • To start all tests run RunCukesTest.java from sub-project cukes-rest-sample
  • To start all tests right from Maven, execute test phase in project cukes-rest-sample