Functions/GherkinHook.ps1
|
function BeforeEachFeature { <# .SYNOPSIS Defines a ScriptBlock hook to run before each feature to set up the test environment .DESCRIPTION BeforeEachFeature hooks are run before each feature that is in (or above) the folder where the hook is defined. This is a convenience method, provided because unlike traditional RSpec Pester, there is not a simple test script where you can put setup and clean up. .PARAMETER Tags Optional tags. If set, this hook only runs for features with matching tags .PARAMETER Script The ScriptBlock to run for the hook .LINK AfterEachFeature BeforeEachScenario AfterEachScenario #> [CmdletBinding(DefaultParameterSetName="All")] param( [Parameter(Mandatory=$True, Position=0, ParameterSetName="Tags")] [String[]]$Tags = @(), [Parameter(Mandatory=$True, Position=1, ParameterSetName="Tags")] [Parameter(Mandatory=$True, Position=0, ParameterSetName="All")] [ScriptBlock]$Script ) # This shouldn't be necessary, but PowerShell 2 is BAF if ($PSCmdlet.ParameterSetName -eq "Tags") { ${Script:GherkinHooks}.BeforeEachFeature += @( @{ Tags = $Tags; Script = $Script } ) } else { ${Script:GherkinHooks}.BeforeEachFeature += @( @{ Tags = @(); Script = $Script } ) } } function AfterEachFeature { <# .SYNOPSIS Defines a ScriptBlock hook to run at the very end of a test run .DESCRIPTION AfterEachFeature hooks are run after each feature that is in (or above) the folder where the hook is defined. This is a convenience method, provided because unlike traditional RSpec Pester, there is not a simple test script where you can put setup and clean up. .PARAMETER Tags Optional tags. If set, this hook only runs for features with matching tags. .PARAMETER Script The ScriptBlock to run for the hook .LINK BeforeEachFeature BeforeEachScenario AfterEachScenario #> [CmdletBinding(DefaultParameterSetName="All")] param( [Parameter(Mandatory=$True, Position=0, ParameterSetName="Tags")] [String[]]$Tags = @(), [Parameter(Mandatory=$True, Position=1, ParameterSetName="Tags")] [Parameter(Mandatory=$True, Position=0, ParameterSetName="All")] [ScriptBlock]$Script ) # This shouldn't be necessary, but PowerShell 2 is BAF if ($PSCmdlet.ParameterSetName -eq "Tags") { ${Script:GherkinHooks}.AfterEachFeature += @( @{ Tags = $Tags; Script = $Script } ) } else { ${Script:GherkinHooks}.AfterEachFeature += @( @{ Tags = @(); Script = $Script } ) } } function BeforeEachScenario { <# .SYNOPSIS Defines a ScriptBlock hook to run before each scenario to set up the test environment .DESCRIPTION BeforeEachScenario hooks are run before each scenario that is in (or above) the folder where the hook is defined. You should not normally need this, because it overlaps significantly with the "Background" feature in the gherkin language. This is a convenience method, provided because unlike traditional RSpec Pester, there is not a simple test script where you can put setup and clean up. .PARAMETER Tags Optional tags. If set, this hook only runs for features with matching tags .PARAMETER Script The ScriptBlock to run for the hook .LINK AfterEachFeature BeforeEachScenario AfterEachScenario #> [CmdletBinding(DefaultParameterSetName="All")] param( [Parameter(Mandatory=$True, Position=0, ParameterSetName="Tags")] [String[]]$Tags = @(), [Parameter(Mandatory=$True, Position=1, ParameterSetName="Tags")] [Parameter(Mandatory=$True, Position=0, ParameterSetName="All")] [ScriptBlock]$Script ) # This shouldn't be necessary, but PowerShell 2 is BAF if ($PSCmdlet.ParameterSetName -eq "Tags") { ${Script:GherkinHooks}.BeforeEachScenario += @( @{ Tags = $Tags; Script = $Script } ) } else { ${Script:GherkinHooks}.BeforeEachScenario += @( @{ Tags = @(); Script = $Script } ) } } function AfterEachScenario { <# .SYNOPSIS Defines a ScriptBlock hook to run after each scenario to set up the test environment .DESCRIPTION AfterEachScenario hooks are run after each Scenario that is in (or above) the folder where the hook is defined. This is a convenience method, provided because unlike traditional RSpec Pester, there is not a simple test script where you can put setup and clean up. .PARAMETER Tags Optional tags. If set, this hook only runs for features with matching tags .PARAMETER Script The ScriptBlock to run for the hook .LINK BeforeEachFeature BeforeEachScenario AfterEachScenario #> [CmdletBinding(DefaultParameterSetName="All")] param( [Parameter(Mandatory=$True, Position=0, ParameterSetName="Tags")] [String[]]$Tags = @(), [Parameter(Mandatory=$True, Position=1, ParameterSetName="Tags")] [Parameter(Mandatory=$True, Position=0, ParameterSetName="All")] [ScriptBlock]$Script ) # This shouldn't be necessary, but PowerShell 2 is BAF if($PSCmdlet.ParameterSetName -eq "Tags") { ${Script:GherkinHooks}.AfterEachScenario += @( @{ Tags = $Tags; Script = $Script } ) } else { ${Script:GherkinHooks}.AfterEachScenario += @( @{ Tags = @(); Script = $Script } ) } } |