/grails-cucumber

a Cucumber plugin for Grails

Primary LanguageGroovy

Cucumber Grails Plugin

grails-cucumber is a Grails plugin for Cucumber based on Cucumber-JVM. Cucumber-JVM is the JVM implementation of cucumber with support for many JVM languages.

The plugin runs cucumber inside grails which allows us to call the grails api. For example it is possible to call dynamic finders in the step implementations. You can populate the database with test data or check domain objects written to the database.

See the wiki for more information, especially the plugin guide or the introductional article that walks through a simple example.

Quick Usage

The plugin integrates cucumber as a grails test type into the grails test infrastructure. That means you can run the cucumber features with test-app and that the results will be included in the usual grails test reports.

Currently the plugin registers the cucumber test type only to the functional test phase. To run the cucumber features you call grails by one of the following commands:

grails test-app functional:cucumber
grails test-app :cucumber

  • cucumber features and steps are expected in the test/functional folder

  • step implementations look like this:

      import static cucumber.api.groovy.EN.*

  Given (~'^I have specified my app by example$') { ->
  	// implement me using groovy and grails code
  }
  
  When (~'^I run the specification without failures$') { ->
  	// implement me using groovy and grails code
  }
  
  Then (~'^I am confident the app does what the customer wanted$') { ->
  	// implement me using groovy and grails code
  }

  • failing steps, steps with errors or undefined steps are all reported by grails as FAILED. The normal cucumber output can be found in target/test-reports

  • You can provide feature and scenario filters on the command line. The plugin does currently support cucumbers @tag and dir/file:line filters. See cli options.

Changes

see CHANGES.md

Development

Plugin test code

  • the plugin has a number of unit tests and a single "cli" test. There are also a number of cucumber tests which are not meant to be run directly. They are only used by the "cli" test. You can run the cli test with

grails test-app other:cli

and the unit tests with

grails test-app unit:

The unit tests will also run from an IDE without starting up grails (works for me with IDEA 11.1).