cucumber.api.junit

Class Cucumber

java.lang.Object

org.junit.runner.Runner

org.junit.runners.ParentRunner<cucumber.runtime.junit.FeatureRunner>

cucumber.api.junit.Cucumber

All Implemented Interfaces:

org.junit.runner.Describable, org.junit.runner.manipulation.Filterable, org.junit.runner.manipulation.Sortable

public class Cucumber
extends org.junit.runners.ParentRunner<cucumber.runtime.junit.FeatureRunner>

Classes annotated with @RunWith(Cucumber.class) will run a Cucumber Feature. In general, the runner class should be empty without any fields or methods. For example:

 @RunWith(Cucumber.class)
 @CucumberOptions(plugin = "pretty")
 public class RunCukesTest {
 }
Fail * 

Cucumber will look for a .feature file on the classpath, using the same resource path as the annotated class (.class substituted by .feature).

Additional hints can be given to Cucumber by annotating the class with CucumberOptions.

Cucumber also supports JUnits ClassRule, BeforeClass and AfterClass annotations. These will be executed before and after all scenarios. Using these is not recommended as it limits the portability between different runners; they may not execute correctly when using the commandline, IntelliJ IDEA or Cucumber-Eclipse. Instead it is recommended to use Cucumbers `Before` and `After` hooks.

See Also:

CucumberOptions

Constructor Summary

Constructors

Constructor and Description
Cucumber(Class clazz) Constructor called by JUnit.

Method Summary

Modifier and Type	Method and Description
protected org.junit.runners.model.Statement	childrenInvoker(org.junit.runner.notification.RunNotifier notifier)
protected org.junit.runner.Description	describeChild(cucumber.runtime.junit.FeatureRunner child)
List<cucumber.runtime.junit.FeatureRunner>	getChildren()
protected void	runChild(cucumber.runtime.junit.FeatureRunner child, org.junit.runner.notification.RunNotifier notifier)

Methods inherited from class org.junit.runners.ParentRunner

classBlock, classRules, collectInitializationErrors, createTestClass, filter, getDescription, getName, getRunnerAnnotations, getTestClass, isIgnored, run, runLeaf, setScheduler, sort, validatePublicVoidNoArgMethods, withAfterClasses, withBeforeClasses

Methods inherited from class org.junit.runner.Runner

testCount

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Cucumber

public Cucumber(Class clazz)
         throws org.junit.runners.model.InitializationError

Constructor called by JUnit.

Parameters:

clazz - the class with the @RunWith annotation.

Throws:

org.junit.runners.model.InitializationError - if there is another problem

Method Detail

getChildren

public List<cucumber.runtime.junit.FeatureRunner> getChildren()

Specified by:

getChildren in class org.junit.runners.ParentRunner<cucumber.runtime.junit.FeatureRunner>

describeChild

protected org.junit.runner.Description describeChild(cucumber.runtime.junit.FeatureRunner child)

Specified by:

describeChild in class org.junit.runners.ParentRunner<cucumber.runtime.junit.FeatureRunner>

runChild

protected void runChild(cucumber.runtime.junit.FeatureRunner child,
                        org.junit.runner.notification.RunNotifier notifier)

Specified by:

runChild in class org.junit.runners.ParentRunner<cucumber.runtime.junit.FeatureRunner>

childrenInvoker

protected org.junit.runners.model.Statement childrenInvoker(org.junit.runner.notification.RunNotifier notifier)

Overrides:

childrenInvoker in class org.junit.runners.ParentRunner<cucumber.runtime.junit.FeatureRunner>