Add Example and But keywords

Author: olexale

CHANGELOG.md

@@ -1,3 +1,7 @@
+## [0.1.2] - More Gherkin keywords
+
+* Add `Example` and `But` keywords
+
 ## [0.1.1] - Hotfix
 
 * Fix regular expressions for parameters parsing

README.md

@@ -67,9 +67,10 @@ Feature: Counter
 
 Each feature file must have one or more `Feature:`s. Features become test groups in Flutter tests.
 
-Each feature group must have one or more `Scenario:`s. Scenario become widget tests.
+Each feature group must have one or more `Scenario:`s (or `Example:`s). Scenario become widget tests.
 
-Each scenario must have one or more lines. Each of them must start with `Given`, `When`, `Then`, or `And` keywords. Conventionally `Given` steps are used for test arrangements, `When` — for interaction, `Then` — for asserts.
+Each scenario must have one or more lines with steps. Each of them must start with `Given`, `When`, `Then`, `And`, or `But` keywords. Conventionally `Given` steps are used for test arrangements, `When` — for interaction, `Then` — for asserts. Keywords are not taken into account when looking for a step definition.
+You can have as many steps as you like, but it's recommended you keep the number at 3-5 per scenario. Having too many steps will cause it to lose it’s expressive power as specification and documentation. 
 
 ## Predefined steps
 

lib/src/bdd_line.dart

@@ -29,8 +29,8 @@ LineType _lineTypeFromString(String line) {
 }
 
 const featureMarkers = ['Feature:'];
-const scenarioMarkers = ['Scenario:'];
-const stepMarkers = ['Given', 'When', 'Then', 'And'];
+const scenarioMarkers = ['Scenario:', 'Example:'];
+const stepMarkers = ['Given', 'When', 'Then', 'And', 'But'];
 
 String _removeLinePrefix(String rawLine) {
   final lines = rawLine.split(' ');

pubspec.yaml

@@ -1,6 +1,6 @@
 name: bdd_widget_test
 description: A BDD-style widget testing library. Generates Flutter widget tests from *.feature files.
-version: 0.1.1
+version: 0.1.2
 author: Oleksandr Leuschenko <olexa.le@gmail.com>
 homepage: https://github.com/olexale/bdd_widget_test
 

test/testing_data.dart

@@ -10,7 +10,7 @@ Feature: Testing feature
         Given the app is running
         Then I see {'nice param'} text
 
-        And I see {Icons.add} icon
+        But I see {Icons.add} icon
 ''';
 
 const bigFeatureFile = '''
@@ -22,7 +22,7 @@ Feature: First testing feature
 
 Feature: Second testing feature
     
-    Scenario: First testing scenario
+    Example: First testing scenario
         Given the app is running