Import feature file

Hiptest enables you to upload feature files written using Gherkin syntax (Cucumber, SpecFlow…)

NOTE: This feature is available only for projects that belong to an organization with a Pro subscription.

STEP 1: activate the BDD mode

In your project settings, activate the BDD mode option.

Active Hiptest BDD mode

This will enable the step editor to interpret the Gherkin syntax and only action words (reusable steps) will be created.

STEP 2: import a feature file

For a good project organization, your features are managed with folders.

After activating the BDD mode, in the folder page, new actions appear:

BDD update Hiptest folder from feature

Hiptest agile test management tool

You can upload your feature files by selecting one of the actions or using the drag-and-drop function.

Note: Only “.feature” extension is accepted. Otherwise an error will be displayed.

The “Create from feature file” action and the drop zone will first look for existing subfolders with the same name as the features you are importing.

If none can be found then new subfolders are created under the current folder. They represent the imported features with their descriptions, tags, scenarios, scenario outlines, examples…

And using the “Update from feature file” action, the existing folder will be updated with the feature file you are importing. For this purpose, a window will show you which updates are about to be done:

Hiptest BDD update feature differences

Click on “Apply changes” once you review them to update your folder and scenarios.

The Gherkin steps will be converted into action word calls. If the action word does not exist, it will be created.

If there is an existing folder with the same name in the same hierarchy level, the new folder name will be suffixed with a number. For example, an existing folder is named “Support internationalisation”, the new one will be named “Support internationalisation (1)”.

Missing scenarios

If one or more scenarios in your folder are not present in the .feature file, they will remain in your folder unless you check the option to delete them.

Hiptest BDD update feature differences delete missing checked

In that case, they will be permanently deleted from your folder.

Datatables update from scenario outline examples

When updating a folder from a feature file that contains scenario outlines with examples, datatables of impacted scenarios will be updated accordingly.

If the first column of your Gherkin examples is named “Dataset name”, it will be used to name your datasets. If you already have datasets with those names they will be updated.

If you do not have a “Dataset name” column in your examples, datasets are retrieved based on their values. If a value has changed, the corresponding dataset will not be found so a new one will be created and the old one will be deleted.

Download the ebook

By submitting this form, you agree to our Terms of Use and Privacy Policy

Hiptest is FREE for open source projects

We actually utilize a number of open source components, which is why Hiptest service is free for any open source project. We are giving back to the community!

Your open source project must meet the following criteria to be approved:

  • Your project is licensed under a license approved by the Open Source Initiative
  • Your project source code is available for download
  • Your project has a publicly accessible website