Lability

0.9.9

Lib/Resource.ps1

                                function NewDirectory {

<#

    .SYNOPSIS

       Creates a filesystem directory.

    .DESCRIPTION

       The New-Directory cmdlet will create the target directory if it doesn't already exist. If the target path

       already exists, the cmdlet does nothing.

#>

    [CmdletBinding(DefaultParameterSetName = 'ByString', SupportsShouldProcess)]

    [OutputType([System.IO.DirectoryInfo])]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSShouldProcess','')]

    param (

        # Target filesystem directory to create

        [Parameter(Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName, Position = 0, ParameterSetName = 'ByDirectoryInfo')]

        [ValidateNotNullOrEmpty()] [System.IO.DirectoryInfo[]] $InputObject,

        # Target filesystem directory to create

        [Parameter(Mandatory = $true, ValueFromPipelineByPropertyName, Position = 0, ParameterSetName = 'ByString')] [Alias('PSPath')]

        [ValidateNotNullOrEmpty()] [System.String[]] $Path

    )

    process {

        Write-Debug -Message ("Using parameter set '{0}'." -f $PSCmdlet.ParameterSetName);

        switch ($PSCmdlet.ParameterSetName) {

            'ByString' {

                foreach ($directory in $ExecutionContext.SessionState.Path.GetUnresolvedProviderPathFromPSPath($Path)) {

                    Write-Debug -Message ("Testing target directory '{0}'." -f $directory);

                    if (!(Test-Path -Path $directory -PathType Container)) {

                        if ($PSCmdlet.ShouldProcess($directory, "Create directory")) {

                            WriteVerbose ($localized.CreatingDirectory -f $directory);

                            New-Item -Path $directory -ItemType Directory;

                        }

                    } else {

                        WriteVerbose ($localized.DirectoryExists -f $directory);

                        Get-Item -Path $directory;

                    }

                } #end foreach directory

            } #end byString

            'ByDirectoryInfo' {

                 foreach ($directoryInfo in $InputObject) {

                    Write-Debug -Message ("Testing target directory '{0}'." -f $directoryInfo.FullName);

                    if (!($directoryInfo.Exists)) {

                        if ($PSCmdlet.ShouldProcess($directoryInfo.FullName, "Create directory")) {

                            WriteVerbose ($localized.CreatingDirectory -f $directoryInfo.FullName);

                            New-Item -Path $directoryInfo.FullName -ItemType Directory;

                        }

                    } else {

                        WriteVerbose ($localized.DirectoryExists -f $directoryInfo.FullName);

                        $directoryInfo;

                    }

                } #end foreach directoryInfo

            } #end byDirectoryInfo

        } #end switch

    } #end process

} #end function NewDirectory

function SetResourceChecksum {

<#

    .SYNOPSIS

        Creates a resource's checksum file.

#>

    param (

        ## Path of file to create the checksum of

        [Parameter(Mandatory, ValueFromPipeline)] [ValidateNotNullOrEmpty()]

        [System.String] $Path

    )

    process {

        $checksumPath = '{0}.checksum' -f $Path;

        ## As it can take a long time to calculate the checksum, write it out to disk for future reference

        WriteVerbose ($localized.CalculatingResourceChecksum -f $checksumPath);

        $fileHash = Get-FileHash -Path $Path -Algorithm MD5 -ErrorAction Stop | Select-Object -ExpandProperty Hash;

        WriteVerbose ($localized.WritingResourceChecksum -f $fileHash, $checksumPath);

        $fileHash | Set-Content -Path $checksumPath -Force;

    }

} #end function SetResourceChecksum

function GetResourceDownload {

<#

    .SYNOPSIS

        Retrieves a downloaded resource's checksum.

    .NOTES

        Based upon https://github.com/iainbrighton/cRemoteFile/blob/master/DSCResources/VE_RemoteFile/VE_RemoteFile.ps1

#>

    [CmdletBinding()]

    [OutputType([System.Collections.Hashtable])]

    param (

        [Parameter(Mandatory, ValueFromPipeline)] [ValidateNotNullOrEmpty()]

        [System.String] $DestinationPath,

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()]

        [System.String] $Uri,

        [Parameter(ValueFromPipelineByPropertyName)] [AllowNull()]

        [System.String] $Checksum,

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.UInt32] $BufferSize = 64KB

        ##TODO: Support Headers and UserAgent

    )

    process {

        $checksumPath = '{0}.checksum' -f $DestinationPath;

        if (-not (Test-Path -Path $DestinationPath)) {

            WriteVerbose ($localized.MissingResourceFile -f $DestinationPath);

        }

        elseif (-not (Test-Path -Path $checksumPath)) {

            [ref] $null = SetResourceChecksum -Path $DestinationPath;

        }

        if (Test-Path -Path $checksumPath) {

            Write-Debug -Message ('MD5 checksum file ''{0}'' found.' -f $checksumPath);

            $md5Checksum = (Get-Content -Path $checksumPath -Raw).Trim();

            Write-Debug -Message ('Discovered MD5 checksum ''{0}''.' -f $md5Checksum);

        }

        else {

            Write-Debug -Message ('MD5 checksum file ''{0}'' not found.' -f $checksumPath);

        }

        $resource = @{

            DestinationPath = $DestinationPath;

            Uri = $Uri;

            Checksum = $md5Checksum;

        }

        return $resource;

    } #end process

} #end function GetResourceDownload

function TestResourceDownload {

<#

    .SYNOPSIS

        Tests if a web resource has been downloaded and whether the MD5 checksum is correct.

    .NOTES

        Based upon https://github.com/iainbrighton/cRemoteFile/blob/master/DSCResources/VE_RemoteFile/VE_RemoteFile.ps1

#>

    [CmdletBinding()]

    [OutputType([System.Boolean])]

    param (

        [Parameter(Mandatory, ValueFromPipeline)] [ValidateNotNullOrEmpty()]

        [System.String] $DestinationPath,

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()]

        [System.String] $Uri,

        [Parameter(ValueFromPipelineByPropertyName)] [AllowNull()]

        [System.String] $Checksum,

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.UInt32] $BufferSize = 64KB

        ##TODO: Support Headers and UserAgent

    )

    process {

        $resource = GetResourceDownload @PSBoundParameters;

        if ([System.String]::IsNullOrEmpty($Checksum) -and (Test-Path -Path $DestinationPath -PathType Leaf)) {

            WriteVerbose ($localized.ResourceChecksumNotSpecified -f $DestinationPath);

            return $true;

        }

        elseif ($Checksum -eq $resource.Checksum) {

            WriteVerbose ($localized.ResourceChecksumMatch -f $DestinationPath, $Checksum);

            return $true;

        }

        else {

            WriteVerbose ($localized.ResourceChecksumMismatch  -f $DestinationPath, $Checksum);

            return $false;

        }

    } #end process

} #end function TestResourceDownload

function SetResourceDownload {

<#

    .SYNOPSIS

        Downloads a (web) resource and creates a MD5 checksum.

#>

    [CmdletBinding()]

    param (

        [Parameter(Mandatory, ValueFromPipeline)] [ValidateNotNullOrEmpty()]

        [System.String] $DestinationPath,

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()]

        [System.String] $Uri,

        [Parameter(ValueFromPipelineByPropertyName)] [AllowNull()]

        [System.String] $Checksum,

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.UInt32] $BufferSize = 64KB

        ##TODO: Support Headers and UserAgent

    )

    begin {

        $parentDestinationPath = Split-Path -Path $DestinationPath -Parent;

        [ref] $null = NewDirectory -Path $parentDestinationPath;

    }

    process {

        if (-not $PSBoundParameters.ContainsKey('BufferSize')) {

            $systemUri = New-Object -TypeName System.Uri -ArgumentList @($uri);

            if ($systemUri.IsFile) {

                $BufferSize = 1MB;

            }

        }

        WriteVerbose ($localized.DownloadingResource -f $Uri, $DestinationPath);

        InvokeWebClientDownload -DestinationPath $DestinationPath -Uri $Uri -BufferSize $BufferSize;

        ## Create the checksum file for future reference

        [ref] $null = SetResourceChecksum -Path $DestinationPath;

    } #end process

} #end function SetResourceDownload

function InvokeWebClientDownload {

<#

    .SYNOPSIS

        Downloads a (web) resource using System.Net.WebClient.

    .NOTES

        This solves issue #19 when running downloading resources using BITS under alternative credentials.

#>

    [CmdletBinding()]

    [OutputType([System.IO.FileInfo])]

    param (

        [Parameter(Mandatory, ValueFromPipeline)]

        [System.String] $DestinationPath,

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [System.String] $Uri,

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.UInt32] $BufferSize = 64KB,

        [Parameter(ValueFromPipelineByPropertyName)] [AllowNull()]

        [System.Management.Automation.PSCredential]

        [System.Management.Automation.CredentialAttribute()]

        $Credential

    )

    process {

        try {

            [System.Net.WebClient] $webClient = New-Object -TypeName 'System.Net.WebClient';

            $webClient.Headers.Add('user-agent', $labDefaults.ModuleName);

            $webClient.Proxy = [System.Net.WebRequest]::GetSystemWebProxy();

            if (-not $webClient.Proxy.IsBypassed($Uri)) {

                $proxyInfo = $webClient.Proxy.GetProxy($Uri);

                WriteVerbose ($localized.UsingProxyServer -f $proxyInfo.AbsoluteUri);

            }

            if ($Credential) {

                $webClient.Credentials = $Credential;

                $webClient.Proxy.Credentials = $Credential;

            }

            else {

                $webClient.UseDefaultCredentials = $true;

                $webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultCredentials;

            }

            [System.IO.Stream] $inputStream = $webClient.OpenRead($Uri);

            [System.UInt64] $contentLength = $webClient.ResponseHeaders['Content-Length'];

            $path = $ExecutionContext.SessionState.Path.GetUnresolvedProviderPathFromPSPath($DestinationPath);

            [System.IO.Stream] $outputStream = [System.IO.File]::Create($path);

            [System.Byte[]] $buffer = New-Object -TypeName System.Byte[] -ArgumentList $BufferSize;

            [System.UInt64] $bytesRead = 0;

            [System.UInt64] $totalBytes = 0;

            $writeProgessActivity = $localized.DownloadingActivity -f $Uri;

            do {

                $bytesRead = $inputStream.Read($buffer, 0, $buffer.Length);

                $totalBytes += $bytesRead;

                $outputStream.Write($buffer, 0, $bytesRead);

                ## Avoid divide by zero

                if ($contentLength -gt 0) {

                    [System.Byte] $percentComplete = ($totalBytes/$contentLength) * 100;

                    $writeProgressParams = @{

                        Activity = $writeProgessActivity;

                        PercentComplete = $percentComplete;

                        Status = $localized.DownloadStatus -f $totalBytes, $contentLength, $percentComplete;

                    }

                    Write-Progress @writeProgressParams;

                }

            }

            while ($bytesRead -ne 0)

            $outputStream.Close();

            return (Get-Item -Path $path);

        }

        catch {

            throw ($localized.ResourceDownloadFailedError -f $Uri);

        }

        finally {

            Write-Progress -Activity $writeProgessActivity -Completed;

            if ($null -ne $outputStream) { $outputStream.Close(); }

            if ($null -ne $inputStream) { $inputStream.Close(); }

            if ($null -ne $webClient) { $webClient.Dispose(); }

        }

    } #end process

} #end function InvokeWebClientDownload

function InvokeResourceDownload {

<#

    .SYNOPSIS

        Downloads a web resource if it has not already been downloaded or the checksum is incorrect.

#>

    [CmdletBinding()]

    [OutputType([System.Collections.Hashtable])]

    param (

        [Parameter(Mandatory, ValueFromPipeline)] [ValidateNotNullOrEmpty()]

        [System.String] $DestinationPath,

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()]

        [System.String] $Uri,

        [Parameter(ValueFromPipelineByPropertyName)] [AllowNull()]

        [System.String] $Checksum,

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.Management.Automation.SwitchParameter] $Force,

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.UInt32] $BufferSize = 64KB

        ##TODO: Support Headers and UserAgent

    )

    process {

        [ref] $null = $PSBoundParameters.Remove('Force');

        if (-not (TestResourceDownload @PSBoundParameters) -or $Force) {

            SetResourceDownload @PSBoundParameters -Verbose:$false;

        }

        $resource = GetResourceDownload @PSBoundParameters;

        return [PSCustomObject] $resource;

    } #end process

} #end function InvokeResourceDownload

# SIG # Begin signature block

# MIIXtwYJKoZIhvcNAQcCoIIXqDCCF6QCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUDkr6ioUDfVms1kZhTmR9IYP9

# CsSgghLqMIID7jCCA1egAwIBAgIQfpPr+3zGTlnqS5p31Ab8OzANBgkqhkiG9w0B

# AQUFADCBizELMAkGA1UEBhMCWkExFTATBgNVBAgTDFdlc3Rlcm4gQ2FwZTEUMBIG

# A1UEBxMLRHVyYmFudmlsbGUxDzANBgNVBAoTBlRoYXd0ZTEdMBsGA1UECxMUVGhh

# d3RlIENlcnRpZmljYXRpb24xHzAdBgNVBAMTFlRoYXd0ZSBUaW1lc3RhbXBpbmcg

# Q0EwHhcNMTIxMjIxMDAwMDAwWhcNMjAxMjMwMjM1OTU5WjBeMQswCQYDVQQGEwJV

# UzEdMBsGA1UEChMUU3ltYW50ZWMgQ29ycG9yYXRpb24xMDAuBgNVBAMTJ1N5bWFu

# dGVjIFRpbWUgU3RhbXBpbmcgU2VydmljZXMgQ0EgLSBHMjCCASIwDQYJKoZIhvcN

# AQEBBQADggEPADCCAQoCggEBALGss0lUS5ccEgrYJXmRIlcqb9y4JsRDc2vCvy5Q

# WvsUwnaOQwElQ7Sh4kX06Ld7w3TMIte0lAAC903tv7S3RCRrzV9FO9FEzkMScxeC

# i2m0K8uZHqxyGyZNcR+xMd37UWECU6aq9UksBXhFpS+JzueZ5/6M4lc/PcaS3Er4

# ezPkeQr78HWIQZz/xQNRmarXbJ+TaYdlKYOFwmAUxMjJOxTawIHwHw103pIiq8r3

# +3R8J+b3Sht/p8OeLa6K6qbmqicWfWH3mHERvOJQoUvlXfrlDqcsn6plINPYlujI

# fKVOSET/GeJEB5IL12iEgF1qeGRFzWBGflTBE3zFefHJwXECAwEAAaOB+jCB9zAd

# BgNVHQ4EFgQUX5r1blzMzHSa1N197z/b7EyALt0wMgYIKwYBBQUHAQEEJjAkMCIG

# CCsGAQUFBzABhhZodHRwOi8vb2NzcC50aGF3dGUuY29tMBIGA1UdEwEB/wQIMAYB

# Af8CAQAwPwYDVR0fBDgwNjA0oDKgMIYuaHR0cDovL2NybC50aGF3dGUuY29tL1Ro

# YXd0ZVRpbWVzdGFtcGluZ0NBLmNybDATBgNVHSUEDDAKBggrBgEFBQcDCDAOBgNV

# HQ8BAf8EBAMCAQYwKAYDVR0RBCEwH6QdMBsxGTAXBgNVBAMTEFRpbWVTdGFtcC0y

# MDQ4LTEwDQYJKoZIhvcNAQEFBQADgYEAAwmbj3nvf1kwqu9otfrjCR27T4IGXTdf

# plKfFo3qHJIJRG71betYfDDo+WmNI3MLEm9Hqa45EfgqsZuwGsOO61mWAK3ODE2y

# 0DGmCFwqevzieh1XTKhlGOl5QGIllm7HxzdqgyEIjkHq3dlXPx13SYcqFgZepjhq

# IhKjURmDfrYwggSjMIIDi6ADAgECAhAOz/Q4yP6/NW4E2GqYGxpQMA0GCSqGSIb3

# DQEBBQUAMF4xCzAJBgNVBAYTAlVTMR0wGwYDVQQKExRTeW1hbnRlYyBDb3Jwb3Jh

# dGlvbjEwMC4GA1UEAxMnU3ltYW50ZWMgVGltZSBTdGFtcGluZyBTZXJ2aWNlcyBD

# QSAtIEcyMB4XDTEyMTAxODAwMDAwMFoXDTIwMTIyOTIzNTk1OVowYjELMAkGA1UE

# BhMCVVMxHTAbBgNVBAoTFFN5bWFudGVjIENvcnBvcmF0aW9uMTQwMgYDVQQDEytT

# eW1hbnRlYyBUaW1lIFN0YW1waW5nIFNlcnZpY2VzIFNpZ25lciAtIEc0MIIBIjAN

# BgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAomMLOUS4uyOnREm7Dv+h8GEKU5Ow

# mNutLA9KxW7/hjxTVQ8VzgQ/K/2plpbZvmF5C1vJTIZ25eBDSyKV7sIrQ8Gf2Gi0

# jkBP7oU4uRHFI/JkWPAVMm9OV6GuiKQC1yoezUvh3WPVF4kyW7BemVqonShQDhfu

# ltthO0VRHc8SVguSR/yrrvZmPUescHLnkudfzRC5xINklBm9JYDh6NIipdC6Anqh

# d5NbZcPuF3S8QYYq3AhMjJKMkS2ed0QfaNaodHfbDlsyi1aLM73ZY8hJnTrFxeoz

# C9Lxoxv0i77Zs1eLO94Ep3oisiSuLsdwxb5OgyYI+wu9qU+ZCOEQKHKqzQIDAQAB

# o4IBVzCCAVMwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDAO

# BgNVHQ8BAf8EBAMCB4AwcwYIKwYBBQUHAQEEZzBlMCoGCCsGAQUFBzABhh5odHRw

# Oi8vdHMtb2NzcC53cy5zeW1hbnRlYy5jb20wNwYIKwYBBQUHMAKGK2h0dHA6Ly90

# cy1haWEud3Muc3ltYW50ZWMuY29tL3Rzcy1jYS1nMi5jZXIwPAYDVR0fBDUwMzAx

# oC+gLYYraHR0cDovL3RzLWNybC53cy5zeW1hbnRlYy5jb20vdHNzLWNhLWcyLmNy

# bDAoBgNVHREEITAfpB0wGzEZMBcGA1UEAxMQVGltZVN0YW1wLTIwNDgtMjAdBgNV

# HQ4EFgQURsZpow5KFB7VTNpSYxc/Xja8DeYwHwYDVR0jBBgwFoAUX5r1blzMzHSa

# 1N197z/b7EyALt0wDQYJKoZIhvcNAQEFBQADggEBAHg7tJEqAEzwj2IwN3ijhCcH

# bxiy3iXcoNSUA6qGTiWfmkADHN3O43nLIWgG2rYytG2/9CwmYzPkSWRtDebDZw73

# BaQ1bHyJFsbpst+y6d0gxnEPzZV03LZc3r03H0N45ni1zSgEIKOq8UvEiCmRDoDR

# EfzdXHZuT14ORUZBbg2w6jiasTraCXEQ/Bx5tIB7rGn0/Zy2DBYr8X9bCT2bW+IW

# yhOBbQAuOA2oKY8s4bL0WqkBrxWcLC9JG9siu8P+eJRRw4axgohd8D20UaF5Mysu

# e7ncIAkTcetqGVvP6KUwVyyJST+5z3/Jvz4iaGNTmr1pdKzFHTx/kuDDvBzYBHUw

# ggUZMIIEAaADAgECAhADViTO4HBjoJNSwH9//cwJMA0GCSqGSIb3DQEBCwUAMHIx

# CzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3

# dy5kaWdpY2VydC5jb20xMTAvBgNVBAMTKERpZ2lDZXJ0IFNIQTIgQXNzdXJlZCBJ

# RCBDb2RlIFNpZ25pbmcgQ0EwHhcNMTUwNTE5MDAwMDAwWhcNMTcwODIzMTIwMDAw

# WjBgMQswCQYDVQQGEwJHQjEPMA0GA1UEBxMGT3hmb3JkMR8wHQYDVQQKExZWaXJ0

# dWFsIEVuZ2luZSBMaW1pdGVkMR8wHQYDVQQDExZWaXJ0dWFsIEVuZ2luZSBMaW1p

# dGVkMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqLQmabdimcQtYPTQ

# 9RSjv3ThEmFTRJt/MzseYYtZpBTcR6BnSfj8RfkC4aGZvspFgH0cGP/SNJh1w67b

# iX9oT5NFL9sUJHUsVdyPBA1LhpWcF09PP28mGGKO3oQHI4hTLD8etiIlF9qFantd

# 1Pmo0jdqT4uErSmx0m4kYGUUTa5ZPAK0UZSuAiNX6iNIL+rj/BPbI3nuPJzzx438

# oHYkZGRtsx11+pLA6hIKyUzRuIDoI7JQ0nZ0MkCziVyc6xGfS54JVLaVCEteTKPz

# Gc4yyvCqp6Tfe9gs8UuxJiEMdH5fvllTU4aoXbm+W8tonkE7i/19rv8S1A2VPiVV

# xNLbpwIDAQABo4IBuzCCAbcwHwYDVR0jBBgwFoAUWsS5eyoKo6XqcQPAYPkt9mV1

# DlgwHQYDVR0OBBYEFP2RNOWYipdNCSRVb5jIcyRp9tUDMA4GA1UdDwEB/wQEAwIH

# gDATBgNVHSUEDDAKBggrBgEFBQcDAzB3BgNVHR8EcDBuMDWgM6Axhi9odHRwOi8v

# Y3JsMy5kaWdpY2VydC5jb20vc2hhMi1hc3N1cmVkLWNzLWcxLmNybDA1oDOgMYYv

# aHR0cDovL2NybDQuZGlnaWNlcnQuY29tL3NoYTItYXNzdXJlZC1jcy1nMS5jcmww

# QgYDVR0gBDswOTA3BglghkgBhv1sAwEwKjAoBggrBgEFBQcCARYcaHR0cHM6Ly93

# d3cuZGlnaWNlcnQuY29tL0NQUzCBhAYIKwYBBQUHAQEEeDB2MCQGCCsGAQUFBzAB

# hhhodHRwOi8vb2NzcC5kaWdpY2VydC5jb20wTgYIKwYBBQUHMAKGQmh0dHA6Ly9j

# YWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydFNIQTJBc3N1cmVkSURDb2RlU2ln

# bmluZ0NBLmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4IBAQCclXHR

# DhDyJr81eiD0x+AL04ryDwdKT+PooKYgOxc7EhRn59ogxNO7jApQPSVo0I11Zfm6

# zQ6K6RPWhxDenflf2vMx7a0tIZlpHhq2F8praAMykK7THA9F3AUxIb/lWHGZCock

# yD/GQvJek3LSC5NjkwQbnubWYF/XZTDzX/mJGU2DcG1OGameffR1V3xODHcUE/K3

# PWy1bzixwbQCQA96GKNCWow4/mEW31cupHHSo+XVxmjTAoC93yllE9f4Kdv6F29H

# bRk0Go8Yn8WjWeLE/htxW/8ruIj0KnWkG+YwmZD+nTegYU6RvAV9HbJJYUEIfhVy

# 3DeK5OlY9ima2sdtMIIFMDCCBBigAwIBAgIQBAkYG1/Vu2Z1U0O1b5VQCDANBgkq

# hkiG9w0BAQsFADBlMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5j

# MRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSQwIgYDVQQDExtEaWdpQ2VydCBB

# c3N1cmVkIElEIFJvb3QgQ0EwHhcNMTMxMDIyMTIwMDAwWhcNMjgxMDIyMTIwMDAw

# WjByMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQL

# ExB3d3cuZGlnaWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFzc3Vy

# ZWQgSUQgQ29kZSBTaWduaW5nIENBMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIB

# CgKCAQEA+NOzHH8OEa9ndwfTCzFJGc/Q+0WZsTrbRPV/5aid2zLXcep2nQUut4/6

# kkPApfmJ1DcZ17aq8JyGpdglrA55KDp+6dFn08b7KSfH03sjlOSRI5aQd4L5oYQj

# ZhJUM1B0sSgmuyRpwsJS8hRniolF1C2ho+mILCCVrhxKhwjfDPXiTWAYvqrEsq5w

# MWYzcT6scKKrzn/pfMuSoeU7MRzP6vIK5Fe7SrXpdOYr/mzLfnQ5Ng2Q7+S1TqSp

# 6moKq4TzrGdOtcT3jNEgJSPrCGQ+UpbB8g8S9MWOD8Gi6CxR93O8vYWxYoNzQYIH

# 5DiLanMg0A9kczyen6Yzqf0Z3yWT0QIDAQABo4IBzTCCAckwEgYDVR0TAQH/BAgw

# BgEB/wIBADAOBgNVHQ8BAf8EBAMCAYYwEwYDVR0lBAwwCgYIKwYBBQUHAwMweQYI

# KwYBBQUHAQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdpY2VydC5j

# b20wQwYIKwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNvbS9EaWdp

# Q2VydEFzc3VyZWRJRFJvb3RDQS5jcnQwgYEGA1UdHwR6MHgwOqA4oDaGNGh0dHA6

# Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcmww

# OqA4oDaGNGh0dHA6Ly9jcmwzLmRpZ2ljZXJ0LmNvbS9EaWdpQ2VydEFzc3VyZWRJ

# RFJvb3RDQS5jcmwwTwYDVR0gBEgwRjA4BgpghkgBhv1sAAIEMCowKAYIKwYBBQUH

# AgEWHGh0dHBzOi8vd3d3LmRpZ2ljZXJ0LmNvbS9DUFMwCgYIYIZIAYb9bAMwHQYD

# VR0OBBYEFFrEuXsqCqOl6nEDwGD5LfZldQ5YMB8GA1UdIwQYMBaAFEXroq/0ksuC

# MS1Ri6enIZ3zbcgPMA0GCSqGSIb3DQEBCwUAA4IBAQA+7A1aJLPzItEVyCx8JSl2

# qB1dHC06GsTvMGHXfgtg/cM9D8Svi/3vKt8gVTew4fbRknUPUbRupY5a4l4kgU4Q

# pO4/cY5jDhNLrddfRHnzNhQGivecRk5c/5CxGwcOkRX7uq+1UcKNJK4kxscnKqEp

# KBo6cSgCPC6Ro8AlEeKcFEehemhor5unXCBc2XGxDI+7qPjFEmifz0DLQESlE/Dm

# ZAwlCEIysjaKJAL+L3J+HNdJRZboWR3p+nRka7LrZkPas7CM1ekN3fYBIM6ZMWM9

# CBoYs4GbT8aTEAb8B4H6i9r5gkn3Ym6hU/oSlBiFLpKR6mhsRDKyZqHnGKSaZFHv

# MYIENzCCBDMCAQEwgYYwcjELMAkGA1UEBhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0

# IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTExMC8GA1UEAxMoRGlnaUNl

# cnQgU0hBMiBBc3N1cmVkIElEIENvZGUgU2lnbmluZyBDQQIQA1YkzuBwY6CTUsB/

# f/3MCTAJBgUrDgMCGgUAoHgwGAYKKwYBBAGCNwIBDDEKMAigAoAAoQKAADAZBgkq

# hkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgorBgEEAYI3AgELMQ4wDAYKKwYBBAGC

# NwIBFTAjBgkqhkiG9w0BCQQxFgQUI7/37pBhCBHWcmeX40VxBfrqXcYwDQYJKoZI

# hvcNAQEBBQAEggEANvan7TMBuxkph7cZEVf5sr5dO8/lQGit6x2RBh02nXGNwCMY

# wDf9Ll9rV//QmI0IUKruznr1kCif6+d8dfV8HuXXufJVJn2CY15XQ9dnnmjJ6qGs

# 0hzPbPY20LLnkKN1AyNQ5hTZ2+5oxcBSwu0UhPMFHfa3Sex0yaeUEVjLQ+MW5byh

# kUGRyirH6rW18t07A3C3JWudzikUPKNnfkCX8B2BJ3suTW2h0SEO0Q3LXCcYS2ND

# aZeXED1OYwX4bbSBTk8R6ANM5aAL5USP59QkrA4QWEWa+H3KzZDRrvZG1046/fiz

# nTx8LYk+Zb4LJktldgsNyM0kBUTEflNYQLtFpqGCAgswggIHBgkqhkiG9w0BCQYx

# ggH4MIIB9AIBATByMF4xCzAJBgNVBAYTAlVTMR0wGwYDVQQKExRTeW1hbnRlYyBD

# b3Jwb3JhdGlvbjEwMC4GA1UEAxMnU3ltYW50ZWMgVGltZSBTdGFtcGluZyBTZXJ2

# aWNlcyBDQSAtIEcyAhAOz/Q4yP6/NW4E2GqYGxpQMAkGBSsOAwIaBQCgXTAYBgkq

# hkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0xNjA0MTMxMzMz

# MTlaMCMGCSqGSIb3DQEJBDEWBBTF3RptVmj6iDyNapviEfZfxAFJRzANBgkqhkiG

# 9w0BAQEFAASCAQAqJS3yGBJTJ2P5+G9UoBMe3SitMVZNVaRIqD7t/xjLUGOMweqw

# IZmR8kH+VtStEFILnJ+pz513OImrtunCyMAD2DXzqjrY4Lht0XGExbA94xzX8Nmo

# 85kcaM7QuYpWG3tbT07Z/lPjVWlCUQYEZkqp0BnBuO6Vp737nSKxEz0e9ka9B4bn

# nHAQ630OFw8PkioZzKMKGsg11ypY4tHJ65BQNO2wqXc9OBBLM9XP8Dqz8nPhhRQm

# EJ90q4eDjgmeNDHuVigZlAYt7HCHAB3O7MOrpSdgC7Or5NjSCCQ4XtbOQjQIVuB1

# EC/4o1fdERBPy/exRU6qyRD/dTP4WmhVULvl

# SIG # End signature block