busser-behave 0.1.3

data/vendor/behave/features/runner.select_files_by_regexp.feature

@@ -0,0 +1,84 @@
+@sequential
+Feature: Select feature files by using regular expressions
+
+  As a tester
+  I want to include/exclude feature files into/from a test run by using wildcards
+  To be more flexible and avoid to specify all feature files
+
+  . SPECIFICATION:
+  .  * behave provides --include and --exclude command line options
+  .  * --include option selects a subset of all files that should be included
+  .  * --exclude option is applied after include option is applied
+  .
+  . EXAMPLE:
+  .     behave --include="features/ali.*\.feature" ...
+  .     behave --exclude="features/ali.*" ...
+
+
+    Background:
+        Given behave has the following feature fileset:
+            """
+            features/alice.feature
+            features/bob.feature
+            features/barbi.feature
+            """
+
+    Scenario: Include only feature files
+        When behave includes feature files with "features/a.*"
+        And  behave excludes no feature files
+        Then the following feature files are selected:
+            """
+            features/alice.feature
+            """
+
+    Scenario: Include more than one feature file
+        When behave includes feature files with "features/b.*"
+        Then the following feature files are selected:
+        """
+        features/bob.feature
+        features/barbi.feature
+        """
+
+
+    Scenario: Exclude only feature files
+        When behave excludes feature files with "features/a.*"
+        And  behave includes all feature files
+        Then the following feature files are selected:
+            """
+            features/bob.feature
+            features/barbi.feature
+            """
+
+    Scenario: Exclude more than one feature file
+        When behave excludes feature files with "features/b.*"
+        Then the following feature files are selected:
+        """
+        features/alice.feature
+        """
+
+    Scenario: Include and exclude feature files
+
+      Ensure that exclude file pattern is applied after include file pattern.
+
+        When behave includes feature files with "features/.*a.*\.feature"
+        And  behave excludes feature files with ".*/barbi.*"
+        Then the following feature files are selected:
+            """
+            features/alice.feature
+            """
+
+    Scenario: Include and exclude feature files (in 2 steps)
+
+      Show how file inclusion/exclusion works by emulating the two steps.
+
+        When behave includes feature files with "features/.*a.*\.feature"
+        Then the following feature files are selected:
+            """
+            features/alice.feature
+            features/barbi.feature
+            """
+        When behave excludes feature files with ".*/barbi.*"
+        Then the following feature files are selected:
+            """
+            features/alice.feature
+            """

data/vendor/behave/features/runner.select_scenarios_by_file_location.feature

@@ -0,0 +1,403 @@
+@sequential
+Feature: Select Scenarios by File Location
+
+    To simplify running only one scenario in a feature (or some scenarios)
+    As a tester
+    I want to select a scenario by using its file location,
+    like: "alice.feature:10"   (schema: {filename}:{line})
+
+
+    . CONCEPT: File Location
+    .   * A file location consists of file name and a positive line number
+    .   * A file location is represented as "{filename}:{line}" (or "{filename}")
+    .   * A file location with filename but without line number
+    .     refers to the complete file
+    .   * A file location with line number 0 (zero) refers to the complete file
+    .
+    . SPECIFICATION: Scenario selection by file locations
+    .   * scenario.line == file_location.line selects scenario (preferred method).
+    .   * Any line number in the following range is acceptable:
+    .        scenario.line <= file_location.line < next_scenario.line
+    .   * The first scenario is selected,
+    .     if the file location line number is less than first scenario.line.
+    .   * The last scenario is selected,
+    .     if the file location line number is greater than the lines in the file.
+    .
+    . SPECIFICATION: Runner with scenario locations (file locations)
+    .   * Adjacent file locations are merged if they refer to the same file, like:
+    .
+    .       alice.feature:10
+    .       alice.feature:20
+    .
+    .       => MERGED: Selects/runs "alice.feature" with 2 scenarios.
+    .
+    .       alice.feature
+    .       alice.feature:20
+    .
+    .       => MERGED: Selects "alice.feature" with all scenarios.
+    .
+    .       alice.feature:10
+    .       bob.feature:20
+    .       alice.feature:20
+    .
+    .       => NOT MERGED: Selects/runs "alice.feature" twice.
+    .
+    .   * If file locations (scenario locations) are used,
+    .     scenarios with @setup or @teardown tags are selected, too.
+    .
+    .     REASON: Simplifies to use a Setup Scenario instead of a Background.
+    .
+    .   * Additional scenario selection mechanisms, like tags, names,
+    .     are applied afterwards.
+
+
+    @setup
+    Scenario: Feature Setup
+        Given a new working directory
+        And a file named "features/steps/steps.py" with:
+            """
+            from behave import step
+
+            @step('a step passes')
+            def step_passes(context):
+                pass
+            """
+        And a file named "features/alice.feature" with:
+            """
+            Feature: Alice
+
+              Scenario: Alice First
+                When a step passes
+
+              Scenario: Alice Last
+                Then a step passes
+            """
+        And a file named "features/bob.feature" with:
+            """
+            Feature: Bob
+
+              @setup
+              Scenario: Setup Bob
+                Given a step passes
+
+              Scenario: Bob in Berlin
+                When a step passes
+
+              Scenario: Bob in Paris
+                Then a step passes
+
+              @teardown
+              Scenario: Teardown Bob
+                Then a step passes
+            """
+        And a file named "behave.ini" with:
+            """
+            [behave]
+            show_skipped = false
+            show_timings = false
+            """
+
+
+    @file_location.select
+    Scenario: Select one scenario with its exact file location
+
+      CASE: scenario.line == file_location.line
+
+        When I run "behave -f plain --dry-run --no-skipped features/alice.feature:3"
+        Then it should pass with:
+            """
+            0 features passed, 0 failed, 0 skipped, 1 untested
+            0 scenarios passed, 0 failed, 1 skipped, 1 untested
+            """
+        And the command output should contain:
+            """
+            Feature: Alice
+              Scenario: Alice First
+            """
+        But the command output should not contain:
+            """
+            Scenario: Alice Last
+            """
+
+    @file_location.select
+    Scenario: Select one scenario with a larger file location
+
+      CASE: scenario.line <= file_location.line < next_scenario.line
+
+        When I run "behave -f plain --dry-run --no-skipped features/alice.feature:4"
+        Then it should pass with:
+            """
+            0 features passed, 0 failed, 0 skipped, 1 untested
+            0 scenarios passed, 0 failed, 1 skipped, 1 untested
+            """
+        And the command output should contain:
+            """
+            Feature: Alice
+              Scenario: Alice First
+            """
+        But the command output should not contain:
+            """
+            Scenario: Alice Last
+            """
+
+    @file_location.select
+    Scenario: Select next scenario with its exact location
+
+      CASE: scenario.line < file_location.line == next_scenario.line
+
+        When I run "behave -f plain --dry-run --no-skipped features/alice.feature:6"
+        Then it should pass with:
+            """
+            0 features passed, 0 failed, 0 skipped, 1 untested
+            0 scenarios passed, 0 failed, 1 skipped, 1 untested
+            """
+        And the command output should contain:
+            """
+            Feature: Alice
+              Scenario: Alice Last
+            """
+        But the command output should not contain:
+            """
+            Scenario: Alice First
+            """
+
+    @file_location.select_first
+    Scenario: Select first scenario if line number is smaller than first scenario line
+
+      CASE: 0 < file_location.line < first_scenario.line
+
+        When I run "behave -f plain --dry-run --no-skipped features/alice.feature:1"
+        Then it should pass with:
+            """
+            0 features passed, 0 failed, 0 skipped, 1 untested
+            0 scenarios passed, 0 failed, 1 skipped, 1 untested
+            """
+        And the command output should contain:
+            """
+            Feature: Alice
+              Scenario: Alice First
+            """
+        But the command output should not contain:
+            """
+            Scenario: Alice Last
+            """
+
+    @file_location.select_last
+    Scenario: Select last scenario when line number is too large
+
+      CASE: last_scenario.line < file.last_line < file_location.line
+
+        When I run "behave -f plain --dry-run --no-skipped features/alice.feature:100"
+        Then it should pass with:
+            """
+            0 features passed, 0 failed, 0 skipped, 1 untested
+            0 scenarios passed, 0 failed, 1 skipped, 1 untested
+            """
+        And the command output should contain:
+            """
+            Feature: Alice
+              Scenario: Alice Last
+            """
+        But the command output should not contain:
+            """
+            Scenario: Alice First
+            """
+
+
+    @file_location.select_all
+    Scenario: Select all scenarios with line number 0 (zero)
+        When I run "behave -f plain --dry-run --no-skipped features/alice.feature:0"
+        Then it should pass with:
+            """
+            0 features passed, 0 failed, 0 skipped, 1 untested
+            0 scenarios passed, 0 failed, 0 skipped, 2 untested
+            """
+        And the command output should contain "Scenario: Alice First"
+        And the command output should contain "Scenario: Alice Last"
+        But note that "all scenarios of this features are selected"
+
+
+    @file_location.select
+    @with.feature_configfile
+    Scenario: Select a scenario by using file locations from a features configfile
+        Given a file named "alice1.txt" with:
+            """
+            # -- FEATURES CONFIGFILE:
+            # Selects Alice First
+            features/alice.feature:3
+            """
+        When I run "behave -f plain --dry-run --no-skipped @alice1.txt"
+        Then it should pass with:
+            """
+            0 features passed, 0 failed, 0 skipped, 1 untested
+            0 scenarios passed, 0 failed, 1 skipped, 1 untested
+            """
+        And the command output should contain:
+            """
+            Feature: Alice
+              Scenario: Alice First
+            """
+        But the command output should not contain:
+            """
+            Scenario: Alice Last
+            """
+
+    @file_location.autoselect_setup_teardown
+    Scenario: Auto-select scenarios tagged with @setup or @teardown if file location is used
+        When I run "behave -f plain --dry-run --no-skipped features/bob.feature:7"
+        Then it should pass with:
+            """
+            0 features passed, 0 failed, 0 skipped, 1 untested
+            0 scenarios passed, 0 failed, 1 skipped, 3 untested
+            """
+        And the command output should contain "Scenario: Setup Bob"
+        And the command output should contain "Scenario: Bob in Berlin"
+        And the command output should contain "Scenario: Teardown Bob"
+        But the command output should not contain "Scenario: Bob in Paris"
+
+    @merge.file_locations
+    Scenario: Merge 2 adjacent file locations that refer to the same file
+        When I run "behave -f plain --dry-run --no-skipped features/alice.feature:3 features/alice.feature:6"
+        Then it should pass with:
+            """
+            0 features passed, 0 failed, 0 skipped, 1 untested
+            0 scenarios passed, 0 failed, 0 skipped, 2 untested
+            """
+        And the command output should contain:
+            """
+            Feature: Alice
+              Scenario: Alice First
+                When a step passes ... untested
+
+              Scenario: Alice Last
+                Then a step passes ... untested
+            """
+        But the command output should not contain:
+            """
+            Feature: Alice
+              Scenario: Alice First
+                When a step passes ... untested
+
+            Feature: Alice
+              Scenario: Alice Last
+            """
+        And note that "both file locations are merged"
+
+
+    @merge.file_locations
+    @file_location.select_all
+    Scenario: Merge filename and adjacent file location that refer to the same file
+        When I run "behave -f plain --dry-run --no-skipped features/alice.feature:3 features/alice.feature"
+        Then it should pass with:
+            """
+            0 features passed, 0 failed, 0 skipped, 1 untested
+            0 scenarios passed, 0 failed, 0 skipped, 2 untested
+            """
+        And the command output should contain:
+            """
+            Feature: Alice
+              Scenario: Alice First
+                When a step passes ... untested
+
+              Scenario: Alice Last
+                Then a step passes ... untested
+            """
+        But the command output should not contain:
+            """
+            Feature: Alice
+              Scenario: Alice First
+                When a step passes ... untested
+
+            Feature: Alice
+              Scenario: Alice First
+                When a step passes ... untested
+
+              Scenario: Alice Last
+                Then a step passes ... untested
+            """
+        And note that "duplicated file locations are removed in the merge"
+
+
+    @merge.file_locations
+    @with.feature_listfile
+    Scenario: Merge 2 adjacent file locations to same file from features-listfile
+        Given a file named "alice1_and_alice2.txt" with:
+            """
+            # -- FEATURES CONFIGFILE:
+            # Selects Alice First, Alice Last
+            features/alice.feature:3
+            features/alice.feature:6
+            """
+        When I run "behave -f plain --dry-run --no-skipped @alice1_and_alice2.txt"
+        Then it should pass with:
+            """
+            0 features passed, 0 failed, 0 skipped, 1 untested
+            0 scenarios passed, 0 failed, 0 skipped, 2 untested
+            """
+        And the command output should contain:
+            """
+            Feature: Alice
+              Scenario: Alice First
+                When a step passes ... untested
+
+              Scenario: Alice Last
+                Then a step passes ... untested
+            """
+        But the command output should not contain:
+            """
+            Feature: Alice
+              Scenario: Alice First
+                When a step passes ... untested
+
+            Feature: Alice
+              Scenario: Alice Last
+                Then a step passes ... untested
+            """
+
+    @no_merge.file_locations
+    @with.feature_listfile
+    Scenario: No merge occurs if file locations to same file are not adjacent
+        Given a file named "alice1_bob2_and_alice2.txt" with:
+            """
+            # -- FEATURES CONFIGFILE:
+            # Selects Alice First, Bob in Paris (Setup, Teardown), Alice Last
+            features/alice.feature:3
+            features/bob.feature:10
+            features/alice.feature:6
+            """
+        When I run "behave -f plain --dry-run --no-skipped @alice1_bob2_and_alice2.txt"
+        Then it should pass with:
+            """
+            0 features passed, 0 failed, 0 skipped, 3 untested
+            0 scenarios passed, 0 failed, 3 skipped, 5 untested
+            """
+        And the command output should contain:
+            """
+            Feature: Alice
+              Scenario: Alice First
+                When a step passes ... untested
+
+            Feature: Bob
+              Scenario: Setup Bob
+                Given a step passes ... untested
+
+              Scenario: Bob in Paris
+                Then a step passes ... untested
+
+              Scenario: Teardown Bob
+                Then a step passes ... untested
+
+            Feature: Alice
+              Scenario: Alice Last
+                Then a step passes ... untested
+            """
+        But the command output should not contain:
+            """
+            Feature: Alice
+              Scenario: Alice First
+                When a step passes ... untested
+
+              Scenario: Alice Last
+                Then a step passes ... untested
+            """
+        And note that "non-adjacent file locations to the same file are not merged"