Repository files navigation

VSCode Cucumber (Gherkin) Language Support + Format + Steps/PageObjects Autocomplete

• Syntax highlight
• Basic Snippets support
• Auto-parsing of feature steps from paths, provided in settings.json
• Autocompletion of steps
• Ontype validation for all the steps
• Definitions support for all the steps parts
• Document format support, including tables formatting
• Supporting of many spoken languages
• Gherkin page objects native support
• Multiple programming languages, JS, TS, Ruby, Kotlin etc.

• Sort steps suggestions by their using count
• Option to filter steps completions depending on words used for their defining
• Option to automatically change all the steps parts, that require some user action, by snippets
• Option to show several different completion variants for steps with 'or' RegEx parts (like(a|b))

1. Open your app in VS Code
2. Installcucumberautocomplete extension
3. In the opened app root create (if absent) .vscode folder with settings.json file or just runmkdir .vscode && touch .vscode/settings.json
4. Add all the needed settings to the settings.json file
5. Reload app to apply all the extension changes
6. To get autocomplete working,strings var ofeditor.quickSuggestions setting should be set to true (because by defaultstring suggestions will not appear)

{"cucumberautocomplete.steps":["test/features/step_definitions/*.js","node_modules/qa-lib/src/step_definitions/*.js"],"cucumberautocomplete.strictGherkinCompletion":true}

cucumberautocomplete.steps - Glob-style path or array of glob-style paths to the gherkin steps files.All the files, that match path provided, will be handled by the extension. So, ideally, this path should be as strict as possible (ex.test/features/step_definitions/*.steps.js is better thentest/**/*.steps.js and much better then**/*.steps.js)The Node will watch steps files for change and will automatically update steps in them.All the paths are relative to the app root.

cucumberautocomplete.syncfeatures - Will get steps using count from the glob-style path.Same with thesteps setting - this path should be as strict as possible.

cucumberautocomplete.strictGherkinCompletion - Strict comparing of declaration function and gherkin word.For ex. if step definition isWhen(/I do something/) - in case ofstrictGherkinCompletion istrue - after typingGiven I this step will not be shown in the suggestion list.In case of some non-gherkin steps definition usage (ex.new Step('I do something'))strictGherkinCompletion should be set tofalse - no steps suggestions will be shown otherwise.

cucumberautocomplete.strictGherkinValidation - Compare step body and gherkin word during steps validation.Sometimes, it's useful to suggest only steps, that strictly equals by gherkin word, but show no error in case if gherkin word is using inproperly, so this option was separated from thestrictGherkinCompletion.

cucumberautocomplete.smartSnippets - Extension will try to change all the steps parts, that requires some user input (ex. .*, ([a-z]+), \w{1,3}) to snippets.This option could speed up new steps adding up to several times. Try it ;)

cucumberautocomplete.stepsInvariants - Show all the 'or' steps parts as separate suggestions (ex. showI use a andI use b steps suggestions for theGiven(/I use (a|b)/) step. It also could help to speed up the new steps adding.

cucumberautocomplete.customParameters - Change some steps RegEx parts depending on array of 'parameter' - 'value' key pairs. Parameter could be string or RegEx object.This setting will be applied before the steps getting.For ex. to get step from the py expression@given(u'I do something') we could use the next parameters:

"cucumberautocomplete.customParameters": [        {            "parameter":"(u'",            "value":"('"        }    ],

After this, the current expression will be handled as@given('I do something'), so the extension would be able to get'I do something' step.

cucumberautocomplete.pages - Object, which consists of 'page name' => 'page object file path' pairsIt is allowing to handle some very specific case of page objects usage in the gherkin steps.

cucumberautocomplete.skipDocStringsFormat - Skip format of strings, that placed between ''' or """.

cucumberautocomplete.formatConfOverride - Override some formatting via format conf strings = {[key: String]: num | 'relative' | 'relativeUp' }, where key - beggining of the string, num - numeric value of indents, 'relative' (same indent value as the next line), or 'relativeUp' (same as the previous line).Example:

"cucumberautocomplete.formatConfOverride": {        "And": 3,        "But": "relative",    },

Also, some new words (in the case of non-English languages using) could be added. Example:

"cucumberautocomplete.formatConfOverride": {        "Característica": 3,        "Cuando": "relative",    },

Default format conf is:

{    'Ability': 0,    'Business Need': 0,    'Feature:': 0,    'Scenario:': 1,    'Background:': 1,    'Scenario Outline:': 1,    'Examples:': 2,    'Given': 2,    'When': 2,    'Then': 2,    'And': 2,    'But': 2,    '*': 2,    '|': 3,    '"""': 3,    '#': 'relative',    '@': 'relative',};

cucumberautocomplete.onTypeFormat - Enable ontype formattings (activating after pressing on space, @ and : keys)"

cucumberautocomplete.gherkinDefinitionPart - Provide step definition name part of regex(ex. '@(given|when|then|step)\(' in case of python-like steps.All the 'definition' words (usually they are gherkin words, but some other words also could be used) should be placed into the braces.

cucumberautocomplete.stepRegExSymbol - Provide step regex symbol. Ex. it would be "'" for When('I do something') definitionBy default, all the' ' " symbols will be used do define start and the end of the regex. But, sometimes, we needs to use some other symbol (ex.\\) or we should exclude some default symbol (ex. use' only).

cucumberautocomplete.pureTextSteps - Some frameworks using gherkin steps as a text with just support for the cucumber expression instead of RegExp. This differs from the default extension behaviour, example:When('I give 5$ and * items') step would be handled as/I give 5$ and * items/ RegExp without this option enabled and as/^I give 5\$ and \* items$/ RegExp with it (^ and$ symbols were added to the reg ex and also all the special regex symbols were handled as regular text symbols).

{"cucumberautocomplete.steps":["test/features/step_definitions/*.js","node_modules/qa-lib/src/step_definitions/*.js"],"cucumberautocomplete.syncfeatures":"test/features/*feature","cucumberautocomplete.strictGherkinCompletion":true,"cucumberautocomplete.strictGherkinValidation":true,"cucumberautocomplete.smartSnippets":true,"cucumberautocomplete.stepsInvariants":true,"cucumberautocomplete.customParameters":[{"parameter":"{ab}","value":"(a|b)"},{"parameter":/\{a.*\}/,"value":"a"},],"cucumberautocomplete.pages":{"users":"test/features/page_objects/users.storage.js","pathes":"test/features/page_objects/pathes.storage.js","main":"test/features/support/page_objects/main.page.js"},"cucumberautocomplete.skipDocStringsFormat":true,"cucumberautocomplete.formatConfOverride":{"And":3,"But":"relative",},"cucumberautocomplete.onTypeFormat":true,"editor.quickSuggestions":{"comments":false,"strings":true,"other":true},"cucumberautocomplete.gherkinDefinitionPart":"(Given|When|Then)\\(","cucumberautocomplete.stepRegExSymbol":"'","cucumberautocomplete.pureTextSteps":true}

Feel free to create app issues onGitHub

If this plugin was helpful for you, you could give it a ★ Star onGitHub