An Eclipse plugin for Cucumber Version 7.

🚀Turbocharge Your Testing with Cucumber Eclipse Plugin!💻

Where sleek plugin meets seamless BDD workflow

🎯 Key Features That Make You Fall in Love: Plugin-wiki

• ⚡️ One-Click Gherkin Execution: Run feature files instantly—no more command-line gymnastics.
• 🧠 Smart Step Matching: Auto-link steps to definitions like magic. Zero guesswork, full precision.
• 🚀 Auto-suggestions: Context-Aware Autocomplete - Speeds up typing, cuts down typos, feels like IDE sorcery.
• 🗂️ Step definition navigation: Jump between features and step definitions like a time traveler.
• 🎨 I18n Syntax Highlighting: Make your tests shine with vibrant visual feedback.
• 🛠️ Cucumber Console Output Panel: See clear results and trace bugs in a heartbeat.

🧠 Whether you're a QA rockstar or a developer who loves clean code, this plugin brings clarity, speed, and cucumber-fresh productivity to your workflow.

🌱 Grow your features. Nurture your steps. Reap reliable results.

🎉 Elevate Testing. Empower Teams. Embrace Cucumber.

• Available in Eclipse-Marketplace.
• Please refer our Eclipse-Marketplace-Wiki page for detail information.

You can install the latest release using the follwoing update site in Eclipse:

https://cucumber.github.io/cucumber-eclipse/update-site

For users who wants to keep up-to-date with the latest development version please use

https://cucumber.github.io/cucumber-eclipse/update-site/main

You are welcome to report any issue.

You can also download the whole site as a Zip for Offline install here:

https://github.com/cucumber/cucumber-eclipse/archive/refs/heads/gh-pages.zip

then you need to point Eclipse to the folder of version your are interested in.

• 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

Cucumber Eclipse supports Eclipse Activity Groups, which allow you to selectively enable or disable certain plugin features to reduce UI clutter. You can control the visibility of:

• Preference pages
• Property pages
• Launch configurations
• Console factory

To manage these features:

1. Go to Window → Preferences → General → Capabilities
2. Find the "Cucumber" category
3. Check or uncheck the activities you want to enable or disable

• Eclipse IDE: Eclipse IDE for Eclipse Committers (2024-06 or later) - Download
• Java 21: JDK 21 or higher - Download
• Maven: Maven 3.6+ (for command-line builds) - Download

Oomph is Eclipse's installation and project provisioning system that automates the setup process.

1. Download and launch Eclipse Installer

   • Download from Eclipse Installer
   • Start the Eclipse Installer

2. Switch to Advanced Mode

   • Click the menu icon (☰) in the top-right corner
   • Select "Advanced Mode"

3. Add the Cucumber Eclipse Setup

   • Click the "+" icon to add a new project
   • Select "Github Projects" as the catalog
   • Paste the setup file URL:

     https://raw.githubusercontent.com/cucumber/cucumber-eclipse/main/CucumberEclipse.setup
     

   • Or use a local file if you've already cloned the repository:

     file:/path/to/cucumber-eclipse/CucumberEclipse.setup
     

4. Select Product and Project

   • Select "Eclipse IDE for Eclipse Committers" as the product
   • Check "Cucumber Eclipse" in the project list
   • Click "Next"

5. Configure Variables

   • Set your desired installation and workspace locations
   • Configure GitHub credentials (if you want to contribute)
   • Click "Next" and then "Finish"

6. Wait for Setup

   • Oomph will now:
     • Install required Eclipse features (PDE, M2E)
     • Clone the Cucumber Eclipse repository
     • Set up the target platform
     • Import all plugin projects
     • Configure workspace preferences
   • This may take several minutes depending on your internet connection

7. Start Development

   • Once setup completes, Eclipse will open with all projects imported
   • The target platform will be automatically set
   • You're ready to start developing!

If you prefer to set up the environment manually:

1. Clone the repository

   git clone https://github.com/cucumber/cucumber-eclipse.git
   cd cucumber-eclipse

2. Import projects into Eclipse

   • Open Eclipse IDE for Eclipse Committers
   • Go to File → Import → General → Existing Projects into Workspace
   • Select the cloned repository root directory
   • Make sure "Search for nested projects" is checked
   • Select all projects and click "Finish"

3. Set the target platform

   • Open io.cucumber.eclipse.targetdefinition/cucumber.eclipse.targetdefinition.target
   • Wait for the target platform to resolve (this may take a few minutes)
   • Click "Set as Active Target Platform" in the top-right corner of the editor

4. Configure Java 21

   • Go to Window → Preferences → Java → Installed JREs
   • Add JDK 21 if not already present
   • Ensure it's set as the default

5. Build the workspace

   • Go to Project → Clean...
   • Select "Clean all projects" and click "OK"
   • Wait for the automatic build to complete

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.