Pester

4.8.0

Functions/SetupTeardown.ps1

                                function BeforeEach {

    <#

    .SYNOPSIS

        Defines a series of steps to perform at the beginning of every It block within

        the current Context or Describe block.

    .DESCRIPTION

        BeforeEach, AfterEach, BeforeAll, and AfterAll are unique in that they apply

        to the entire Context or Describe block, regardless of the order of the

        statements in the Context or Describe.  For a full description of this

        behavior, as well as how multiple BeforeEach or AfterEach blocks interact

        with each other, please refer to the about_BeforeEach_AfterEach help file.

    .LINK

        https://github.com/pester/Pester/wiki/BeforeEach-and-AfterEach

    .LINK

        about_BeforeEach_AfterEach

    #>

    [CmdletBinding()]

    param

    (

        # the scriptblock to execute

        [Parameter(Mandatory = $true,

            Position = 1)]

        [Scriptblock]

        $Scriptblock

    )

    Assert-DescribeInProgress -CommandName BeforeEach

}

function AfterEach {

    <#

    .SYNOPSIS

        Defines a series of steps to perform at the end of every It block within

        the current Context or Describe block.

    .DESCRIPTION

        BeforeEach, AfterEach, BeforeAll, and AfterAll are unique in that they apply

        to the entire Context or Describe block, regardless of the order of the

        statements in the Context or Describe.  For a full description of this

        behavior, as well as how multiple BeforeEach or AfterEach blocks interact

        with each other, please refer to the about_BeforeEach_AfterEach help file.

    .LINK

        https://github.com/pester/Pester/wiki/BeforeEach-and-AfterEach

    .LINK

        about_BeforeEach_AfterEach

    #>

    [CmdletBinding()]

    param

    (

        # the scriptblock to execute

        [Parameter(Mandatory = $true,

            Position = 1)]

        [Scriptblock]

        $Scriptblock

    )

    Assert-DescribeInProgress -CommandName AfterEach

}

function BeforeAll {

    <#

    .SYNOPSIS

        Defines a series of steps to perform at the beginning of the current Context

        or Describe block.

    .DESCRIPTION

        BeforeEach, AfterEach, BeforeAll, and AfterAll are unique in that they apply

        to the entire Context or Describe block, regardless of the order of the

        statements in the Context or Describe.

    .LINK

        https://github.com/pester/Pester/wiki/BeforeEach-and-AfterEach

    .LINK

        about_BeforeEach_AfterEach

    #>

    [CmdletBinding()]

    param

    (

        # the scriptblock to execute

        [Parameter(Mandatory = $true,

            Position = 1)]

        [Scriptblock]

        $Scriptblock

    )

    Assert-DescribeInProgress -CommandName BeforeAll

}

function AfterAll {

    <#

.SYNOPSIS

    Defines a series of steps to perform at the end of the current Context

    or Describe block.

.DESCRIPTION

    BeforeEach, AfterEach, BeforeAll, and AfterAll are unique in that they apply

    to the entire Context or Describe block, regardless of the order of the

    statements in the Context or Describe.

    .LINK

        https://github.com/pester/Pester/wiki/BeforeEach-and-AfterEach

    .LINK

    about_BeforeEach_AfterEach

#>

    [CmdletBinding()]

    param

    (

        # the scriptblock to execute

        [Parameter(Mandatory = $true,

            Position = 1)]

        [Scriptblock]

        $Scriptblock

    )

    Assert-DescribeInProgress -CommandName AfterAll

}

function Invoke-TestCaseSetupBlocks {

    Invoke-Blocks -ScriptBlock $pester.GetTestCaseSetupBlocks()

}

function Invoke-TestCaseTeardownBlocks {

    Invoke-Blocks -ScriptBlock $pester.GetTestCaseTeardownBlocks()

}

function Invoke-TestGroupSetupBlocks {

    Invoke-Blocks -ScriptBlock $pester.GetCurrentTestGroupSetupBlocks()

}

function Invoke-TestGroupTeardownBlocks {

    Invoke-Blocks -ScriptBlock $pester.GetCurrentTestGroupTeardownBlocks()

}

function Invoke-Blocks {

    param ([scriptblock[]] $ScriptBlock)

    foreach ($block in $ScriptBlock) {

        if ($null -eq $block) {

            continue

        }

        $null = . $block

    }

}

function Add-SetupAndTeardown {

    param (

        [scriptblock] $ScriptBlock

    )

    if ($PSVersionTable.PSVersion.Major -le 2) {

        Add-SetupAndTeardownV2 -ScriptBlock $ScriptBlock

    }

    else {

        Add-SetupAndTeardownV3 -ScriptBlock $ScriptBlock

    }

}

function Add-SetupAndTeardownV3 {

    param (

        [scriptblock] $ScriptBlock

    )

    $pattern = '^(?:Before|After)(?:Each|All)$'

    $predicate = {

        param ([System.Management.Automation.Language.Ast] $Ast)

        $Ast -is [System.Management.Automation.Language.CommandAst] -and

        $Ast.CommandElements[0].ToString() -match $pattern -and

        $Ast.CommandElements[-1] -is [System.Management.Automation.Language.ScriptBlockExpressionAst]

    }

    $searchNestedBlocks = $false

    $calls = $ScriptBlock.Ast.FindAll($predicate, $searchNestedBlocks)

    foreach ($call in $calls) {

        # For some reason, calling ScriptBlockAst.GetScriptBlock() sometimes blows up due to failing semantics

        # checks, even though the code is perfectly valid.  So we'll poke around with reflection again to skip

        # that part and just call the internal ScriptBlock constructor that we need

        $iPmdProviderType = [scriptblock].Assembly.GetType('System.Management.Automation.Language.IParameterMetadataProvider')

        $flags = [System.Reflection.BindingFlags]'Instance, NonPublic'

        $constructor = [scriptblock].GetConstructor($flags, $null, [Type[]]@($iPmdProviderType, [bool]), $null)

        $block = $constructor.Invoke(@($call.CommandElements[-1].ScriptBlock, $false))

        Set-ScriptBlockScope -ScriptBlock $block -SessionState $pester.SessionState

        $commandName = $call.CommandElements[0].ToString()

        Add-SetupOrTeardownScriptBlock -CommandName $commandName -ScriptBlock $block

    }

}

function Add-SetupAndTeardownV2 {

    param (

        [scriptblock] $ScriptBlock

    )

    $codeText = $ScriptBlock.ToString()

    $tokens = @(ParseCodeIntoTokens -CodeText $codeText)

    for ($i = 0; $i -lt $tokens.Count; $i++) {

        $token = $tokens[$i]

        $type = $token.Type

        if ($type -eq [System.Management.Automation.PSTokenType]::Command -and

            (IsSetupOrTeardownCommand -CommandName $token.Content)) {

            $openBraceIndex, $closeBraceIndex = Get-BraceIndicesForCommand -Tokens $tokens -CommandIndex $i

            $block = Get-ScriptBlockFromTokens -Tokens $Tokens -OpenBraceIndex $openBraceIndex -CloseBraceIndex $closeBraceIndex -CodeText $codeText

            Add-SetupOrTeardownScriptBlock -CommandName $token.Content -ScriptBlock $block

            $i = $closeBraceIndex

        }

        elseif ($type -eq [System.Management.Automation.PSTokenType]::GroupStart) {

            # We don't want to parse Setup or Teardown commands in child scopes here, so anything

            # bounded by a GroupStart / GroupEnd token pair which is not immediately preceded by

            # a setup / teardown command name is ignored.

            $i = Get-GroupCloseTokenIndex -Tokens $tokens -GroupStartTokenIndex $i

        }

    }

}

function ParseCodeIntoTokens {

    param ([string] $CodeText)

    $parseErrors = $null

    $tokens = [System.Management.Automation.PSParser]::Tokenize($CodeText, [ref] $parseErrors)

    if ($parseErrors.Count -gt 0) {

        $currentScope = $pester.CurrentTestGroup.Hint

        if (-not $currentScope) {

            $currentScope = 'test group'

        }

        throw "The current $currentScope block contains syntax errors."

    }

    return $tokens

}

function IsSetupOrTeardownCommand {

    param ([string] $CommandName)

    return (IsSetupCommand -CommandName $CommandName) -or (IsTeardownCommand -CommandName $CommandName)

}

function IsSetupCommand {

    param ([string] $CommandName)

    return $CommandName -eq 'BeforeEach' -or $CommandName -eq 'BeforeAll'

}

function IsTeardownCommand {

    param ([string] $CommandName)

    return $CommandName -eq 'AfterEach' -or $CommandName -eq 'AfterAll'

}

function IsTestGroupCommand {

    param ([string] $CommandName)

    return $CommandName -eq 'BeforeAll' -or $CommandName -eq 'AfterAll'

}

function Get-BraceIndicesForCommand {

    param (

        [System.Management.Automation.PSToken[]] $Tokens,

        [int] $CommandIndex

    )

    $openingGroupTokenIndex = Get-GroupStartTokenForCommand -Tokens $Tokens -CommandIndex $CommandIndex

    $closingGroupTokenIndex = Get-GroupCloseTokenIndex -Tokens $Tokens -GroupStartTokenIndex $openingGroupTokenIndex

    return $openingGroupTokenIndex, $closingGroupTokenIndex

}

function Get-GroupStartTokenForCommand {

    param (

        [System.Management.Automation.PSToken[]] $Tokens,

        [int] $CommandIndex

    )

    $commandName = $Tokens[$CommandIndex].Content

    # gets ScriptBlock from positional parameter e.g. BeforeEach { <code> }

    if ($CommandIndex + 1 -lt $tokens.Count -and

        ($tokens[$CommandIndex + 1].Type -eq [System.Management.Automation.PSTokenType]::GroupStart -or

            $tokens[$CommandIndex + 1].Content -eq '{')) {

        return $CommandIndex + 1

    }

    # gets ScriptBlock from named parameter e.g. BeforeEach -ScriptBlock { <code> }

    if ($CommandIndex + 2 -lt $tokens.Count -and

        ($tokens[$CommandIndex + 2].Type -eq [System.Management.Automation.PSTokenType]::GroupStart -or

            $tokens[$CommandIndex + 2].Content -eq '{')) {

        return $CommandIndex + 2

    }

    throw "The $commandName command must be followed by the script block as the first argument or named parameter value."

}

& $SafeCommands['Add-Type'] -TypeDefinition @'

    namespace Pester

    {

        using System;

        using System.Management.Automation;

        public static class ClosingBraceFinder

        {

            public static int GetClosingBraceIndex(PSToken[] tokens, int startIndex)

            {

                int groupLevel = 1;

                int len = tokens.Length;

                for (int i = startIndex + 1; i < len; i++)

                {

                    PSTokenType type = tokens[i].Type;

                    if (type == PSTokenType.GroupStart)

                    {

                        groupLevel++;

                    }

                    else if (type == PSTokenType.GroupEnd)

                    {

                        groupLevel--;

                        if (groupLevel <= 0) { return i; }

                    }

                }

                return -1;

            }

        }

    }

'@

function Get-GroupCloseTokenIndex {

    param (

        [System.Management.Automation.PSToken[]] $Tokens,

        [int] $GroupStartTokenIndex

    )

    $closeIndex = [Pester.ClosingBraceFinder]::GetClosingBraceIndex($Tokens, $GroupStartTokenIndex)

    if ($closeIndex -lt 0) {

        throw 'No corresponding GroupEnd token was found.'

    }

    return $closeIndex

}

function Get-ScriptBlockFromTokens {

    param (

        [System.Management.Automation.PSToken[]] $Tokens,

        [int] $OpenBraceIndex,

        [int] $CloseBraceIndex,

        [string] $CodeText

    )

    $blockStart = $Tokens[$OpenBraceIndex + 1].Start

    $blockLength = $Tokens[$CloseBraceIndex].Start - $blockStart

    $setupOrTeardownCodeText = $codeText.Substring($blockStart, $blockLength)

    $scriptBlock = [scriptblock]::Create($setupOrTeardownCodeText)

    Set-ScriptBlockHint -Hint "Unbound ScriptBlock from Get-ScriptBlockFromTokens" -ScriptBlock $scriptBlock

    Set-ScriptBlockScope -ScriptBlock $scriptBlock -SessionState $pester.SessionState

    return $scriptBlock

}

function Add-SetupOrTeardownScriptBlock {

    param (

        [string] $CommandName,

        [scriptblock] $ScriptBlock

    )

    $Pester.AddSetupOrTeardownBlock($ScriptBlock, $CommandName)

}

# SIG # Begin signature block

# MIIcVgYJKoZIhvcNAQcCoIIcRzCCHEMCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUDdmQKUqreqBbIJ+b89cR10vk

# tl2ggheFMIIFDjCCA/agAwIBAgIQAkpwj7JyQh8pn8abOhJIUDANBgkqhkiG9w0B

# AQsFADByMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYD

# VQQLExB3d3cuZGlnaWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFz

# c3VyZWQgSUQgQ29kZSBTaWduaW5nIENBMB4XDTE4MTEyNzAwMDAwMFoXDTE5MTIw

# MjEyMDAwMFowSzELMAkGA1UEBhMCQ1oxDjAMBgNVBAcTBVByYWhhMRUwEwYDVQQK

# DAxKYWt1YiBKYXJlxaExFTATBgNVBAMMDEpha3ViIEphcmXFoTCCASIwDQYJKoZI

# hvcNAQEBBQADggEPADCCAQoCggEBAKgBHbFhyeivpcxqohppsNGucvZvAyvg3gKT

# M1B6EpI18C6NN7FXWTPym9ffe1kS5ZeYDKW98NcOBArm28mdgip6WcUQ0qMt9lI8

# EsTa4Ohlkj/AYYUdgh96zgIl/V+MIO3JVAY3OwkWjkfDKVbzrNG5IcO5yKfwnt8/

# a238OS/VlFNsNELGW7XIQBD/rKrEDY8JZReIrkz6sGdba+3OcXBClp513JFniVgD

# vOXo2RDUqtnpFuCdsthe8hWXtpbcjIpFykLzNcNA+2GIbwbBG5XKXsN0ZJsbrWVA

# RiwNoDN+Fh3pe5rxGVfMDHdXt1I0KpJbFlGB4P7Sy2Mh5CTwRyUCAwEAAaOCAcUw

# ggHBMB8GA1UdIwQYMBaAFFrEuXsqCqOl6nEDwGD5LfZldQ5YMB0GA1UdDgQWBBSw

# +E81VeF9HSgNxUARWWqXFWZrZjAOBgNVHQ8BAf8EBAMCB4AwEwYDVR0lBAwwCgYI

# KwYBBQUHAwMwdwYDVR0fBHAwbjA1oDOgMYYvaHR0cDovL2NybDMuZGlnaWNlcnQu

# Y29tL3NoYTItYXNzdXJlZC1jcy1nMS5jcmwwNaAzoDGGL2h0dHA6Ly9jcmw0LmRp

# Z2ljZXJ0LmNvbS9zaGEyLWFzc3VyZWQtY3MtZzEuY3JsMEwGA1UdIARFMEMwNwYJ

# YIZIAYb9bAMBMCowKAYIKwYBBQUHAgEWHGh0dHBzOi8vd3d3LmRpZ2ljZXJ0LmNv

# bS9DUFMwCAYGZ4EMAQQBMIGEBggrBgEFBQcBAQR4MHYwJAYIKwYBBQUHMAGGGGh0

# dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBOBggrBgEFBQcwAoZCaHR0cDovL2NhY2Vy

# dHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0U0hBMkFzc3VyZWRJRENvZGVTaWduaW5n

# Q0EuY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggEBAFltMO2WO9L/

# fLYIbzeQIilLoH97l9PYQAPz5uNh4R8l5w6Y/SgusY3+k+KaNONXSTcSL1KP9Pn3

# 2y11xqFwdrJbRxC8i5x2KFvGDGkvpDWFsX24plq5brRL+qerkyTwRgSRUiU/luvq

# BTYQ/eQmgikkIB6l7f6m2An8qtOkNfDM0D/eVJS3+/TRSMIPmBp9Ubktacp8sNIK

# JacAkVl1zjucvVhyuWOFsIFtPn25XsiNu4d87pUyMzm8Vehyl1xxLNH/6cqxCkyG

# FXCrav1knrz22qD5b8wrwUYnmCt37BeBX6KvpSXpafDdAok5QkPs7TeJVcVVPdb4

# tqaLNvGOpBgwggUwMIIEGKADAgECAhAECRgbX9W7ZnVTQ7VvlVAIMA0GCSqGSIb3

# DQEBCwUAMGUxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAX

# BgNVBAsTEHd3dy5kaWdpY2VydC5jb20xJDAiBgNVBAMTG0RpZ2lDZXJ0IEFzc3Vy

# ZWQgSUQgUm9vdCBDQTAeFw0xMzEwMjIxMjAwMDBaFw0yODEwMjIxMjAwMDBaMHIx

# CzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3

# dy5kaWdpY2VydC5jb20xMTAvBgNVBAMTKERpZ2lDZXJ0IFNIQTIgQXNzdXJlZCBJ

# RCBDb2RlIFNpZ25pbmcgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQD407Mcfw4Rr2d3B9MLMUkZz9D7RZmxOttE9X/lqJ3bMtdx6nadBS63j/qSQ8Cl

# +YnUNxnXtqrwnIal2CWsDnkoOn7p0WfTxvspJ8fTeyOU5JEjlpB3gvmhhCNmElQz

# UHSxKCa7JGnCwlLyFGeKiUXULaGj6YgsIJWuHEqHCN8M9eJNYBi+qsSyrnAxZjNx

# PqxwoqvOf+l8y5Kh5TsxHM/q8grkV7tKtel05iv+bMt+dDk2DZDv5LVOpKnqagqr

# hPOsZ061xPeM0SAlI+sIZD5SlsHyDxL0xY4PwaLoLFH3c7y9hbFig3NBggfkOItq

# cyDQD2RzPJ6fpjOp/RnfJZPRAgMBAAGjggHNMIIByTASBgNVHRMBAf8ECDAGAQH/

# AgEAMA4GA1UdDwEB/wQEAwIBhjATBgNVHSUEDDAKBggrBgEFBQcDAzB5BggrBgEF

# BQcBAQRtMGswJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBD

# BggrBgEFBQcwAoY3aHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0

# QXNzdXJlZElEUm9vdENBLmNydDCBgQYDVR0fBHoweDA6oDigNoY0aHR0cDovL2Ny

# bDQuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNybDA6oDig

# NoY0aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9v

# dENBLmNybDBPBgNVHSAESDBGMDgGCmCGSAGG/WwAAgQwKjAoBggrBgEFBQcCARYc

# aHR0cHM6Ly93d3cuZGlnaWNlcnQuY29tL0NQUzAKBghghkgBhv1sAzAdBgNVHQ4E

# FgQUWsS5eyoKo6XqcQPAYPkt9mV1DlgwHwYDVR0jBBgwFoAUReuir/SSy4IxLVGL

# p6chnfNtyA8wDQYJKoZIhvcNAQELBQADggEBAD7sDVoks/Mi0RXILHwlKXaoHV0c

# LToaxO8wYdd+C2D9wz0PxK+L/e8q3yBVN7Dh9tGSdQ9RtG6ljlriXiSBThCk7j9x

# jmMOE0ut119EefM2FAaK95xGTlz/kLEbBw6RFfu6r7VRwo0kriTGxycqoSkoGjpx

# KAI8LpGjwCUR4pwUR6F6aGivm6dcIFzZcbEMj7uo+MUSaJ/PQMtARKUT8OZkDCUI

# QjKyNookAv4vcn4c10lFluhZHen6dGRrsutmQ9qzsIzV6Q3d9gEgzpkxYz0IGhiz

# gZtPxpMQBvwHgfqL2vmCSfdibqFT+hKUGIUukpHqaGxEMrJmoecYpJpkUe8wggZq

# MIIFUqADAgECAhADAZoCOv9YsWvW1ermF/BmMA0GCSqGSIb3DQEBBQUAMGIxCzAJ

# BgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5k

# aWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IEFzc3VyZWQgSUQgQ0EtMTAe

# Fw0xNDEwMjIwMDAwMDBaFw0yNDEwMjIwMDAwMDBaMEcxCzAJBgNVBAYTAlVTMREw

# DwYDVQQKEwhEaWdpQ2VydDElMCMGA1UEAxMcRGlnaUNlcnQgVGltZXN0YW1wIFJl

# c3BvbmRlcjCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKNkXfx8s+CC

# NeDg9sYq5kl1O8xu4FOpnx9kWeZ8a39rjJ1V+JLjntVaY1sCSVDZg85vZu7dy4Xp

# X6X51Id0iEQ7Gcnl9ZGfxhQ5rCTqqEsskYnMXij0ZLZQt/USs3OWCmejvmGfrvP9

# Enh1DqZbFP1FI46GRFV9GIYFjFWHeUhG98oOjafeTl/iqLYtWQJhiGFyGGi5uHzu

# 5uc0LzF3gTAfuzYBje8n4/ea8EwxZI3j6/oZh6h+z+yMDDZbesF6uHjHyQYuRhDI

# jegEYNu8c3T6Ttj+qkDxss5wRoPp2kChWTrZFQlXmVYwk/PJYczQCMxr7GJCkawC

# wO+k8IkRj3cCAwEAAaOCAzUwggMxMA4GA1UdDwEB/wQEAwIHgDAMBgNVHRMBAf8E

# AjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMIIBvwYDVR0gBIIBtjCCAbIwggGh

# BglghkgBhv1sBwEwggGSMCgGCCsGAQUFBwIBFhxodHRwczovL3d3dy5kaWdpY2Vy

# dC5jb20vQ1BTMIIBZAYIKwYBBQUHAgIwggFWHoIBUgBBAG4AeQAgAHUAcwBlACAA

# bwBmACAAdABoAGkAcwAgAEMAZQByAHQAaQBmAGkAYwBhAHQAZQAgAGMAbwBuAHMA

# dABpAHQAdQB0AGUAcwAgAGEAYwBjAGUAcAB0AGEAbgBjAGUAIABvAGYAIAB0AGgA

# ZQAgAEQAaQBnAGkAQwBlAHIAdAAgAEMAUAAvAEMAUABTACAAYQBuAGQAIAB0AGgA

# ZQAgAFIAZQBsAHkAaQBuAGcAIABQAGEAcgB0AHkAIABBAGcAcgBlAGUAbQBlAG4A

# dAAgAHcAaABpAGMAaAAgAGwAaQBtAGkAdAAgAGwAaQBhAGIAaQBsAGkAdAB5ACAA

# YQBuAGQAIABhAHIAZQAgAGkAbgBjAG8AcgBwAG8AcgBhAHQAZQBkACAAaABlAHIA

# ZQBpAG4AIABiAHkAIAByAGUAZgBlAHIAZQBuAGMAZQAuMAsGCWCGSAGG/WwDFTAf

# BgNVHSMEGDAWgBQVABIrE5iymQftHt+ivlcNK2cCzTAdBgNVHQ4EFgQUYVpNJLZJ

# Mp1KKnkag0v0HonByn0wfQYDVR0fBHYwdDA4oDagNIYyaHR0cDovL2NybDMuZGln

# aWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEQ0EtMS5jcmwwOKA2oDSGMmh0dHA6

# Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRENBLTEuY3JsMHcG

# CCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGlnaWNlcnQu

# Y29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5jb20vRGln

# aUNlcnRBc3N1cmVkSURDQS0xLmNydDANBgkqhkiG9w0BAQUFAAOCAQEAnSV+GzNN

# siaBXJuGziMgD4CH5Yj//7HUaiwx7ToXGXEXzakbvFoWOQCd42yE5FpA+94GAYw3

# +puxnSR+/iCkV61bt5qwYCbqaVchXTQvH3Gwg5QZBWs1kBCge5fH9j/n4hFBpr1i

# 2fAnPTgdKG86Ugnw7HBi02JLsOBzppLA044x2C/jbRcTBu7kA7YUq/OPQ6dxnSHd

# FMoVXZJB2vkPgdGZdA0mxA5/G7X1oPHGdwYoFenYk+VVFvC7Cqsc21xIJ2bIo4sK

# HOWV2q7ELlmgYd3a822iYemKC23sEhi991VUQAOSK2vCUcIKSK+w1G7g9BQKOhvj

# jz3Kr2qNe9zYRDCCBs0wggW1oAMCAQICEAb9+QOWA63qAArrPye7uhswDQYJKoZI

# hvcNAQEFBQAwZTELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZ

# MBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEkMCIGA1UEAxMbRGlnaUNlcnQgQXNz

# dXJlZCBJRCBSb290IENBMB4XDTA2MTExMDAwMDAwMFoXDTIxMTExMDAwMDAwMFow

# YjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQ

# d3d3LmRpZ2ljZXJ0LmNvbTEhMB8GA1UEAxMYRGlnaUNlcnQgQXNzdXJlZCBJRCBD

# QS0xMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA6IItmfnKwkKVpYBz

# QHDSnlZUXKnE0kEGj8kz/E1FkVyBn+0snPgWWd+etSQVwpi5tHdJ3InECtqvy15r

# 7a2wcTHrzzpADEZNk+yLejYIA6sMNP4YSYL+x8cxSIB8HqIPkg5QycaH6zY/2DDD

# /6b3+6LNb3Mj/qxWBZDwMiEWicZwiPkFl32jx0PdAug7Pe2xQaPtP77blUjE7h6z

# 8rwMK5nQxl0SQoHhg26Ccz8mSxSQrllmCsSNvtLOBq6thG9IhJtPQLnxTPKvmPv2

# zkBdXPao8S+v7Iki8msYZbHBc63X8djPHgp0XEK4aH631XcKJ1Z8D2KkPzIUYJX9

# BwSiCQIDAQABo4IDejCCA3YwDgYDVR0PAQH/BAQDAgGGMDsGA1UdJQQ0MDIGCCsG

# AQUFBwMBBggrBgEFBQcDAgYIKwYBBQUHAwMGCCsGAQUFBwMEBggrBgEFBQcDCDCC

# AdIGA1UdIASCAckwggHFMIIBtAYKYIZIAYb9bAABBDCCAaQwOgYIKwYBBQUHAgEW

# Lmh0dHA6Ly93d3cuZGlnaWNlcnQuY29tL3NzbC1jcHMtcmVwb3NpdG9yeS5odG0w

# ggFkBggrBgEFBQcCAjCCAVYeggFSAEEAbgB5ACAAdQBzAGUAIABvAGYAIAB0AGgA

# aQBzACAAQwBlAHIAdABpAGYAaQBjAGEAdABlACAAYwBvAG4AcwB0AGkAdAB1AHQA

# ZQBzACAAYQBjAGMAZQBwAHQAYQBuAGMAZQAgAG8AZgAgAHQAaABlACAARABpAGcA

# aQBDAGUAcgB0ACAAQwBQAC8AQwBQAFMAIABhAG4AZAAgAHQAaABlACAAUgBlAGwA

# eQBpAG4AZwAgAFAAYQByAHQAeQAgAEEAZwByAGUAZQBtAGUAbgB0ACAAdwBoAGkA

# YwBoACAAbABpAG0AaQB0ACAAbABpAGEAYgBpAGwAaQB0AHkAIABhAG4AZAAgAGEA

# cgBlACAAaQBuAGMAbwByAHAAbwByAGEAdABlAGQAIABoAGUAcgBlAGkAbgAgAGIA

# eQAgAHIAZQBmAGUAcgBlAG4AYwBlAC4wCwYJYIZIAYb9bAMVMBIGA1UdEwEB/wQI

# MAYBAf8CAQAweQYIKwYBBQUHAQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8vb2Nz

# cC5kaWdpY2VydC5jb20wQwYIKwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2lj

# ZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcnQwgYEGA1UdHwR6MHgw

# OqA4oDaGNGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJ

# RFJvb3RDQS5jcmwwOqA4oDaGNGh0dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9EaWdp

# Q2VydEFzc3VyZWRJRFJvb3RDQS5jcmwwHQYDVR0OBBYEFBUAEisTmLKZB+0e36K+

# Vw0rZwLNMB8GA1UdIwQYMBaAFEXroq/0ksuCMS1Ri6enIZ3zbcgPMA0GCSqGSIb3

# DQEBBQUAA4IBAQBGUD7Jtygkpzgdtlspr1LPUukxR6tWXHvVDQtBs+/sdR90OPKy

# XGGinJXDUOSCuSPRujqGcq04eKx1XRcXNHJHhZRW0eu7NoR3zCSl8wQZVann4+er

# Ys37iy2QwsDStZS9Xk+xBdIOPRqpFFumhjFiqKgz5Js5p8T1zh14dpQlc+Qqq8+c

# dkvtX8JLFuRLcEwAiR78xXm8TBJX/l/hHrwCXaj++wc4Tw3GXZG5D2dFzdaD7eeS

# DY2xaYxP+1ngIw/Sqq4AfO6cQg7PkdcntxbuD8O9fAqg7iwIVYUiuOsYGk38KiGt

# STGDR5V3cdyxG0tLHBCcdxTBnU8vWpUIKRAmMYIEOzCCBDcCAQEwgYYwcjELMAkG

# A1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRp

# Z2ljZXJ0LmNvbTExMC8GA1UEAxMoRGlnaUNlcnQgU0hBMiBBc3N1cmVkIElEIENv

# ZGUgU2lnbmluZyBDQQIQAkpwj7JyQh8pn8abOhJIUDAJBgUrDgMCGgUAoHgwGAYK

# KwYBBAGCNwIBDDEKMAigAoAAoQKAADAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIB

# BDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAjBgkqhkiG9w0BCQQxFgQU

# WMJmrH3zwizzpj2m5E/jWmQ+Y7gwDQYJKoZIhvcNAQEBBQAEggEAms0Yg53vH6v5

# hAzu10XXz0QfJE501foB3eMvR2g6sYP31hlHSzh1DG0Xw2P8L6CTMX7+n4g4+RWC

# sP70w4gxpgKrE7xMS1csxE0lfqDERLEK8rsf9DBR+MO7rVqKa34/rpCReAhpALcV

# 27XFj7b2I/BbDt/B5epxTjWFsq1X5X5Dwc56HzUY7IfPIo+1i/mJw9UnmAudUs50

# i3F6DQEQszW0vxK0aHciGrX7PFmYBAuiNLuDo3rPZEhfSJqbIU92Fb9Ruqf32L7C

# R5ANJkGfAAI+NniYBJ+vCSqZs5SpKS89P0xaHk1Vr9qyGz656nwWXoGwnfPN7lGX

# B7a53va/0aGCAg8wggILBgkqhkiG9w0BCQYxggH8MIIB+AIBATB2MGIxCzAJBgNV

# BAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdp

# Y2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IEFzc3VyZWQgSUQgQ0EtMQIQAwGa

# Ajr/WLFr1tXq5hfwZjAJBgUrDgMCGgUAoF0wGAYJKoZIhvcNAQkDMQsGCSqGSIb3

# DQEHATAcBgkqhkiG9w0BCQUxDxcNMTkwNTAxMTAyODAwWjAjBgkqhkiG9w0BCQQx

# FgQUMyyhzCA04rDAg47w1v3AOiGG7acwDQYJKoZIhvcNAQEBBQAEggEAgBPeUMyl

# VauwkWjSOZ0U0Uk6b5V17F+Mk5Q26SFmZpTv4GzOxlzn6LR35l7WeOoLmoe4B0qy

# +42OfvyUYCBPkxlTqy/glz/ushfQ7GNUKIvTP3kyNhIvT0lB9rKZI7eti83j91Cy

# m+/pv+urky/fCVLDVImwp1+APXBE1i9kf214XPL5SRgSAymF9ijVGhesvC08kyCO

# TMJ1QV/GhXwjmi1bBVCWjgnp59Osq0IZlMegcb4B+8sjJnI80JbjDz2ShcljGpYi

# wuJcpmmmUTeSf4OQkBeiLDcoLXXxZEpVygsC5rkGo/MV/TRRnAHn94J+G9mPNoFr

# ApC+xb5U5byVRg==

# SIG # End signature block