PowerShellForGitHub

0.9.1

GitHubMiscellaneous.ps1

                                # Copyright (c) Microsoft Corporation. All rights reserved.

# Licensed under the MIT License.

function Get-GitHubRateLimit

{

<#

    .SYNOPSIS

        Gets the current rate limit status for the GitHub API based on the currently configured

        authentication (Access Token).

    .DESCRIPTION

        Gets the current rate limit status for the GitHub API based on the currently configured

        authentication (Access Token).

        Use Set-GitHubAuthentication to change your current authentication (Access Token).

        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .PARAMETER NoStatus

        If this switch is specified, long-running commands will run on the main thread

        with no commandline status update.  When not specified, those commands run in

        the background, enabling the command prompt to provide status information.

        If not supplied here, the DefaultNoStatus configuration property value will be used.

    .OUTPUTS

        [PSCustomObject]

        Limits returned are _per hour_.

        The Search API has a custom rate limit, separate from the rate limit

        governing the rest of the REST API. The GraphQL API also has a custom

        rate limit that is separate from and calculated differently than rate

        limits in the REST API.

        For these reasons, the Rate Limit API response categorizes your rate limit.

        Under resources, you'll see three objects:

        The core object provides your rate limit status for all non-search-related resources in the REST API.

        The search object provides your rate limit status for the Search API.

        The graphql object provides your rate limit status for the GraphQL API.

        Deprecation notice

        The rate object is deprecated.

        If you're writing new API client code or updating existing code,

        you should use the core object instead of the rate object.

        The core object contains the same information that is present in the rate object.

    .EXAMPLE

        Get-GitHubRateLimit

#>

    [CmdletBinding(SupportsShouldProcess)]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")]

    param(

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $params = @{

        'UriFragment' = 'rate_limit'

        'Method' = 'Get'

        'Description' =  "Getting your API rate limit"

        'AccessToken' = $AccessToken

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue -Name NoStatus -ConfigValueName DefaultNoStatus)

    }

    return Invoke-GHRestMethod @params

}

function ConvertFrom-GitHubMarkdown

{

<#

    .SYNOPSIS

        Converts arbitrary Markdown into HTML.

    .DESCRIPTION

        Converts arbitrary Markdown into HTML.

        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER Content

        The Markdown text to render to HTML.  Content must be 400 KB or less.

    .PARAMETER Mode

        The rendering mode for the Markdown content.

        Markdown - Renders Content in plain Markdown, just like README.md files are rendered

        GitHubFlavoredMarkdown - Creates links for user mentions as well as references to

        SHA-1 hashes, issues, and pull requests.

    .PARAMETER Context

        The repository to use when creating references in 'githubFlavoredMarkdown' mode.

        Specify as [ownerName]/[repositoryName].

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .PARAMETER NoStatus

        If this switch is specified, long-running commands will run on the main thread

        with no commandline status update.  When not specified, those commands run in

        the background, enabling the command prompt to provide status information.

        If not supplied here, the DefaultNoStatus configuration property value will be used.

    .OUTPUTS

        [String] The HTML version of the Markdown content.

    .EXAMPLE

        ConvertFrom-GitHubMarkdown -Content '**Bolded Text**' -Mode Markdown

        Returns back '<p><strong>Bolded Text</strong></p>'

#>

    [CmdletBinding(SupportsShouldProcess)]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")]

    param(

        [Parameter(

            Mandatory,

            ValueFromPipeline)]

        [ValidateNotNullOrEmpty()]

        [ValidateScript({if ([System.Text.Encoding]::UTF8.GetBytes($_).Count -lt 400000) { $true } else { throw "Content must be less than 400 KB." }})]

        [string] $Content,

        [ValidateSet('Markdown', 'GitHubFlavoredMarkdown')]

        [string] $Mode = 'markdown',

        [string] $Context,

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $telemetryProperties = @{

        'Mode' = $Mode

    }

    $modeConverter = @{

        'Markdown' = 'markdown'

        'GitHubFlavoredMarkdown' = 'gfm'

    }

    $hashBody = @{

        'text' = $Content

        'mode' = $modeConverter[$Mode]

    }

    if (-not [String]::IsNullOrEmpty($Context)) { $hashBody['context'] = $Context }

    $params = @{

        'UriFragment' = 'markdown'

        'Body' = (ConvertTo-Json -InputObject $hashBody)

        'Method' = 'Post'

        'Description' =  "Converting Markdown to HTML"

        'AccessToken' = $AccessToken

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'TelemetryProperties' = $telemetryProperties

        'NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue -Name NoStatus -ConfigValueName DefaultNoStatus)

    }

    return Invoke-GHRestMethod @params

}

function Get-GitHubLicense

{

<#

    .SYNOPSIS

        Gets a license list or license content from GitHub.

    .DESCRIPTION

        Gets a license list or license content from GitHub.

        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER OwnerName

        Owner of the repository.

        If not supplied here, the DefaultOwnerName configuration property value will be used.

    .PARAMETER RepositoryName

        Name of the repository.

        If not supplied here, the DefaultRepositoryName configuration property value will be used.

    .PARAMETER Uri

        Uri for the repository.

        The OwnerName and RepositoryName will be extracted from here instead of needing to provide

        them individually.

    .PARAMETER Name

        The name of the license to retrieve the content for.  If not specified, all licenses

        will be returned.

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .PARAMETER NoStatus

        If this switch is specified, long-running commands will run on the main thread

        with no commandline status update.  When not specified, those commands run in

        the background, enabling the command prompt to provide status information.

        If not supplied here, the DefaultNoStatus configuration property value will be used.

    .EXAMPLE

        Get-GitHubLicense

        Returns metadata about popular open source licenses

    .EXAMPLE

        Get-GitHubLicense -Name mit

        Gets the content of the mit license file

    .EXAMPLE

        Get-GitHubLicense -OwnerName Microsoft -RepositoryName PowerShellForGitHub

        Gets the content of the license file for the Microsoft\PowerShellForGitHub repository.

        It may be necessary to convert the content of the file.  Check the 'encoding' property of

        the result to know how 'content' is encoded.  As an example, to convert from Base64, do

        the following:

        [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String($result.content))

#>

    [CmdletBinding(SupportsShouldProcess)]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")]

    param(

        [Parameter(ParameterSetName='Elements')]

        [string] $OwnerName,

        [Parameter(ParameterSetName='Elements')]

        [string] $RepositoryName,

        [Parameter(

            Mandatory,

            ParameterSetName='Uri')]

        [string] $Uri,

        [Parameter(

            Mandatory,

            ParameterSetName='Individual')]

        [string] $Name,

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $elements = Resolve-RepositoryElements -DisableValidation

    $OwnerName = $elements.ownerName

    $RepositoryName = $elements.repositoryName

    $telemetryProperties = @{}

    $uriFragment = 'licenses'

    $description = 'Getting all licenses'

    if ($PSBoundParameters.ContainsKey('Name'))

    {

        $telemetryProperties['Name'] = $Name

        $uriFragment = "licenses/$Name"

        $description = "Getting the $Name license"

    }

    elseif ((-not [String]::IsNullOrEmpty($OwnerName)) -and (-not [String]::IsNullOrEmpty($RepositoryName)))

    {

        $telemetryProperties['OwnerName'] = Get-PiiSafeString -PlainText $OwnerName

        $telemetryProperties['RepositoryName'] = Get-PiiSafeString -PlainText $RepositoryName

        $uriFragment = "repos/$OwnerName/$RepositoryName/license"

        $description = "Getting the license for $RepositoryName"

    }

    $params = @{

        'UriFragment' = $uriFragment

        'Method' = 'Get'

        'Description' =  $description

        'AccessToken' = $AccessToken

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'TelemetryProperties' = $telemetryProperties

        'NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue -Name NoStatus -ConfigValueName DefaultNoStatus)

    }

    return Invoke-GHRestMethod @params

}

function Get-GitHubEmoji

{

<#

    .SYNOPSIS

        Gets all the emojis available to use on GitHub.

    .DESCRIPTION

        Gets all the emojis available to use on GitHub.

        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .PARAMETER NoStatus

        If this switch is specified, long-running commands will run on the main thread

        with no commandline status update.  When not specified, those commands run in

        the background, enabling the command prompt to provide status information.

        If not supplied here, the DefaultNoStatus configuration property value will be used.

    .OUTPUTS

        [PSCustomObject]

        The emoji name and a link to its image.

    .EXAMPLE

        Get-GitHubEmoji

#>

    [CmdletBinding(SupportsShouldProcess)]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")]

    param(

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $params = @{

        'UriFragment' = 'emojis'

        'Method' = 'Get'

        'Description' =  "Getting all GitHub emojis"

        'AccessToken' = $AccessToken

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue -Name NoStatus -ConfigValueName DefaultNoStatus)

    }

    return Invoke-GHRestMethod @params

}

function Get-GitHubCodeOfConduct

{

<#

    .SYNOPSIS

        Gets license or license content from GitHub.

    .DESCRIPTION

        Gets license or license content from GitHub.

        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER OwnerName

        Owner of the repository.

        If not supplied here, the DefaultOwnerName configuration property value will be used.

    .PARAMETER RepositoryName

        Name of the repository.

        If not supplied here, the DefaultRepositoryName configuration property value will be used.

    .PARAMETER Uri

        Uri for the repository.

        The OwnerName and RepositoryName will be extracted from here instead of needing to provide

        them individually.

    .PARAMETER Name

        The name of the license to retrieve the content for.  If not specified, all licenses

        will be returned.

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .PARAMETER NoStatus

        If this switch is specified, long-running commands will run on the main thread

        with no commandline status update.  When not specified, those commands run in

        the background, enabling the command prompt to provide status information.

        If not supplied here, the DefaultNoStatus configuration property value will be used.

    .EXAMPLE

        Get-GitHubCodeOfConduct

        Returns metadata about popular Codes of Conduct

    .EXAMPLE

        Get-GitHubCodeOfConduct -Name citizen_code_of_conduct

        Gets the content of the 'Citizen Code of Conduct'

    .EXAMPLE

        Get-GitHubCodeOfConduct -OwnerName Microsoft -RepositoryName PowerShellForGitHub

        Gets the content of the Code of Coduct file for the Microsoft\PowerShellForGitHub repository

        if one is detected.

        It may be necessary to convert the content of the file.  Check the 'encoding' property of

        the result to know how 'content' is encoded.  As an example, to convert from Base64, do

        the following:

        [System.Text.Encoding]::UTF8.GetString([System.Convert]::FromBase64String($result.content))

#>

    [CmdletBinding(SupportsShouldProcess)]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")]

    param(

        [Parameter(ParameterSetName='Elements')]

        [string] $OwnerName,

        [Parameter(ParameterSetName='Elements')]

        [string] $RepositoryName,

        [Parameter(

            Mandatory,

            ParameterSetName='Uri')]

        [string] $Uri,

        [Parameter(

            Mandatory,

            ParameterSetName='Individual')]

        [string] $Name,

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $elements = Resolve-RepositoryElements -DisableValidation

    $OwnerName = $elements.ownerName

    $RepositoryName = $elements.repositoryName

    $telemetryProperties = @{}

    $uriFragment = 'codes_of_conduct'

    $description = 'Getting all Codes of Conduct'

    if ($PSBoundParameters.ContainsKey('Name'))

    {

        $telemetryProperties['Name'] = $Name

        $uriFragment = "codes_of_conduct/$Name"

        $description = "Getting the $Name Code of Conduct"

    }

    elseif ((-not [String]::IsNullOrEmpty($OwnerName)) -and (-not [String]::IsNullOrEmpty($RepositoryName)))

    {

        $telemetryProperties['OwnerName'] = Get-PiiSafeString -PlainText $OwnerName

        $telemetryProperties['RepositoryName'] = Get-PiiSafeString -PlainText $RepositoryName

        $uriFragment = "repos/$OwnerName/$RepositoryName/community/code_of_conduct"

        $description = "Getting the Code of Conduct for $RepositoryName"

    }

    $params = @{

        'UriFragment' = $uriFragment

        'Method' = 'Get'

        'AcceptHeader' = 'application/vnd.github.scarlet-witch-preview+json'

        'Description' =  $description

        'AccessToken' = $AccessToken

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'TelemetryProperties' = $telemetryProperties

        'NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue -Name NoStatus -ConfigValueName DefaultNoStatus)

    }

    return Invoke-GHRestMethod @params

}

function Get-GitHubGitIgnore

{

<#

    .SYNOPSIS

        Gets the list of available .gitignore templates, or their content, from GitHub.

    .DESCRIPTION

        Gets the list of available .gitignore templates, or their content, from GitHub.

        The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub

    .PARAMETER Name

        The name of the .gitignore template whose content should be fetched.

        Not providing this will cause a list of all available templates to be returned.

    .PARAMETER AccessToken

        If provided, this will be used as the AccessToken for authentication with the

        REST Api.  Otherwise, will attempt to use the configured value or will run unauthenticated.

    .PARAMETER NoStatus

        If this switch is specified, long-running commands will run on the main thread

        with no commandline status update.  When not specified, those commands run in

        the background, enabling the command prompt to provide status information.

        If not supplied here, the DefaultNoStatus configuration property value will be used.

    .EXAMPLE

        Get-GitHubGitIgnore

        Returns the list of all available .gitignore templates.

    .EXAMPLE

        Get-GitHubGitIgnore -Name VisualStudio

        Returns the content of the VisualStudio.gitignore template.

#>

    [CmdletBinding(SupportsShouldProcess)]

    [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")]

    param(

        [string] $Name,

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $telemetryProperties = @{}

    $uriFragment = 'gitignore/templates'

    $description = 'Getting all gitignore templates'

    if ($PSBoundParameters.ContainsKey('Name'))

    {

        $telemetryProperties['Name'] = $Name

        $uriFragment = "gitignore/templates/$Name"

        $description = "Getting $Name.gitignore"

    }

    $params = @{

        'UriFragment' = $uriFragment

        'Method' = 'Get'

        'Description' =  $description

        'AccessToken' = $AccessToken

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'TelemetryProperties' = $telemetryProperties

        'NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue -Name NoStatus -ConfigValueName DefaultNoStatus)

    }

    return Invoke-GHRestMethod @params

}

# SIG # Begin signature block

# MIIjgQYJKoZIhvcNAQcCoIIjcjCCI24CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDoxPllBSU8JtmH

# c/p7ysX8AWIhe5JH5rzduC47ouMgZKCCDYEwggX/MIID56ADAgECAhMzAAABUZ6N

# j0Bxow5BAAAAAAFRMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD

# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p

# bmcgUENBIDIwMTEwHhcNMTkwNTAyMjEzNzQ2WhcNMjAwNTAyMjEzNzQ2WjB0MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy

# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB

# AQCVWsaGaUcdNB7xVcNmdfZiVBhYFGcn8KMqxgNIvOZWNH9JYQLuhHhmJ5RWISy1

# oey3zTuxqLbkHAdmbeU8NFMo49Pv71MgIS9IG/EtqwOH7upan+lIq6NOcw5fO6Os

# +12R0Q28MzGn+3y7F2mKDnopVu0sEufy453gxz16M8bAw4+QXuv7+fR9WzRJ2CpU

# 62wQKYiFQMfew6Vh5fuPoXloN3k6+Qlz7zgcT4YRmxzx7jMVpP/uvK6sZcBxQ3Wg

# B/WkyXHgxaY19IAzLq2QiPiX2YryiR5EsYBq35BP7U15DlZtpSs2wIYTkkDBxhPJ

# IDJgowZu5GyhHdqrst3OjkSRAgMBAAGjggF+MIIBejAfBgNVHSUEGDAWBgorBgEE

# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUV4Iarkq57esagu6FUBb270Zijc8w

# UAYDVR0RBEkwR6RFMEMxKTAnBgNVBAsTIE1pY3Jvc29mdCBPcGVyYXRpb25zIFB1

# ZXJ0byBSaWNvMRYwFAYDVQQFEw0yMzAwMTIrNDU0MTM1MB8GA1UdIwQYMBaAFEhu

# ZOVQBdOCqhc3NyK1bajKdQKVMFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cu

# bWljcm9zb2Z0LmNvbS9wa2lvcHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0w

# Ny0wOC5jcmwwYQYIKwYBBQUHAQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3

# Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAx

# MS0wNy0wOC5jcnQwDAYDVR0TAQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAWg+A

# rS4Anq7KrogslIQnoMHSXUPr/RqOIhJX+32ObuY3MFvdlRElbSsSJxrRy/OCCZdS

# se+f2AqQ+F/2aYwBDmUQbeMB8n0pYLZnOPifqe78RBH2fVZsvXxyfizbHubWWoUf

# NW/FJlZlLXwJmF3BoL8E2p09K3hagwz/otcKtQ1+Q4+DaOYXWleqJrJUsnHs9UiL

# crVF0leL/Q1V5bshob2OTlZq0qzSdrMDLWdhyrUOxnZ+ojZ7UdTY4VnCuogbZ9Zs

# 9syJbg7ZUS9SVgYkowRsWv5jV4lbqTD+tG4FzhOwcRQwdb6A8zp2Nnd+s7VdCuYF

# sGgI41ucD8oxVfcAMjF9YX5N2s4mltkqnUe3/htVrnxKKDAwSYliaux2L7gKw+bD

# 1kEZ/5ozLRnJ3jjDkomTrPctokY/KaZ1qub0NUnmOKH+3xUK/plWJK8BOQYuU7gK

# YH7Yy9WSKNlP7pKj6i417+3Na/frInjnBkKRCJ/eYTvBH+s5guezpfQWtU4bNo/j

# 8Qw2vpTQ9w7flhH78Rmwd319+YTmhv7TcxDbWlyteaj4RK2wk3pY1oSz2JPE5PNu

# Nmd9Gmf6oePZgy7Ii9JLLq8SnULV7b+IP0UXRY9q+GdRjM2AEX6msZvvPCIoG0aY

# HQu9wZsKEK2jqvWi8/xdeeeSI9FN6K1w4oVQM4Mwggd6MIIFYqADAgECAgphDpDS

# AAAAAAADMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMK

# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0

# IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0

# ZSBBdXRob3JpdHkgMjAxMTAeFw0xMTA3MDgyMDU5MDlaFw0yNjA3MDgyMTA5MDla

# MH4xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS

# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMT

# H01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTEwggIiMA0GCSqGSIb3DQEB

# AQUAA4ICDwAwggIKAoICAQCr8PpyEBwurdhuqoIQTTS68rZYIZ9CGypr6VpQqrgG

# OBoESbp/wwwe3TdrxhLYC/A4wpkGsMg51QEUMULTiQ15ZId+lGAkbK+eSZzpaF7S

# 35tTsgosw6/ZqSuuegmv15ZZymAaBelmdugyUiYSL+erCFDPs0S3XdjELgN1q2jz

# y23zOlyhFvRGuuA4ZKxuZDV4pqBjDy3TQJP4494HDdVceaVJKecNvqATd76UPe/7

# 4ytaEB9NViiienLgEjq3SV7Y7e1DkYPZe7J7hhvZPrGMXeiJT4Qa8qEvWeSQOy2u

# M1jFtz7+MtOzAz2xsq+SOH7SnYAs9U5WkSE1JcM5bmR/U7qcD60ZI4TL9LoDho33

# X/DQUr+MlIe8wCF0JV8YKLbMJyg4JZg5SjbPfLGSrhwjp6lm7GEfauEoSZ1fiOIl

# XdMhSz5SxLVXPyQD8NF6Wy/VI+NwXQ9RRnez+ADhvKwCgl/bwBWzvRvUVUvnOaEP

# 6SNJvBi4RHxF5MHDcnrgcuck379GmcXvwhxX24ON7E1JMKerjt/sW5+v/N2wZuLB

# l4F77dbtS+dJKacTKKanfWeA5opieF+yL4TXV5xcv3coKPHtbcMojyyPQDdPweGF

# RInECUzF1KVDL3SV9274eCBYLBNdYJWaPk8zhNqwiBfenk70lrC8RqBsmNLg1oiM

# CwIDAQABo4IB7TCCAekwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFEhuZOVQ

# BdOCqhc3NyK1bajKdQKVMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1Ud

# DwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFHItOgIxkEO5FAVO

# 4eqnxzHRI4k0MFoGA1UdHwRTMFEwT6BNoEuGSWh0dHA6Ly9jcmwubWljcm9zb2Z0

# LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y

# Mi5jcmwwXgYIKwYBBQUHAQEEUjBQME4GCCsGAQUFBzAChkJodHRwOi8vd3d3Lm1p

# Y3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dDIwMTFfMjAxMV8wM18y

# Mi5jcnQwgZ8GA1UdIASBlzCBlDCBkQYJKwYBBAGCNy4DMIGDMD8GCCsGAQUFBwIB

# FjNodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2RvY3MvcHJpbWFyeWNw

# cy5odG0wQAYIKwYBBQUHAgIwNB4yIB0ATABlAGcAYQBsAF8AcABvAGwAaQBjAHkA

# XwBzAHQAYQB0AGUAbQBlAG4AdAAuIB0wDQYJKoZIhvcNAQELBQADggIBAGfyhqWY

# 4FR5Gi7T2HRnIpsLlhHhY5KZQpZ90nkMkMFlXy4sPvjDctFtg/6+P+gKyju/R6mj

# 82nbY78iNaWXXWWEkH2LRlBV2AySfNIaSxzzPEKLUtCw/WvjPgcuKZvmPRul1LUd

# d5Q54ulkyUQ9eHoj8xN9ppB0g430yyYCRirCihC7pKkFDJvtaPpoLpWgKj8qa1hJ

# Yx8JaW5amJbkg/TAj/NGK978O9C9Ne9uJa7lryft0N3zDq+ZKJeYTQ49C/IIidYf

# wzIY4vDFLc5bnrRJOQrGCsLGra7lstnbFYhRRVg4MnEnGn+x9Cf43iw6IGmYslmJ

# aG5vp7d0w0AFBqYBKig+gj8TTWYLwLNN9eGPfxxvFX1Fp3blQCplo8NdUmKGwx1j

# NpeG39rz+PIWoZon4c2ll9DuXWNB41sHnIc+BncG0QaxdR8UvmFhtfDcxhsEvt9B

# xw4o7t5lL+yX9qFcltgA1qFGvVnzl6UJS0gQmYAf0AApxbGbpT9Fdx41xtKiop96

# eiL6SJUfq/tHI4D1nvi/a7dLl+LrdXga7Oo3mXkYS//WsyNodeav+vyL6wuA6mk7

# r/ww7QRMjt/fdW1jkT3RnVZOT7+AVyKheBEyIXrvQQqxP/uozKRdwaGIm1dxVk5I

# RcBCyZt2WwqASGv9eZ/BvW1taslScxMNelDNMYIVVjCCFVICAQEwgZUwfjELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z

# b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMQITMwAAAVGejY9AcaMOQQAAAAABUTAN

# BglghkgBZQMEAgEFAKCBrjAZBgkqhkiG9w0BCQMxDAYKKwYBBAGCNwIBBDAcBgor

# BgEEAYI3AgELMQ4wDAYKKwYBBAGCNwIBFTAvBgkqhkiG9w0BCQQxIgQgSBmSSsxe

# /jvERq3apXRVndzcMdHzJ955rt4OPf3Si4AwQgYKKwYBBAGCNwIBDDE0MDKgFIAS

# AE0AaQBjAHIAbwBzAG8AZgB0oRqAGGh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbTAN

# BgkqhkiG9w0BAQEFAASCAQBUtn/zRQqHuL0LpbM3mlu8AciKIUTWGUaJ6vSzy8vt

# IcDMV687INgOokKsjUUgE7SFJk/a5PAvkoZVqiyFreJ+a+AC8Yj+qoXNF5mZ5QoJ

# OaKgkFxuzLPcoEiTvPLZ+LnclTwUFfWmYDMSQreTfPGgOei69U1Dd4Pm3xpgYzvo

# IopjdltV3ci21+q+ZASuNIx1icccdFWu4zus5vO5ybR+kBZK+mHoAXGaH8di0rOS

# 7TRqUL8+9OmMgvWBnsytAVf8ulJxSFJsdiWUv3YLwQTVeqmz/Q+0cqeYpW/gdXyD

# YRMSarffLk5hwhVUpNrITlpL7e39wEEGozGrwOJ/CAF/oYIS4DCCEtwGCisGAQQB

# gjcDAwExghLMMIISyAYJKoZIhvcNAQcCoIISuTCCErUCAQMxDzANBglghkgBZQME

# AgEFADCCAU8GCyqGSIb3DQEJEAEEoIIBPgSCATowggE2AgEBBgorBgEEAYRZCgMB

# MDEwDQYJYIZIAWUDBAIBBQAEIPvsDWUJfaYjOzXcQjZXPSxX+7O04MRFWRRoiPbY

# u/NmAgZdX/L7zhIYETIwMTkwOTI0MjE0NjUwLjdaMASAAgH0oIHQpIHNMIHKMQsw

# CQYDVQQGEwJVUzELMAkGA1UECBMCV0ExEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV

# BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IEly

# ZWxhbmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMgVFNTIEVT

# TjpBMjQwLTRCODItMTMwRTElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAg

# c2VydmljZaCCDjkwggTxMIID2aADAgECAhMzAAAA4LIYqdTRwrT3AAAAAADgMA0G

# CSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9u

# MRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRp

# b24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTE4

# MDgyMzIwMjcwMVoXDTE5MTEyMzIwMjcwMVowgcoxCzAJBgNVBAYTAlVTMQswCQYD

# VQQIEwJXQTEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENv

# cnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25z

# IExpbWl0ZWQxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNOOkEyNDAtNEI4Mi0xMzBF

# MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBzZXJ2aWNlMIIBIjANBgkq

# hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAwpf4Zw7HpmycexTEuUbmibIkCQz9LYqs

# ngnrbYjZRnDaGuNvKFbW5R+smWrQl2coMoc25wyaH0xyBrXYhM0HOXz4XXX03eIR

# EIHeXIfwZRiE1xRMCeHfxoR2UNYWy3YgU/4+u0MdeVXrl8uZ/4zPT7yGwZLElsF/

# L65IUU/66mtcVq5hfkn3GCsPqQvnd7VB64AAqNGGlR7kt45aV4N9wPqbpfMIm2QX

# BsTBdQqsJT9AHzFutA6eKpvyS21sXcf6ToojqzP7cpBQ7RJzdOx10Y1w4Q4XyHgQ

# s+Bj4ghBZPeAGhccrBXhZ/b8s+08iicVJLFyYbVhqtouFpj3KYcg8wIDAQABo4IB

# GzCCARcwHQYDVR0OBBYEFGtB0wq2Oc6s7/6eOK1rkm12gIfoMB8GA1UdIwQYMBaA

# FNVjOlyKMZDzQ3t8RhvFM2hahW1VMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9j

# cmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1RpbVN0YVBDQV8y

# MDEwLTA3LTAxLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6

# Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljVGltU3RhUENBXzIwMTAt

# MDctMDEuY3J0MAwGA1UdEwEB/wQCMAAwEwYDVR0lBAwwCgYIKwYBBQUHAwgwDQYJ

# KoZIhvcNAQELBQADggEBAAsf3p3ZkuQ1usYG/HyHRKiPet31AeyKGJWDUFP2GcKt

# eebitZcIXB+UdQmlTK/pcjSHw/JfpasvJnaLvmcHK586N5tlBBjtLjRXeHPCHsOW

# ePVfugKI0+s+SBiYd8uergwAkM0Wa0fturgsdZy7GIyv1rcUA6tSBx1ngMX6xsbA

# GTtQXUKNuTMd+GbHlYlY/rrH5stJ1Jn72dIRXDHjXeIuCnbNN5GPwsFlWQcOtrQI

# zhyv3PNcDu4YrrbvSV+DDY2hLhXYXojcJh8gJm6amJs+ivvSDzO+YlxC284w3Osi

# yaVTqte4H1QwmsHq8s4FZwtgiMau4AxskzPWn8DLREkwggZxMIIEWaADAgECAgph

# CYEqAAAAAAACMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UE

# CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z

# b2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZp

# Y2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0xMDA3MDEyMTM2NTVaFw0yNTA3MDEyMTQ2

# NTVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQH

# EwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNV

# BAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIIBIjANBgkqhkiG9w0B

# AQEFAAOCAQ8AMIIBCgKCAQEAqR0NvHcRijog7PwTl/X6f2mUa3RUENWlCgCChfvt

# fGhLLF/Fw+Vhwna3PmYrW/AVUycEMR9BGxqVHc4JE458YTBZsTBED/FgiIRUQwzX

# Tbg4CLNC3ZOs1nMwVyaCo0UN0Or1R4HNvyRgMlhgRvJYR4YyhB50YWeRX4FUsc+T

# TJLBxKZd0WETbijGGvmGgLvfYfxGwScdJGcSchohiq9LZIlQYrFd/XcfPfBXday9

# ikJNQFHRD5wGPmd/9WbAA5ZEfu/QS/1u5ZrKsajyeioKMfDaTgaRtogINeh4HLDp

# mc085y9Euqf03GS9pAHBIAmTeM38vMDJRF1eFpwBBU8iTQIDAQABo4IB5jCCAeIw

# EAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFNVjOlyKMZDzQ3t8RhvFM2hahW1V

# MBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1UdDwQEAwIBhjAPBgNVHRMB

# Af8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP6KJcYmjRPZSQW9fOmhjEMFYGA1Ud

# HwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3By

# b2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNybDBaBggrBgEFBQcBAQRO

# MEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2Vy

# dHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3J0MIGgBgNVHSABAf8EgZUwgZIw

# gY8GCSsGAQQBgjcuAzCBgTA9BggrBgEFBQcCARYxaHR0cDovL3d3dy5taWNyb3Nv

# ZnQuY29tL1BLSS9kb2NzL0NQUy9kZWZhdWx0Lmh0bTBABggrBgEFBQcCAjA0HjIg

# HQBMAGUAZwBhAGwAXwBQAG8AbABpAGMAeQBfAFMAdABhAHQAZQBtAGUAbgB0AC4g

# HTANBgkqhkiG9w0BAQsFAAOCAgEAB+aIUQ3ixuCYP4FxAz2do6Ehb7Prpsz1Mb7P

# BeKp/vpXbRkws8LFZslq3/Xn8Hi9x6ieJeP5vO1rVFcIK1GCRBL7uVOMzPRgEop2

# zEBAQZvcXBf/XPleFzWYJFZLdO9CEMivv3/Gf/I3fVo/HPKZeUqRUgCvOA8X9S95

# gWXZqbVr5MfO9sp6AG9LMEQkIjzP7QOllo9ZKby2/QThcJ8ySif9Va8v/rbljjO7

# Yl+a21dA6fHOmWaQjP9qYn/dxUoLkSbiOewZSnFjnXshbcOco6I8+n99lmqQeKZt

# 0uGc+R38ONiU9MalCpaGpL2eGq4EQoO4tYCbIjggtSXlZOz39L9+Y1klD3ouOVd2

# onGqBooPiRa6YacRy5rYDkeagMXQzafQ732D8OE7cQnfXXSYIghh2rBQHm+98eEA

# 3+cxB6STOvdlR3jo+KhIq/fecn5ha293qYHLpwmsObvsxsvYgrRyzR30uIUBHoD7

# G4kqVDmyW9rIDVWZeodzOwjmmC3qjeAzLhIp9cAvVCch98isTtoouLGp25ayp0Ki

# yc8ZQU3ghvkqmqMRZjDTu3QyS99je/WZii8bxyGvWbWu3EQ8l1Bx16HSxVXjad5X

# wdHeMMD9zOZN+w2/XU/pnR4ZOC+8z1gFLu8NoFA12u8JJxzVs341Hgi62jbb01+P

# 3nSISRKhggLLMIICNAIBATCB+KGB0KSBzTCByjELMAkGA1UEBhMCVVMxCzAJBgNV

# BAgTAldBMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMg

# TGltaXRlZDEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046QTI0MC00QjgyLTEzMEUx

# JTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIHNlcnZpY2WiIwoBATAHBgUr

# DgMCGgMVAMZ5pIzl3naash0KpCRp+3sIUgvRoIGDMIGApH4wfDELMAkGA1UEBhMC

# VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV

# BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp

# bWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQEFBQACBQDhNKDzMCIYDzIwMTkw

# OTI0MjIwNDM1WhgPMjAxOTA5MjUyMjA0MzVaMHQwOgYKKwYBBAGEWQoEATEsMCow

# CgIFAOE0oPMCAQAwBwIBAAICAVIwBwIBAAICEdIwCgIFAOE18nMCAQAwNgYKKwYB

# BAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQACAwehIKEKMAgCAQACAwGG

# oDANBgkqhkiG9w0BAQUFAAOBgQBSnc+xGox8lnXyk3H0BPsDvpvDSsKjhngJ5x6C

# uI8hMqxuZrmBoUToBAxnnyEJ0COxicMKr0Qy2zLNPsWGkMXCOGtQfGrVMxFGDc7W

# GrdHc3maSsvm78aau8Z2j83ljLqxdGtqkcSQbYH8fQrG4iZe7BJJfBykfspJOtjn

# O0T+sTGCAw0wggMJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw

# AhMzAAAA4LIYqdTRwrT3AAAAAADgMA0GCWCGSAFlAwQCAQUAoIIBSjAaBgkqhkiG

# 9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIII1URaSf8YmnNPr

# z3eDNx24yalXPtjUPuzOVGZF8OWKMIH6BgsqhkiG9w0BCRACLzGB6jCB5zCB5DCB

# vQQgpYEvVaQzKLJXcoNRkD1VZOcMDTg/j3JdmqC70axCX5AwgZgwgYCkfjB8MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNy

# b3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAOCyGKnU0cK09wAAAAAA4DAi

# BCCdWYjPSFC1KrU6TYV+ujkl++DhugojRdLYxa8w+PNimDANBgkqhkiG9w0BAQsF

# AASCAQBt8kMMaVHFb8+vUsZc7DpO6fQNQHLMjxxuWJk6N4QFBWkOv/16GczqwEZX

# uf4cxWfoa5X/Kjb/oMkSVzX8COXOBDL0jI0c1MCekGWfgk1+2+r1nuALSMZVEV13

# UlN+SELerOUUcMsQg0IEwsIhoyKNrwOZnqNy2t7cy2PkB2rRfZYdxqiYGFAMjzya

# pNaoMWOAapnihWM1vGUTOdq7U+7H3qoV56boNxnkmeVQkqg0AeqKcLtaPXhsN97l

# eXCtbCsXEeA1PPNPGTXertxL4k4jt2Q79AGG+f9/AcQkG2s+tK8m094P6eeozmbe

# V9SkejNgA19lfRXk6IqiaSP5ehBg

# SIG # End signature block