Lability

0.10.3

Lib/GitHub.ps1

                                function ResolveGitHubModuleUri {

<#

    .SYNOPSIS

        Resolves the correct GitHub URI for the specified Owner, Repository and Branch.

#>

    [CmdletBinding()]

    [OutputType([System.Uri])]

    param (

        ## GitHub repository owner

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [System.String] $Owner,

        ## GitHub repository name

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [System.String] $Repository,

        ## GitHub repository branch

        [Parameter(ValueFromPipelineByPropertyName)] [ValidateNotNullOrEmpty()]

        [System.String] $Branch = 'master',

        ## Catch all to be able to pass parameter via $PSBoundParameters

        [Parameter(ValueFromRemainingArguments)] $RemainingArguments

    )

    process {

        $uri = 'https://github.com/{0}/{1}/archive/{2}.zip' -f $Owner, $Repository, $Branch;

        return New-Object -TypeName System.Uri -ArgumentList $uri;

    } #end process

} #end function ResolveGitHubModuleUri

function ExpandGitHubZipArchive {

<#

    .SYNOPSIS

        Extracts a GitHub Zip archive.

    .NOTES

        This is an internal function and should not be called directly.

    .LINK

        This function is derived from the GitHubRepository (https://github.com/IainBrighton/GitHubRepositoryCompression) module.

    .OUTPUTS

        A System.IO.FileInfo object for each extracted file.

#>

    [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'Medium')]

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

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

    param (

        # Source path to the Zip Archive.

        [Parameter(Mandatory, ValueFromPipelineByPropertyName, Position = 0)]

        [ValidateNotNullOrEmpty()]

        [Alias('PSPath','FullName')] [System.String[]] $Path,

        # Destination file path to extract the Zip Archive item to.

        [Parameter(Mandatory, ValueFromPipelineByPropertyName, Position = 1)]

        [ValidateNotNullOrEmpty()]

        [System.String] $DestinationPath,

        # GitHub repository name

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $Repository,

        [Parameter(ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $OverrideRepository,

        # Overwrite existing files

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.Management.Automation.SwitchParameter] $Force

    )

    begin {

        ## Validate destination path

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

            throw ($localized.InvalidDestinationPathError -f $DestinationPath);

        }

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

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

        [Ref] $null = NewDirectory -Path $DestinationPath;

        foreach ($pathItem in $Path) {

            foreach ($resolvedPath in $ExecutionContext.SessionState.Path.GetUnresolvedProviderPathFromPSPath($pathItem)) {

                WriteVerbose ($localized.ResolvedSourcePath -f $resolvedPath);

                $LiteralPath += $resolvedPath;

            }

        }

        ## If all tests passed, load the required .NET assemblies

        Write-Debug 'Loading ''System.IO.Compression'' .NET binaries.';

        Add-Type -AssemblyName 'System.IO.Compression';

        Add-Type -AssemblyName 'System.IO.Compression.FileSystem';

    } # end begin

    process {

        foreach ($pathEntry in $LiteralPath) {

            try {

                $zipArchive = [System.IO.Compression.ZipFile]::OpenRead($pathEntry);

                $expandZipArchiveItemParams = @{

                    InputObject = [ref] $zipArchive.Entries;

                    DestinationPath = $DestinationPath;

                    Repository = $Repository;

                    Force = $Force;

                }

                if ($OverrideRepository) {

                    $expandZipArchiveItemParams['OverrideRepository'] = $OverrideRepository;

                }

                ExpandGitHubZipArchiveItem @expandZipArchiveItemParams;

            } # end try

            catch {

                Write-Error $_.Exception;

            }

            finally {

                ## Close the file handle

                CloseGitHubZipArchive;

            }

        } # end foreach

    } # end process

} #end function ExpandGitHubZipArchive

function ExpandGitHubZipArchiveItem {

<#

    .SYNOPSIS

        Extracts file(s) from a GitHub Zip archive.

    .NOTES

        This is an internal function and should not be called directly.

    .LINK

        This function is derived from the VirtualEngine.Compression (https://github.com/VirtualEngine/Compression) module.

    .OUTPUTS

        A System.IO.FileInfo object for each extracted file.

#>

    [CmdletBinding(DefaultParameterSetName = 'Path', SupportsShouldProcess, ConfirmImpact = 'Medium')]

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

    param (

        # Reference to Zip archive item.

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

        [ValidateNotNullOrEmpty()]

        [System.IO.Compression.ZipArchiveEntry[]] [Ref] $InputObject,

        # Destination file path to extract the Zip Archive item to.

        [Parameter(Mandatory, ValueFromPipelineByPropertyName, Position = 1)]

        [ValidateNotNullOrEmpty()]

        [System.String] $DestinationPath,

        # GitHub repository name

        [Parameter(Mandatory, ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $Repository,

        ## Override repository name

        [Parameter(ValueFromPipelineByPropertyName)]

        [ValidateNotNullOrEmpty()]

        [System.String] $OverrideRepository,

        # Overwrite existing physical filesystem files

        [Parameter(ValueFromPipelineByPropertyName)]

        [System.Management.Automation.SwitchParameter] $Force

    )

    begin {

        Write-Debug 'Loading ''System.IO.Compression'' .NET binaries.';

        Add-Type -AssemblyName 'System.IO.Compression';

        Add-Type -AssemblyName 'System.IO.Compression.FileSystem';

    }

    process {

        try {

            ## Regex for locating the <RepositoryName>-<Branch>\ root directory

            $searchString = '^{0}-\S+?\\' -f $Repository;

            $replacementString = '{0}\' -f $Repository;

            if ($OverrideRepository) {

                $replacementString = '{0}\' -f $OverrideRepository;

            }

            [System.Int32] $fileCount = 0;

            $moduleDestinationPath = Join-Path -Path $DestinationPath -ChildPath $Repository;

            $activity = $localized.DecompressingArchive -f $moduleDestinationPath;

            Write-Progress -Activity $activity -PercentComplete 0;

            foreach ($zipArchiveEntry in $InputObject) {

                $fileCount++;

                if (($fileCount % 5) -eq 0) {

                    [System.Int16] $percentComplete = ($fileCount / $InputObject.Count) * 100

                    $status = $localized.CopyingResourceStatus -f $fileCount, $InputObject.Count, $percentComplete;

                    Write-Progress -Activity $activity -Status $status -PercentComplete $percentComplete;

                }

                if ($zipArchiveEntry.FullName.Contains('/')) {

                    ## We need to create the directory path as the ExtractToFile extension method won't do this and will throw an exception

                    $pathSplit = $zipArchiveEntry.FullName.Split('/');

                    $relativeDirectoryPath = New-Object System.Text.StringBuilder;

                    ## Generate the relative directory name

                    for ($pathSplitPart = 0; $pathSplitPart -lt ($pathSplit.Count -1); $pathSplitPart++) {

                        [ref] $null = $relativeDirectoryPath.AppendFormat('{0}\', $pathSplit[$pathSplitPart]);

                    }

                    ## Rename the GitHub \<RepositoryName>-<Branch>\ root directory to \<RepositoryName>\

                    $relativePath = ($relativeDirectoryPath.ToString() -replace $searchString, $replacementString).TrimEnd('\');

                    ## Create the destination directory path, joining the relative directory name

                    $directoryPath = Join-Path -Path $DestinationPath -ChildPath $relativePath;

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

                    $fullDestinationFilePath = Join-Path -Path $directoryPath -ChildPath $zipArchiveEntry.Name;

                } # end if

                else {

                    ## Just a file in the root so just use the $DestinationPath

                    $fullDestinationFilePath = Join-Path -Path $DestinationPath -ChildPath $zipArchiveEntry.Name;

                } # end else

                if ([System.String]::IsNullOrEmpty($zipArchiveEntry.Name)) {

                    ## This is a folder and we need to create the directory path as the

                    ## ExtractToFile extension method won't do this and will throw an exception

                    $pathSplit = $zipArchiveEntry.FullName.Split('/');

                    $relativeDirectoryPath = New-Object System.Text.StringBuilder;

                    ## Generate the relative directory name

                    for ($pathSplitPart = 0; $pathSplitPart -lt ($pathSplit.Count -1); $pathSplitPart++) {

                        [ref] $null = $relativeDirectoryPath.AppendFormat('{0}\', $pathSplit[$pathSplitPart]);

                    }

                    ## Rename the GitHub \<RepositoryName>-<Branch>\ root directory to \<RepositoryName>\

                    $relativePath = ($relativeDirectoryPath.ToString() -replace $searchString, $replacementString).TrimEnd('\');

                    ## Create the destination directory path, joining the relative directory name

                    $directoryPath = Join-Path -Path $DestinationPath -ChildPath $relativePath;

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

                    $fullDestinationFilePath = Join-Path -Path $directoryPath -ChildPath $zipArchiveEntry.Name;

                }

                elseif (-not $Force -and (Test-Path -Path $fullDestinationFilePath -PathType Leaf)) {

                    ## Are we overwriting existing files (-Force)?

                    Write-Warning ($localized.TargetFileExistsWarning -f $fullDestinationFilePath);

                }

                else {

                    ## Just overwrite any existing file

                    if ($Force -or $PSCmdlet.ShouldProcess($fullDestinationFilePath, 'Expand')) {

                        Write-Debug ($localized.ExtractingZipArchiveEntry -f $fullDestinationFilePath);

                        [System.IO.Compression.ZipFileExtensions]::ExtractToFile($zipArchiveEntry, $fullDestinationFilePath, $true);

                        ## Return a FileInfo object to the pipline

                        Write-Output (Get-Item -Path $fullDestinationFilePath);

                    }

                } # end if

            } # end foreach zipArchiveEntry

            Write-Progress -Activity $activity -Completed;

        } # end try

        catch {

            Write-Error $_.Exception;

        }

    } # end process

} #end function ExpandGitHubZipArchiveItem

function CloseGitHubZipArchive {

<#

    .SYNOPSIS

        Tidies up and closes Zip Archive and file handles

#>

    [CmdletBinding()]

    param ()

    process {

        Write-Verbose ($localized.ClosingZipArchive -f $Path);

        if ($null -ne $zipArchive) {

            $zipArchive.Dispose();

        }

        if ($null -ne $fileStream) {

            $fileStream.Close();

        }

    } # end process

} #end function CloseGitHubZipArchive

# SIG # Begin signature block

# MIIXtwYJKoZIhvcNAQcCoIIXqDCCF6QCAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUUk8CwSGp2pxgVWUmS8mEDT8N

# M/ygghLqMIID7jCCA1egAwIBAgIQfpPr+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

# NwIBFTAjBgkqhkiG9w0BCQQxFgQUh/rQHHDxCm0yOjB6LAmEk7iqDqcwDQYJKoZI

# hvcNAQEBBQAEggEATp4jNCcJsw31ghlGrP9BPFjIl8y0V8AQmEmlmBH/8nBQdHic

# 8uEP7utyIglMmuBQMPOyUNjz0zgRfvX48nADln2a+20K/786KVoajnCy+ulXfaDQ

# bDKAAmlE06eQX9SwcDCOJ5AaSWNvkSE4cfSElj+vBKl6p7rg5yPQkEqKSS4gVzav

# sKMaFnJbrVxb9YJzaiFDX/kxv2FaGAjMeNsLN4BBsgYA887GXcxYVWDNnMztPfew

# e2qZ8iuGh5YG/txPOk5DsfU6CPEvmyZOi8XN+Z3aBGnHIiOIjJvz+j4thZOY7zdG

# 1sef0t0du0sp7/GbG96XTHo2tvaU+w/ujkhMkqGCAgswggIHBgkqhkiG9w0BCQYx

# ggH4MIIB9AIBATByMF4xCzAJBgNVBAYTAlVTMR0wGwYDVQQKExRTeW1hbnRlYyBD

# b3Jwb3JhdGlvbjEwMC4GA1UEAxMnU3ltYW50ZWMgVGltZSBTdGFtcGluZyBTZXJ2

# aWNlcyBDQSAtIEcyAhAOz/Q4yP6/NW4E2GqYGxpQMAkGBSsOAwIaBQCgXTAYBgkq

# hkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0xNzAzMTIyMTAz

# MzZaMCMGCSqGSIb3DQEJBDEWBBSqNk6koPmQM4C8uZyGq2z+sdBnnjANBgkqhkiG

# 9w0BAQEFAASCAQAIbvSbpRRy9y0K5KhZwsmS+EGBQ8BYZpoFYe+1GPZ4nAJw62kv

# SbSwjN1f4t0Wn0tWJ9inkzjmPnx8JKpEEvFiDBv1fEcaKlmwki2oc8r2Wi4Sike2

# OM9sjrAbNpQmIEkj21x5C0wr0gn8zo7lEaIbfBIlrT9lkJsWqkE5efZSu+SqGlrC

# 5RsNNS03xo5YbfecWaYBkV+cnFpnlAZO0VDhUwazKUIGXyLchwYRT94TgH2+T0tH

# Obzs9ABpqewZZAoc6Mv5pqEssEqqnuG3iRpRQiA7V+77Oe3kRCyEyCk665H+BQLh

# fNK7rnmgQLOIPETMUDu9v4YdgW0bVBqotpJX

# SIG # End signature block