Many gherkin runner fixes and improvements

.vscode/launch.json

@@ -0,0 +1,60 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "PowerShell",
+            "request": "launch",
+            "name": "PowerShell Interactive Session",
+            "cwd": "${workspaceRoot}",
+            "createTemporaryIntegratedConsole": true
+        },
+        {
+            "type": "PowerShell",
+            "request": "launch",
+            "name": "PowerShell Debug Tests w/Args Prompt",
+            "script": "Import-Module '${workspaceRoot}\\Pester.psd1'; Invoke-Pester",
+            "args": [
+                "-PesterOption @{ IncludeVSCodeMarker = $True }",
+                "${command:SpecifyScriptArgs}"
+            ],
+            "cwd": "${workspaceRoot}",
+            "createTemporaryIntegratedConsole": true
+        },
+        {
+            "type": "PowerShell",
+            "request": "launch",
+            "name": "PowerShell Debug Current Test File w/Args Prompt",
+            "script": "Import-Module '${workspaceRoot}\\Pester.psd1'; Invoke-Pester -Path '${file}'",
+            "args": [
+                "-PesterOption @{ IncludeVSCodeMarker = $True }",
+                "${command:SpecifyScriptArgs}"
+            ],
+            "cwd": "${workspaceRoot}",
+            "createTemporaryIntegratedConsole": true
+        },
+        {
+            "type": "PowerShell",
+            "request": "launch",
+            "name": "PowerShell Debug Gherkin Test Runner using Current Feature File w/Args Prompt",
+            "script": "Import-Module '${workspaceRoot}\\Pester.psd1'; Invoke-Gherkin -Path '${file}'",
+            "args": [
+                "-PesterOption @{ IncludeVSCodeMarker = $True }",
+                "${command:SpecifyScriptArgs}"
+            ],
+            "cwd": "${workspaceRoot}",
+            "createTemporaryIntegratedConsole": true
+        },
+        {
+            "type": "PowerShell",
+            "request": "launch",
+            "name": "PowerShell Debug Gherkin Test Runner w/Args Prompt",
+            "script": "Import-Module '${workspaceRoot}\\Pester.psd1'; Invoke-Gherkin",
+            "args": [
+                "-PesterOption @{ IncludeVSCodeMarker = $True }",
+                "${command:SpecifyScriptArgs}"
+            ],
+            "cwd": "${workspaceRoot}",
+            "createTemporaryIntegratedConsole": true
+        },
+    ]
+}

.vscode/settings.json

@@ -1,9 +1,26 @@
 {
   "powershell.codeFormatting.preset": "Stroustrup",
 
+  "files.associations": {
+    "*.ps1xml": "xml"
+  },
   "files.trimTrailingWhitespace": true,
   "files.insertFinalNewline": true,
 
   "editor.tabSize": 4,
-  "editor.formatOnSave": true
+  "editor.formatOnSave": true,
+  "[feature]": {
+    "editor.quickSuggestions": {
+      "comments": false,
+      "strings": true,
+      "other": true
+    },
+    "editor.renderWhitespace": "all",
+    "editor.rulers": [110],
+    "editor.tabSize": 2
+  },
+  "[powershell]": {
+    "editor.rulers": [110],
+    "files.encoding": "utf8bom"
+  }
 }

.vscode/tasks.json

@@ -0,0 +1,171 @@
+// Available variables which can be used inside of strings.
+// ${workspaceRoot}: the root folder of the team
+// ${file}: the current opened file
+// ${relativeFile}: the current opened file relative to workspaceRoot
+// ${fileBasename}: the current opened file's basename
+// ${fileDirname}: the current opened file's dirname
+// ${fileExtname}: the current opened file's extension
+// ${cwd}: the current working directory of the spawned process
+{
+  // See https://go.microsoft.com/fwlink/?LinkId=733558
+  // for the documentation about the tasks.json format
+  "version": "2.0.0",
+
+  // Start PowerShell
+  "windows": {
+    "options": {
+      "shell": {
+        "executable": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe",
+        "args": [
+          "-NoProfile",
+          "-ExecutionPolicy",
+          "Bypass",
+          "-Command"
+        ]
+      }
+    }
+  },
+  "linux": {
+    "options": {
+      "shell": {
+        "executable": "/usr/bin/pwsh",
+        "args": [
+          "-NoProfile",
+          "-Command"
+        ]
+      }
+    }
+  },
+  "osx": {
+    "options": {
+      "shell": {
+        "executable": "/usr/local/bin/pwsh",
+        "args": [
+          "-NoProfile",
+          "-Command"
+        ]
+      }
+    }
+  },
+
+  // Associate with test task runner
+  "tasks": [
+    {
+      "label": "Run All Tests (PowerShell Desktop)",
+      "group": "test",
+      "type": "shell",
+      "command": "$ErrorActionPreference = 'Stop'; $global:PesterDebugPreference_ShowFullErrors = $true ; $PSVersionTable; Set-StrictMode -Version Latest; Import-Module .\\Pester.psd1; Invoke-Pester -ExcludeTag VersionChecks, StyleRules, Help",
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      },
+      "problemMatcher": [
+        "$pester"
+      ]
+    },
+    {
+      "label": "Run All Tests (PowerShell v2 Desktop)",
+      "group": "test",
+      "type": "shell",
+      "command": "& C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\PowerShell.exe -Version 2.0 -NoProfile -ExecutionPolicy Bypass -Command '$ErrorActionPreference = ''Stop''; $global:PesterDebugPreference_ShowFullErrors = $true ; $PSVersionTable; Set-StrictMode -Version Latest; Import-Module .\\Pester.psd1; Invoke-Pester -ExcludeTag VersionChecks, StyleRules, Help'",
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      },
+      "problemMatcher": [
+        "$pester"
+      ]
+    },
+    {
+      "label": "Run All Tests (PowerShell Core)",
+      "group": "test",
+      "type": "shell",
+      "command": "& '${env:ProgramFiles}\\PowerShell\\6\\pwsh.exe' -NoProfile -Command '$ErrorActionPreference = ''Stop''; $global:PesterDebugPreference_ShowFullErrors = $true; $PSVersionTable; Set-StrictMode -Version Latest; Import-Module .\\Pester.psd1; Invoke-Pester -ExcludeTag VersionChecks, StyleRules, Help'",
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      },
+      "problemMatcher": [
+        "$pester"
+      ]
+    },
+    {
+      "label": "Run RSpec Pester Tests (PowerShell Desktop)",
+      "group": "test",
+      "type": "shell",
+      "command": "$ErrorActionPreference = 'Stop'; $global:PesterDebugPreference_ShowFullErrors = $true ; $PSVersionTable; Set-StrictMode -Version Latest; Import-Module .\\Pester.psd1; Invoke-Pester -ExcludeTag VersionChecks, StyleRules, Help, Gherkin",
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      },
+      "problemMatcher": [
+        "$pester"
+      ]
+    },
+    {
+      "label": "Run RSpec Pester Tests (PowerShell v2 Desktop)",
+      "group": "test",
+      "type": "shell",
+      "command": "& C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\PowerShell.exe -Version 2.0 -NoProfile -ExecutionPolicy Bypass -Command '$ErrorActionPreference = ''Stop''; $global:PesterDebugPreference_ShowFullErrors = $true ; $PSVersionTable; Set-StrictMode -Version Latest; Import-Module .\\Pester.psd1; Invoke-Pester -ExcludeTag VersionChecks, StyleRules, Help, Gherkin'",
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      },
+      "problemMatcher": [
+        "$pester"
+      ]
+    },
+    {
+      "label": "Run RSpec Pester Tests (PowerShell Core)",
+      "group": "test",
+      "type": "shell",
+      "command": "& '${env:ProgramFiles}\\PowerShell\\6\\pwsh.exe' -NoProfile -Command '$ErrorActionPreference = ''Stop''; $global:PesterDebugPreference_ShowFullErrors = $true; $PSVersionTable; Set-StrictMode -Version Latest; Import-Module .\\Pester.psd1; Invoke-Pester -ExcludeTag VersionChecks, StyleRules, Help, Gherkin'",
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      },
+      "problemMatcher": [
+        "$pester"
+      ]
+    },
+    {
+      "label": "Run Gherkin Pester Tests (PowerShell Desktop)",
+      "group": "test",
+      "type": "shell",
+      "command": "$ErrorActionPreference = 'Stop'; $global:PesterDebugPreference_ShowFullErrors = $true ; $PSVersionTable; Set-StrictMode -Version Latest; Import-Module .\\Pester.psd1; Invoke-Pester -ExcludeTag VersionChecks, StyleRules, Help -Tag Gherkin",
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      },
+      "problemMatcher": [
+        "$pester"
+      ]
+    },
+    {
+      "label": "Run Gherkin Pester Tests (PowerShell v2 Desktop)",
+      "group": "test",
+      "type": "shell",
+      "command": "& C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\PowerShell.exe -Version 2.0 -NoProfile -ExecutionPolicy Bypass -Command '$ErrorActionPreference = ''Stop''; $global:PesterDebugPreference_ShowFullErrors = $true ; $PSVersionTable; Set-StrictMode -Version Latest; Import-Module .\\Pester.psd1; Invoke-Pester -ExcludeTag VersionChecks, StyleRules, Help -Tag Gherkin'",
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      },
+      "problemMatcher": [
+        "$pester"
+      ]
+    },
+    {
+      "label": "Run Gherkin Pester Tests (PowerShell Core)",
+      "group": "test",
+      "type": "shell",
+      "command": "& '${env:ProgramFiles}\\PowerShell\\6\\pwsh.exe' -NoProfile -Command '$ErrorActionPreference = ''Stop''; $global:PesterDebugPreference_ShowFullErrors = $true; $PSVersionTable; Set-StrictMode -Version Latest; Import-Module .\\Pester.psd1; Invoke-Pester -ExcludeTag VersionChecks, StyleRules, Help -Tag Gherkin'",
+      "presentation": {
+        "reveal": "always",
+        "panel": "new"
+      },
+      "problemMatcher": [
+        "$pester"
+      ]
+    }
+  ]
+}

Examples/Gherkin/Gherkin-PesterResultShowsFeatureAndScenarioNames.feature

@@ -30,8 +30,10 @@ Feature: PesterResult shows executed feature names
         # The following example fails in the Given code block
         | FailedEarly     | FailedEarlyScenarios |
 
-      Examples: Failing Scenario (inconclusive)
+      Examples: Undefined Scenario (inconclusive)
         | Outcome         | Status               |
-        # In PesterResult.Steps.ps1 we do not implement anything for the following example
-        # to produce an inconclusive test result
-        | Does not matter | Does not matter      |
+        | Undefined       | UndefinedScenarios   |
+
+      Examples: Pending Scenario
+        | Outcome         | Status               |
+        | Pending         | PendingScenarios     |

Examples/Gherkin/JustForReporting.Steps.ps1

@@ -67,6 +67,13 @@ When "step_402" {
 Then "step_403" {
 }
 
+Given 'step_501' {
+    throw 'An example error in the given clause'
+}
+
+When 'step_502' {
+}
+
 Given "step_701" {
     throw "An example error in the given clause"
 }

Examples/Gherkin/PesterResult.Steps.ps1

@@ -1,15 +1,18 @@
 Given "this feature and scenario" { }
-When "(it|the scenario) is executed" { }
+When "(?n)(it|the scenario) is executed" { }
 Then "the feature name is displayed in the test report" { }
 
-Given "this is a '(?<Outcome>(Passed|Failed(?:Early|Later)))' scenario" {
+Given "this is a '(?<Outcome>(Passed|Pending|Failed(?:Early|Later)))' scenario" {
     param($Outcome)
-    if ($Outcome -eq 'FailedEarly') {
+    if ($Outcome -match 'FailedEarly') {
         throw "We fail for test by intention in the Given code block"
     }
+    elseif ($Outcome -eq 'Pending') {
+        Set-StepPending
+    }
 }
 
-Then "the scenario name is displayed in the '(?<Status>(Passed|Failed(?:Early|Later))Scenarios)' array of the PesterResults object" {
+Then "(?n)the scenario name is displayed in the '(?<Status>(Passed|Pending|Failed(Early|Later))Scenarios)' array of the PesterResults object" {
     param($Status)
 
     # Forcing a failure on FailedScenarios to ensure that the FailedScenarios array