Eclipse plugin for Cucumber
Java
Switch branches/tags
Nothing to show
Latest commit e167c02 Apr 10, 2017 @ilanpillemer ilanpillemer committed on GitHub Merge pull request #194 from csmoseley/release/17-Windows-OS-Fixes
Adding missing build changes for release 0.0.17

README.md

Cucumber-Eclipse

Eclipse plugin for Cucumber.

Installation and further information

Please head over to the plugin website for more information.

After you install the Cucumber-Eclipse plugin, you can use it to run Cucumber-JVM. To do this, you will need to install all the libraries you want to use for Cucumber-JVM into your Eclipse project's build-path libraries. The likely candidates and their locations are in the download target at the cucumber-java-skeleton example at GitHub.

Create a new feature file by selecting New => File from the menu and naming it with a ".feature" suffix to bring up the Feature Editor. After typing in the Gherkin code for a test, select Run => Run to invoke Cucumber-JVM on that feature. This will also create a run configuration, which you can modify and rename by selecting Run => Run Configurarations.... Tags are not available in Cucumber-Eclipse, but you can organize your features into directories and select the Feature Path that you want the run configuration to use. You can execute run configurations from the Run => Run History menu.

Another alternative is to use Cucumber-Eclipse for editing feature files and getting the generated step-definition stubs, but then running a Junit file with a @RunWith(cucumber.class) annotation similar to the cucumber-java-skeleton RunCukesTest.java. The @CucumberOptions most useful are

  • Run the feature or all features below the directory

    features = {"featurePath/dir1", "featurePath2/dir/one_more.feature", ...}
  • Run all features with the given tag

    tags = {"@tag1", "@tag2", ...}
  • Use the listed formatter

    format = "progress"
  • Find the step definition and hooks below the given directory

    glue = "my_feature_steps/dir"

The full option list can be found at CucumberOptions

Screenshots and Features of the plugin

Please consult the wiki for a full list for currently available features and screenshots.

Build and install from source

To use the latest features, you can choose to build and install from source.

  • Build the plugin using Maven (https://maven.apache.org/) mvn clean install
  • Open Eclipse and navigate to Help -> Install New Software... -> Add
  • Point to the update-site built in step 1: file:path_to_repo/cucumber.eclipse.p2updatesite/target/repository
  • Proceed to install like any other plug-in

How soon will my ticket be fixed?

The best way to have a bug fixed or feature request implemented is to to fork the cucumber-eclipse repository and send a pull request. If the pull request is reasonable it has a good chance of making it into the next release. If you build the release yourself, even more chance!

If you don't fix the bug yourself (or pay someone to do it for you), the bug might never get fixed. If it is a serious bug, other people than you might care enough to provide a fix.

In other words, there is no guarantee that a bug or feature request gets fixed. Tickets that are more than 6 months old are likely to be closed to keep the backlog manageable.