An Eclipse plugin for Cucumber Version 6+. For the previous version of this plugin take a look at the 1.x branch.
CAUTION: This is currently work-inprogress!
- Releases and snapshots versions can be downloaded as zip format.
- Please refer our Plugin-Download/Installation-Wiki for detail information
For users who wants to keep up-to-date with the latest development version, there is a dedicated eclipse update site for the cucumber eclipse plugin.
With this one, you will be notified on each new snapshot.
CAUTION: The latest snapshot can be unstable. This is a preview version.
You are welcome to report any issue.
- After you install the Cucumber-Eclipse plugin, you can use it to run Cucumber-JVM.
- Create a new feature file from Eclipse 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 Cucumber-Options
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/io.cucumber.eclipse.updatesite/target/repository
- Proceed to install like any other plug-in
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.