nxtools

0.4.0-preview0001

Modules/PSNativeCmdDevKit/0.1.0/PSNativeCmdDevKit.psm1

                                #Region './Public/Add-SudoPreferenceRule.ps1' 0

# Add-SudoPreferenceRule -Executable dpkg -ParameterFilterRule {$_.parameters -contains '-i' -or $_.parameters -contains '--install')}

# Add-SudoPreferenceRule -Executable dpkg -ParameterFilterRule {$_.parameters -contains '-W' -or $_.parameters -contains '--show')} -SudoUser otheruser

# Add-SudoPreferenceRule -EnableSudoForAllCommands

# Add-SudoPreferenceRule -EnableSudoForAllCommands -SudoUser otheruser

# Add-SudoPreferenceRule -DisableSudoForAllCommands

function  Add-SudoPreferenceRule

{

    param

    (

        [Parameter(ParameterSetName = 'Sudo', Mandatory = $true)]

        [Alias('Command')]

        # The binary or command the rule will affect.

        [string]

        $Executable,

        [Parameter(ParameterSetName = 'Sudo', Mandatory = $true)]

        # The Parameter filter to be evaluated for the command.

        # if you want to use sudo for an Executable, regardless of the parameters, use:

        # `-ParameterFilterRule *` or `-ParameterFilterRule {$true}`

        # Otherwise, you can evaluate the Parameters to be used, populated the $Args variable:

        # `-ParameterFilterRule {$args -contains '-i' -or $args -contains '--install'}

        [string]

        $ParameterFilterRule,

        [Parameter(ParameterSetName = 'SudoAll', Mandatory = $true)]

        # This will Enable sudo for any command, but won't destroy your

        # registered settings. You can set a $SudoUser to be used along.

        [switch]

        $EnableSudoForAllCommands,

        [Parameter(ParameterSetName = 'NoSudoAll', Mandatory = $true)]

        # This will ensure sudo is not automatically added to each command,

        # instead it will use the Sudo Preference rules registered with `Add-SudoPreferenceRule`.

        [switch]

        $DisableSudoForAllCommands,

        [Parameter(ParameterSetName = 'Sudo')]

        [Parameter(ParameterSetName = 'SudoAll')]

        # The executable that is invoked with sudo should be run as this user.

        # the resulting command invoked will be `sudo <sudo user> <executable> <parameters>`.

        [string]

        $SudoUser

    )

    if ($script:SudoPreferenceRules -isnot [System.Collections.ArrayList])

    {

        # There is no default rules store, let's create an array list

        $script:SudoPreferenceRules = [System.Collections.ArrayList]::new()

    }

    if ($EnableSudoForAllCommands.IsPresent -or $DisableSudoForAllCommands.IsPresent)

    {

        $Script:SudoAll = switch ($PSCmdlet.ParameterSetName)

        {

            NoSudoAll   { $false  }

            SudoAll     { $true   }

        }

        # If sudoUser is specified, set to SudoAllAs. Clean up if disabling SudoAll

        $script:SudoAllAs = $SudoUser

        return

    }

    elseif ($Executable -eq '*')

    {

        $Script:SudoAll = switch -regex ($ParameterFilterRule.Trim())

        {

            '^\$true$'  { $true }

            '^\$false$' { $false }

            Default     { $true }

        }

        $script:SudoAllAs = $SudoUser

    }

    $index = $null

    if (Get-SudoPreferenceRule -Executable $Executable -ParameterFilterRule $ParameterFilterRule)

    {

        Write-Warning "Sudo Preference Rule found. Replacing"

        $index = [int](Remove-SudoPreferenceRule -Executable $Executable -ParameterFilterRule $ParameterFilterRule)

    }

    # copy hash with Executable, ParameterFilterRule, and SudoUser if present

    $newRule = @{

        Executable          = $Executable

        ParameterFilterRule = $ParameterFilterRule

        SudoUser            = $SudoUser

    }

    if ($index)

    {

        Write-Debug "Replacing Sudo rule for '$Executable' with filter '$ParameterFilterRule' at index $index"

        $null = $script:SudoPreferenceRules.Insert($index, $newRule)

    }

    else

    {

        Write-Debug "Adding Sudo rule for '$Executable' with filter '$ParameterFilterRule'"

        $null = $script:SudoPreferenceRules.Add($newRule)

    }

}

#EndRegion './Public/Add-SudoPreferenceRule.ps1' 102

#Region './Public/Get-PropertyHashFromListOutput.ps1' 0

function Get-PropertyHashFromListOutput

{

    [CmdletBinding(DefaultParameterSetName = 'AddExtraPropertiesUnderKey')]

    [OutputType([hashtable])]

    param

    (

        [Parameter(ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true, Mandatory = $true)]

        [Object]

        # Output from a command, typically the result of Invoke-LinuxCommand.

        # Error records will be handled by the scriptblock in -ErrorHandling parameter.

        # The latter defaults to send the error record to Write-Error.

        $Output,

        [Parameter()]

        # Regex with 'property' & 'val' Named groups

        # of a string to extract an hashtable key/value pair from a string.

        [regex]

        $Regex = '^\s*(?<property>[\w-\s]*):\s*(?<val>.*)',

        [Parameter()]

        # List of property names allowed to be parsed.

        # Default to '*' for all properties, otherwise the parsed properties

        # not listed here will either be discarded if -DiscardExtraProperties is set

        # or will be added to a hashtable under the key named $AddExtraPropertiesAsKey.

        [string[]]

        $AllowedPropertyName = '*',

        [Parameter(ValueFromPipelineByPropertyName = $true, ParameterSetName = 'DiscardExtraProperties')]

        # When only a limited number of Property named is allowed using -AllowedPropertyName

        # parameter, the extra properties will be discarded.

        [switch]

        $DiscardExtraProperties,

        [Parameter(ParameterSetName = 'AddExtraPropertiesUnderKey')]

        # When only a limited number of Property named is allowed using -AllowedPropertyName

        # parameter, the extra properties will be added under the `$property[$AddExtraPropertiesAsKey]`

        # hash. For instance, `$property['ExtraProperties']['NotAllowedPropertyName'] = $ParsedValue`

        [string]

        $AddExtraPropertiesAsKey = 'ExtraProperties',

        [Parameter()]

        # When the output of a native command has had its `STDERR` redirected

        # using `2>&1`, we'll send the ErrorRecords (output from STDERR) to

        # this scriptblock. By default: `$errorRecord | &{ Write-Error $_}`.

        [scriptblock]

        $ErrorHandling = { Write-Error $_ }

    )

    begin

    {

        $properties = @{}

        if (-not $DiscardExtraProperties.isPresent)

        {

            $properties[$AddExtraPropertiesAsKey] = @{}

        }

    }

    process

    {

        foreach ($line in $Output)

        {

            Write-Debug "Output Line: $line"

            if ($line -is [System.Management.Automation.ErrorRecord])

            {

                $line | &$ErrorHandling

            }

            elseif ($line -match $Regex)

            {

                $propertyName = $Matches.property.replace('-','').replace(' ','')

                if ($AllowedPropertyName -contains '*' -or $AllowedPropertyName -contains $propertyName)

                {

                    $properties.Add($propertyName, $Matches.val)

                }

                else

                {

                    if (-not $DiscardExtraProperties.isPresent)

                    {

                        Write-Debug " Adding Property '$propertyName' to $AddExtraPropertiesAsKey"

                        $properties[$AddExtraPropertiesAsKey].Add($propertyName, $Matches.val)

                    }

                }

                $lastProperty = $propertyName

            }

            else

            {

                if (-not $lastProperty)

                {

                    Write-Verbose $line

                }

                elseif ($AllowedPropertyName -contains '*' -or $AllowedPropertyName -contains $lastProperty)

                {

                    Write-Debug "  Adding second line to property $lastProperty"

                    $properties[$lastProperty] += "`n" + $line.TrimEnd()

                }

                else

                {

                    $properties[$AddExtraPropertiesAsKey][$lastProperty] += $line.Trim()

                }

            }

        }

    }

    end

    {

        if ($properties[$AddExtraPropertiesAsKey].Count -eq 0)

        {

            Write-Debug "No Extra properties where found, removing unnecessary key '$AddExtraPropertiesAsKey'"

            $properties.Remove($AddExtraPropertiesAsKey)

        }

        $properties

    }

}

#EndRegion './Public/Get-PropertyHashFromListOutput.ps1' 114

#Region './Public/Get-SudoPreference.ps1' 0

function Get-SudoPreference

{

    [CmdletBinding()]

    [OutputType([hashtable])]

    param

    (

        [Parameter(Mandatory = $true)]

        [Alias('Command')]

        # The binary or command to be executed.

        [string]

        $Executable,

        [Parameter()]

        # List of parameters to pass to the invocation that will be

        # evaluated against the registered Sudo Preference Rules.

        [String[]]

        $Parameters

    )

    if ($script:SudoAll)

    {

        @{

            $Sudo = $true

            $SudoAs = $script:SudoAllAs

        }

    }

    elseif ($script:SudoPreferenceRules)

    {

        $enumerator = $script:SudoPreferenceRules.GetEnumerator()

        $RuleMatchFound = $false

        while ($enumerator.MoveNext() -and -not $RuleMatchFound)

        {

            $RuleMatchFound = $script:SudoPreferenceRules | Where-Object -FilterScript {

                $Executable -eq $_.Executable -and

                ($_.ParameterFilterRule.ToString().Trim() -eq '*' -or [scriptblock]::create($_.ParameterFilterRule).Invoke($Parameters))

            } | Select-Object -First 1

        }

        if ($RuleMatchFound)

        {

            return [hashtable]$RuleMatchFound

        }

        else

        {

            Write-Debug "No matching rules for '$Executable' with params '$Parameters'"

        }

    }

}

#EndRegion './Public/Get-SudoPreference.ps1' 48

#Region './Public/Get-SudoPreferenceRule.ps1' 0

function  Get-SudoPreferenceRule

{

    [CmdletBinding(DefaultParameterSetName = 'all')]

    [OutputType([System.Object[]])]

    param

    (

        [Parameter(ParameterSetName = 'byCommand', Mandatory = $true)]

        [Alias('Command')]

        # The binary or command to be executed.

        [string]

        $Executable,

        [Parameter(ParameterSetName = 'byCommand')]

        [string]

        $ParameterFilterRule,

        [Parameter(ParameterSetName = 'all')]

        [switch]

        $All

    )

    if ($script:SudoPreferenceRules -isnot [System.Collections.ArrayList])

    {

        # There is no default rules store, let's create an array list and return it

        $script:SudoPreferenceRules = [System.Collections.ArrayList]::new()

    }

    if ($PSCmdlet.ParameterSetName -eq 'All')

    {

        $script:SudoPreferenceRules

    }

    else

    {

        $script:SudoPreferenceRules.Where{

            $_.Executable -eq $Executable -and

            $(

                if ($ParameterFilterRule -and $ParameterFilterRule.Trim() -ne '*')

                {

                    $_.ParameterFilterRule -eq $ParameterFilterRule

                }

                else

                {

                    $true

                }

            )

        }

    }

}

#EndRegion './Public/Get-SudoPreferenceRule.ps1' 50

#Region './Public/Invoke-NativeCommand.ps1' 0

function Invoke-NativeCommand

{

    [cmdletBinding()]

    param

    (

        [Parameter(Mandatory = $true)]

        [Alias('Command')]

        # The binary or command you would like to execute.

        [string]

        $Executable,

        [Parameter()]

        # Whether you want to sudo the command invocation, on non-windows OSes.

        # If you want to sudo as a different user, use the parameter `-SudoAs`.

        [switch]

        $Sudo,

        [Parameter()]

        # Specify a user to sudo he command as. i.e.: `sudo otheruser ls -alh`

        [String]

        $SudoAs,

        [Parameter()]

        # list of Parameters to pass to the invocation.

        # For binaries and commands requiring a specific order

        # make sure it is respected as no further check is done.

        [String[]]

        $Parameters

    )

    # If Sudo or SudoAs is not specified, lookup in the Module variable DefaultCommandToSudo

    if ( -not ($PSBoundParameters.ContainsKey('Sudo') -or $PSBoundParameters.ContainsKey('SudoAs')) )

    {

        if ($DefaultSudo = Get-SudoPreference @PSBoundParameters)

        {

            $Sudo   = $DefaultSudo.Sudo

            $SudoAs = $DefaultSudo.SudoAs

        }

    }

    [string[]]$CommandExpression = @()

    if ($SudoAs -and ($IsLinux -or $IsMacOS))

    {

        $commandExpression += "sudo -u $SudoAs $Executable"

    }

    elseif ($Sudo -and ($IsLinux -or $IsMacOS))

    {

        $commandExpression += "sudo $Executable"

    }

    else

    {

        $commandExpression += $Executable

    }

    $commandExpression += $Parameters

    # Mixes the Error stream and the success streams (redirect STDERR with STDOUT)

    # What was in STDERR will be of type [ErrorRecord] if you need to differentiate for parsing.

    $commandExpression += '2>&1'

    Write-Verbose -Message "Running #> $commandExpression"

    [scriptblock]$commandExpression = [scriptblock]::create($commandExpression)

    # Stream the output through the pipeline

    & $commandExpression

}

#EndRegion './Public/Invoke-NativeCommand.ps1' 67

#Region './Public/Remove-SudoPreferenceRule.ps1' 0

function Remove-SudoPreferenceRule

{

    [cmdletBinding()]

    param

    (

        [Parameter(ParameterSetName = 'ByValue', Mandatory = $true, ValueFromPipelineByPropertyName = $true)]

        [Alias('Command')]

        # The executable that has the rule applied to.

        [string]

        $Executable,

        [Parameter(ParameterSetName = 'ByValue', Mandatory = $true, ValueFromPipelineByPropertyName = $true)]

        # The parameter filter rule to match with the executable to remve.

        [string]

        $ParameterFilterRule,

        [Parameter(Dontshow = $true, ParameterSetName = 'ByIndex', Mandatory = $true, ValueFromPipelineByPropertyName = $true)]

        # Remove the Rule stored in the module's $script:SudoPreferenceRules by its index (advanced user only)

        [int]

        $index,

        [Parameter(ParameterSetName = 'All', Mandatory = $true)]

        # Remove all previously registered rules.

        [switch]

        $All

    )

    begin

    {

        if ($script:SudoPreferenceRules -isnot [System.Collections.ArrayList])

        {

            # There is no default rules store

            return

        }

    }

    process

    {

        if ($PSCmdlet.ParameterSetName -eq 'ByIndex')

        {

            $script:SudoPreferenceRules.RemoveAt($Index)

            return

        }

        elseif ($PSCmdlet.ParameterSetName -eq 'All')

        {

            $script:SudoPreferenceRules.Clear()

            return

        }

        $CurrentIndex = 0

        $indexesToRemove = $script:SudoPreferenceRules.Foreach{

            if ($_.Executable -eq $Executable -and

                ($_.ParameterFilterRule.ToString().Trim() -eq '*' -or $_.ParameterFilterRule -eq $ParameterFilterRule)

            )

            {

                $CurrentIndex

            }

            $CurrentIndex++

        }

        $indexesToRemove.Foreach{

            $script:SudoPreferenceRules.RemoveAt($_)

            # return the Indexes where the rule has been removed

            $_

        }

    }

}

#EndRegion './Public/Remove-SudoPreferenceRule.ps1' 68

# SIG # Begin signature block

# MIInkwYJKoZIhvcNAQcCoIInhDCCJ4ACAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCC/AJYVnB8kXTzN

# D/TgdHk3/VlKZy4201atVRZEaL/flqCCDXYwggX0MIID3KADAgECAhMzAAACy7d1

# OfsCcUI2AAAAAALLMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMjIwNTEyMjA0NTU5WhcNMjMwNTExMjA0NTU5WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQC3sN0WcdGpGXPZIb5iNfFB0xZ8rnJvYnxD6Uf2BHXglpbTEfoe+mO//oLWkRxA

# wppditsSVOD0oglKbtnh9Wp2DARLcxbGaW4YanOWSB1LyLRpHnnQ5POlh2U5trg4

# 3gQjvlNZlQB3lL+zrPtbNvMA7E0Wkmo+Z6YFnsf7aek+KGzaGboAeFO4uKZjQXY5

# RmMzE70Bwaz7hvA05jDURdRKH0i/1yK96TDuP7JyRFLOvA3UXNWz00R9w7ppMDcN

# lXtrmbPigv3xE9FfpfmJRtiOZQKd73K72Wujmj6/Su3+DBTpOq7NgdntW2lJfX3X

# a6oe4F9Pk9xRhkwHsk7Ju9E/AgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUrg/nt/gj+BBLd1jZWYhok7v5/w4w

# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW

# MBQGA1UEBRMNMjMwMDEyKzQ3MDUyODAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci

# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG

# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu

# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0

# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAJL5t6pVjIRlQ8j4dAFJ

# ZnMke3rRHeQDOPFxswM47HRvgQa2E1jea2aYiMk1WmdqWnYw1bal4IzRlSVf4czf

# zx2vjOIOiaGllW2ByHkfKApngOzJmAQ8F15xSHPRvNMmvpC3PFLvKMf3y5SyPJxh

# 922TTq0q5epJv1SgZDWlUlHL/Ex1nX8kzBRhHvc6D6F5la+oAO4A3o/ZC05OOgm4

# EJxZP9MqUi5iid2dw4Jg/HvtDpCcLj1GLIhCDaebKegajCJlMhhxnDXrGFLJfX8j

# 7k7LUvrZDsQniJZ3D66K+3SZTLhvwK7dMGVFuUUJUfDifrlCTjKG9mxsPDllfyck

# 4zGnRZv8Jw9RgE1zAghnU14L0vVUNOzi/4bE7wIsiRyIcCcVoXRneBA3n/frLXvd

# jDsbb2lpGu78+s1zbO5N0bhHWq4j5WMutrspBxEhqG2PSBjC5Ypi+jhtfu3+x76N

# mBvsyKuxx9+Hm/ALnlzKxr4KyMR3/z4IRMzA1QyppNk65Ui+jB14g+w4vole33M1

# pVqVckrmSebUkmjnCshCiH12IFgHZF7gRwE4YZrJ7QjxZeoZqHaKsQLRMp653beB

# fHfeva9zJPhBSdVcCW7x9q0c2HVPLJHX9YCUU714I+qtLpDGrdbZxD9mikPqL/To

# /1lDZ0ch8FtePhME7houuoPcMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq

# hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x

# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv

# bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5

# IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG

# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG

# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg

# Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC

# CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03

# a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr

# rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg

# OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy

# 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9

# sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh

# dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k

# A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB

# w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn

# Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90

# lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w

# ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o

# ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD

# VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa

# BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny

# bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG

# AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t

# L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV

# HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3

# dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG

# AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl

# AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb

# C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l

# hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6

# I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0

# wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560

# STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam

# ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa

# J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah

# XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA

# 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt

# Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr

# /Xmfwb1tbWrJUnMTDXpQzTGCGXMwghlvAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw

# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN

# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp

# Z25pbmcgUENBIDIwMTECEzMAAALLt3U5+wJxQjYAAAAAAsswDQYJYIZIAWUDBAIB

# BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO

# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIIRx6w5PtwX73ytgFLY1JXGh

# HSttU3hF6kZGNbm29kT2MEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A

# cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB

# BQAEggEAc8aspMfYOKZZdM2015aE93axmZGDiqTQQRinzmVXlZwqFaieZZiB7l88

# Zc6L53+qEhbMiq48jviwapibbgK1lTX7aZaM4nafTk+lSHTgNmH6P6SqpEBZqMCp

# I+KEMeRD6reVjxpj7kPl63ttBW8/WP34400T5dvhDgI84QhHpoUu8JF2zlWg9x8Y

# 4OhMi2PEy1YbKjdqX3N+Yt7/PAaH6h5h2eWNnfuEQKRfC6B+1raYlTNVx+GAskSX

# VMsI5/iLQAvlrwUVfL4u+3pO4eZQmBEzBbbo5BZ7ksHW10NhkGHjbPDpCQyezFYR

# oh2Um2oklKePqSiEqYuRBVpW/CQn3KGCFv0wghb5BgorBgEEAYI3AwMBMYIW6TCC

# FuUGCSqGSIb3DQEHAqCCFtYwghbSAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFPBgsq

# hkiG9w0BCRABBKCCAT4EggE6MIIBNgIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl

# AwQCAQUABCBUpoIpczJu6Yt1nNLPyBut5bRg8fvC0LmPHzoTOFvT5gIGZBMAVOmu

# GBEyMDIzMDMxNjE2MzM0NS44WjAEgAIB9KCB0KSBzTCByjELMAkGA1UEBhMCVVMx

# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT

# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJp

# Y2EgT3BlcmF0aW9uczEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046REQ4Qy1FMzM3

# LTJGQUUxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WgghFW

# MIIHDDCCBPSgAwIBAgITMwAAAcUDzc0hofTvOQABAAABxTANBgkqhkiG9w0BAQsF

# ADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD

# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yMjExMDQxOTAxMzJa

# Fw0yNDAyMDIxOTAxMzJaMIHKMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu

# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv

# cmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMSYw

# JAYDVQQLEx1UaGFsZXMgVFNTIEVTTjpERDhDLUUzMzctMkZBRTElMCMGA1UEAxMc

# TWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCCAiIwDQYJKoZIhvcNAQEBBQAD

# ggIPADCCAgoCggIBAKtIXbO9Hl9tye6WqaWil0Yc/k0+ySdzr1X9/jfHzacUbOY2

# OIRL9wVf8ORFl22XTuJt8Y9NZUyP8Q5KvsrY7oj3vMRl7GcQ57b+y9RMzHeYyEqi

# fnmLvJIFdOepqrPHQaOecWTzz3MX+btfc59OGjEBeT11fwuGS0oxWvSBTXK4m3Tp

# t5Rlta0ERWto1LLqeoL+t+KuVMB9PVhhrtM/PUW7W8jOeb5gYFlfHnem2Qma3KGC

# IzC/BUU7xpc56puh7cGXVzMCh092v5C1Ej4hgLKyIBM8+zaQaXjrILPU68Mlk2QT

# WwcMiAApkN+I/rkeHrdoWZPjR+PSoRCcmA9vnTiGgxgdhFDRUmHMtTJILWbdXkag

# QdJvmD2M+x46HD8pCmDUGe07/s4JTn3womsdYzm9LuiGAuV9Sa/AME3LGg8rt6gI

# cfHBUDfQw4IlWcPlERWfKMqA5OrCFdZ8ec2S8voTbWpHj1/Uu2PJ9alnwI6FzxOi

# tP3W08POxDiS/wZSRnCqBU8ra9Mz4PzDSUm+n9mv8A5F6BghliYkKxk8Yzj/kfev

# 5yCBtOXhNS6ZMthTnWDDweA4Vu7QXWWrrXqU07koZoJ/hihEfAKANYEkpNRAuWV+

# HKaVZ4CaW5TAbvK/7QoXx1XV74mOoQ0oR8EApmamXm4EmB5x5eLqxPuCumQvAgMB

# AAGjggE2MIIBMjAdBgNVHQ4EFgQUVOq7OL9ZsTWBv67aS8K1cHpNBWswHwYDVR0j

# BBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYDVR0fBFgwVjBUoFKgUIZOaHR0

# cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0JTIwVGlt

# ZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwGCCsGAQUFBwEBBGAwXjBcBggr

# BgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9N

# aWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcnQwDAYDVR0T

# AQH/BAIwADATBgNVHSUEDDAKBggrBgEFBQcDCDANBgkqhkiG9w0BAQsFAAOCAgEA

# jKjefH6zBzknHIivgnZ6+nSvH07IEA3mfW70IwrsTSCWSfdvsaXikQn916uO6nUc

# pJClJ2QunR4S8LdX4cMosvy33VUPcn9YWGf0aU0vs9IZ2qCvj/yAwIlDZt9jVy4Q

# wbtD+Em/7gleIzrjVHJiYaaQUIEFYRcf+eyWJNSwnYyHnv/xq3H25ELYmKG/Tmvd

# w0o27A9Y6monBJ5HJVDf5hJvWbJwpwNfvzkA6f/EOHD3x/eCzOCel9DbTQXlcsL1

# h9MLjGjicx4AywniVJBRPRxPLAQ1XnZo+szyQCPu6My42KsO4uERW4krX1mUho8L

# fpSyUGUVlAnE92h2L06NWFg2bJKIVoO+8PXxdkG4jvQ356qGe0KMx4u0Yj6W44JC

# TAIa4aXk3/2rdnvfh2JCjm1JoDwKx9Vo4r8JtXez2FrGqy+7uambpN+hm9ZhE0ta

# ANl19/gt64Lc0aIT/PamVX+/ZVb45oN+DbSAiv6TJPfUgbrYIbYqRUjEHW11J0tq

# Hi7fXCrr9TCbvoCfN6l0zZENkKocbTUb2xPUKpqiUMOVVv+Emc3taT18cjkzucg6

# vokSFLm6nkM5lHApIsjbgix1ofDiwiOZiDgtYi7VQ39pcPXlq6KcLuUgybU/2cKi

# FNam9lPjY5DXI9YWzgwURC2k01nfdUSYlCPZ3CZBoP4wggdxMIIFWaADAgECAhMz

# AAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9v

# dCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIyMjVaFw0z

# MDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u

# MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp

# b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIICIjAN

# BgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5vQ7VgtP9

# 7pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64NmeFRiMM

# tY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhuje3XD9gm

# U3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl3GoPz130

# /o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPgyY9+tVSP

# 3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I5JasAUq7

# vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2ci/bfV+A

# utuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/TNuvXsLz

# 1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy16cg8ML6

# EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y1BzFa/Zc

# UlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6HXtqPnhZy

# acaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMBAAEwIwYJ

# KwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQWBBSfpxVd

# AF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30BATBBMD8G

# CCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL0RvY3Mv

# UmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYBBAGCNxQC

# BAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYD

# VR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZF

# aHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9v

# Q2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcw

# AoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJB

# dXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1VffwqreEsH2cB

# MSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27DzHkwo/7

# bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pvvinLbtg/

# SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9AkvUCgvxm2

# EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWKNsIdw2Fz

# Lixre24/LAl4FOmRsqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2kQH2zsZ0

# /fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+c23Kjgm9

# swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep8beuyOiJ

# Xk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+DvktxW/tM4+

# pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW

# 4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/2XBjU02N

# 7oJtpQUQwXEGahC0HVUzWLOhcGbyoYICzTCCAjYCAQEwgfihgdCkgc0wgcoxCzAJ

# BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k

# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsTHE1pY3Jv

# c29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNO

# OkREOEMtRTMzNy0yRkFFMSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBT

# ZXJ2aWNloiMKAQEwBwYFKw4DAhoDFQAhABr2F2SSu3FKOtvi7xGEBMe/56CBgzCB

# gKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH

# EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV

# BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBBQUA

# AgUA571+1TAiGA8yMDIzMDMxNjE5NDEwOVoYDzIwMjMwMzE3MTk0MTA5WjB2MDwG

# CisGAQQBhFkKBAExLjAsMAoCBQDnvX7VAgEAMAkCAQACAQECAf8wBwIBAAICEakw

# CgIFAOe+0FUCAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgC

# AQACAwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQUFAAOBgQAnQZiRXX6zpoot

# 1lyq3unEsYd3nJNetxKmRO8qO/nCH4b08mqThTGS+o1QsIUVBa4zJWxkgzl2010Q

# rSI5hGyev1n4UqaeaC9cndKyt3AHh30UWH5Wgw57X5ZRQRJvgCq5Pl4uKuL07p/N

# O/pnuGzpQCmh3DMXmV7C5D3e9Q6apTGCBA0wggQJAgEBMIGTMHwxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFBDQSAyMDEwAhMzAAABxQPNzSGh9O85AAEAAAHFMA0GCWCGSAFl

# AwQCAQUAoIIBSjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcN

# AQkEMSIEIINGwkGQE7DsPgoUAH4mqnN99YIDEz6/TEfRqEEoYvEuMIH6BgsqhkiG

# 9w0BCRACLzGB6jCB5zCB5DCBvQQgGQGxkfYkd0wK+V09wO0sO+sm8gAMyj5EuKPq

# vNQ/fLEwgZgwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3Rv

# bjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0

# aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAA

# AcUDzc0hofTvOQABAAABxTAiBCAfnq2mvPVMMc/qUuP/I2xUAgzpeN+OOIxFJQf1

# 7cN/YzANBgkqhkiG9w0BAQsFAASCAgAiuD91XoM1ZhUbY0bD73MQ1E84LLYBWrh8

# N4je4uzhNEQN6SByJ/xA43DQ8i0T1EsREnt43L91wMC/GXRO8MDLCfHzr0ikPhtL

# wBBNuPZ+3LHs+3JcQXqZ7GYTdMqMPthDm7KypaIo94Z6AA0ENZaqx5wTIRP6zrL+

# Oi0flspJJdKp31og4+XUVkj1WkOqVWfUWzHVcXes0wj5y3stRp2pzBSQcdW9MX0l

# cMDuS1lMFPs7fHY4jVz4m2f4LBL5V750iYv0lZZ1DyERlgRM6EvbDENYCSF4HYF+

# iOf1bc2qp1tNWswQxZO74+mITokVQQbhyRtDyuutCI3BhsiFTa+KKTJ1O8X10Knn

# R6wTUWfqeEjeY868pLOKK4KzdLiiFKUnDdpEpjpcDhUBU6tYvHTqrz824gMUrma1

# MXWrHHD3Qlb9mlxHmAwImkvD4t9SPmkW0ieJwCLJhhLg2ybZ8AFDUdMaaaQTqtiu

# 5Rc31fGlfqPx/eN5GPgHE323STlj/83xwYwqvPs6inZf0OhaIOVl5HE7bySluyfr

# 7BXn2/VMcjdEp3HK1HuZaM34IEU7oR0YMSwK52zWx25aFG0UpOKsUGqQk1iZaOR5

# UlV4fmDl15xmaDtOBTFNGBnyjm+LEVpZY+2FWxO5cnEfBxYTEAA13BvbYGdsnM0P

# GCXun/NqkA==

# SIG # End signature block