Library that loads Gherkin syntax from a .feature file to an object in order to export it as formated text. This is not meant to interpret the language.
var inputLines = new List<string>();
var gherkinObj = new GherkinObjectParser(inputLines).Parse();
// Replaces scenario outlines with one scenario per case in the "Examples"
// "Examples" markdown block is lost in the process
gherkinObj.TransformScenarioOutlineToClassicScenarioAndOverrideScenarioList();
- One
Feature
per file - One
Background
per file Scenario
(multiple) ( aliasExample
)Given
And
(given, multiple)When
And
(when, multiple)Then
And
(then, multiple)*
Alias forAnd
"""
(Doc Strings) (for Given, When, Then, And)|
(Data Tables) (for Given, When, Then, And)@
(Tags) (Before Scenario and Feature)Scenario Outline
( aliasScenario Template
)Examples
( aliasScenarios
)- Markdown after
Feature
,Background
,Scenario
,Scenario Outline
andExamples
- Empty lines (except in Markdown blocks)
#
(Comments)
- Guard clause for wrongly structured files and unexpected lines
- Multiple
Feature
per file Rule
But
The converter does not transform scenario outlines to classic scenarios before exporting.
The converter does not exports
- Tags
- Markdown blocks
Using the applicaiton extension GherkinSimpleParser.Converter
you have access to the class ExcelConverter
that exports the GherkinObject to a predefined Excel TestPlan.
New lines and carriage return are removed from Doc strings ("""
) and from Data Tables (|
).
Using the applicaiton extension GherkinSimpleParser.Converter
you have access to the class CSVConverter
that does the following:
GherkinObject gherkinObj = GherkinObject.Parse(inputLines));
string separator = "|";
List<string> CSVLines = gherkinObj.ExportAsCSV(separator));
Transforms
Feature: feature name
# As user
# I want to do test cases
# In order to test
Background:
Given Prerequisite_0.1
And Prere"q"uisite_0.2
Scenario: Test Case 1
Given Prerequisite_1.1
And ¨Prere"q"uisite_1.2
When Action_1
Then Result_1.1
And Resu"l"t_1.2
Scenario: Test Case 2
Given Prerequisite_2.1
And Prere"q"uisite_2.2
When Action_2
Then Result_2.1
And Resu"l"t_2.2
into
"Number;GIVEN;WHEN;THEN",
";GENERAL PREREQUISITES:|Prerequisite_0.1|Prere"q"uisite_0.2;;",
"1;Test Case 1;;",
";Prerequisite_1.1|Prere"q"uisite_1.2;Action_1;Result_1.1|Resu"l"t_1.2",
"2;Test Case 2;;",
";Prerequisite_2.1|Prere"q"uisite_2.2;Action_2;Result_2.1|Resu"l"t_2.2"
More information and sources:
https://github.com/Servan42/GherkinSimpleParser