cucumber-generator

Simple generator for cucumber features. It's still under development and currently can transform only simple features to following templates:

• jest-cucumber
• cypress-cucumber-preprocessor
• cucumber

but basicaly there can be any yours template given as parameter. Of course you can use jest-cucumber templates but if you're using other library or you have many feature files and you don't want to copy-paste the code from console then this tool is made for you. :)

Generator will lookup for all features in given directory and generate .spec.ts files accordingly.

Installing

Do I need to state the obvious? :smile:

1yarn add -D cucumber-generator

or

1npm install -D cucumber-generator

CLI

API

Usage: npx cucumber-generator [parameters]

Options:
  --version                 Show version number                        [boolean]
  -h, --help                Show help                                  [boolean]
  --includeDirectory        If present, the file is generated into the directory
                            with same name as feature name (within output
                            folder)                   [boolean] [default: false]
  --output                                 [required] [choices: "stdio", "file"]
  -f, --featuresDirectory                                    [string] [required]
  --templatesDirectory                                                  [string]
  --template                                 [string] [default: "jest-cucumber"]
  --relativePathToFeatures                              [string] [default: "./"]
  --maintainStructure                                  [boolean] [default: true]
  --verbose                                           [boolean] [default: false]

Example

Consider this feature file

1Feature: Car
2  This feature describes how a car works
3  Scenario: Unlock car
4    Given keys
5    Given locked car
6    When person presses an unlock button
7    And tries to open the door
8    Then the door should open
9
10  Scenario: Start engine
11    Given unlocked car
12    When person inserts key into ignition
13    And turns the key
14    Then car should start

after running npx cucumber-generator (with additional parameters described before) the result will be

1import { defineFeature, loadFeature } from 'jest-cucumber';
2
3const feature = loadFeature('../src/fixtures/Simple.feature');
4
5defineFeature(feature, test => {
6    test('Unlock car', ({ given, when, and, then }) => {
7        given('keys', () => {
8        });
9        given('locked car', () => {
10        });
11        when('person presses an unlock button', () => {
12        });
13        and('tries to open the door', () => {
14        });
15        then('the door should open', () => {
16        });
17    });
18    test('Start engine', ({ given, when, and, then }) => {
19        given('unlocked car', () => {
20        });
21        when('person inserts key into ignition', () => {
22        });
23        and('turns the key', () => {
24        });
25        then('car should start', () => {
26        });
27    });
28});

As module

API

There is TemplateGenerator class available with following constructor params:

• template: string - mandatory parameter, defines a template to generate (currently just jest-cucumber)
• options:
  • featuresDirectory: string - defines root for searching features
  • outputDirectory: string - defines where the files will be generated
  • maintainStructure: string | undefined - whether copy directory tree when generating spec files (default: true). If set to false, spec files will be generated all in single directory.
  • variables: Record<string, any> - variables passed to template file when generating
    • relativePathToFeatures: string - mandatory variable, defines where are feature files stored relatively to spec files (needed due to loadFeature function in jest-cucumber)

Examples

1import {TemplateGenerator} from 'cucumber-generator';
2
3const outputDirectory = './out';
4const featuresDirectory = './src/test/features';
5const relativePathToFeatures = '../src/test/features';
6
7const generator = new TemplateGenerator('jest-cucumber', {
8    outputDirectory,
9    featuresDirectory,
10    variables: {
11      relativePathToFeatures,
12    },
13});
14const result = await generator.generate();

Contribution

Any help with the package is always welcome, just be sure to write and run the tests.