PowerShellForGitHub

0.6.3

GitHubRepositoryTraffic.ps1

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

# Licensed under the MIT License.

function Get-GitHubReferrerTraffic

{

<#

    .SYNOPSIS

        Get the top 10 referrers over the last 14 days for a given GitHub repository.

    .DESCRIPTION

        Get the top 10 referrers over the last 14 days for a given GitHub repository.

        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 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-GitHubReferrerTraffic -OwnerName Powershell -RepositoryName PowerShellForGitHub

        Get the top 10 referrers over the last 14 days from the PowerShell\PowerShellForGitHub project.

#>

    [CmdletBinding(

        SupportsShouldProcess,

        DefaultParametersetName='Elements')]

    [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,

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $elements = Resolve-RepositoryElements

    $OwnerName = $elements.ownerName

    $RepositoryName = $elements.repositoryName

    $telemetryProperties = @{

        'OwnerName' = (Get-PiiSafeString -PlainText $OwnerName)

        'RepositoryName' = (Get-PiiSafeString -PlainText $RepositoryName)

    }

    $params = @{

        'UriFragment' = "repos/$OwnerName/$RepositoryName/traffic/popular/referrers"

        'Method' = 'Get'

        'Description' =  "Getting referrers for $RepositoryName"

        'AccessToken' = $AccessToken

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'TelemetryProperties' = $telemetryProperties

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

    }

    return Invoke-GHRestMethod @params

}

function Get-GitHubPathTraffic

{

<#

    .SYNOPSIS

        Get the top 10 popular contents over the last 14 days for a given Github repository.

    .DESCRIPTION

        Get the top 10 popular contents over the last 14 days for a given GitHub repository.

        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 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-GitHubPathTraffic -OwnerName Powershell -RepositoryName PowerShellForGitHub

        Get the top 10 popular contents over the last 14 days from the PowerShell\PowerShellForGitHub project.

#>

    [CmdletBinding(

        SupportsShouldProcess,

        DefaultParametersetName='Elements')]

    [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,

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $elements = Resolve-RepositoryElements

    $OwnerName = $elements.ownerName

    $RepositoryName = $elements.repositoryName

    $telemetryProperties = @{

        'OwnerName' = (Get-PiiSafeString -PlainText $OwnerName)

        'RepositoryName' = (Get-PiiSafeString -PlainText $RepositoryName)

    }

    $params = @{

        'UriFragment' = "repos/$OwnerName/$RepositoryName/traffic/popular/paths"

        'Method' = 'Get'

        'Description' =  "Getting popular contents for $RepositoryName"

        'AccessToken' = $AccessToken

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'TelemetryProperties' = $telemetryProperties

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

    }

    return Invoke-GHRestMethod @params

}

function Get-GitHubViewTraffic

{

<#

    .SYNOPSIS

        Get the total number of views and breakdown per day or week for the last 14 days for the given Github Repository.

    .DESCRIPTION

        Get the total number of views and breakdown per day or week for the last 14 days.

        Timestamps are aligned to UTC midnight of the beginning of the day or week. Week begins on Monday.

        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 Per

        The interval at which return to return the view counts.

    .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-GitHubViewTraffic -OwnerName Powershell -RepositoryName PowerShellForGitHub

        Get the total number of views and breakdown per day or week for the last 14 days from the PowerShell\PowerShellForGitHub project.

#>

    [CmdletBinding(

        SupportsShouldProcess,

        DefaultParametersetName='Elements')]

    [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,

        [ValidateSet('Day', 'Week')]

        [string] $Per = 'Day',

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $elements = Resolve-RepositoryElements

    $OwnerName = $elements.ownerName

    $RepositoryName = $elements.repositoryName

    $telemetryProperties = @{

        'OwnerName' = (Get-PiiSafeString -PlainText $OwnerName)

        'RepositoryName' = (Get-PiiSafeString -PlainText $RepositoryName)

        'Per' = $Per

    }

    $params = @{

        'UriFragment' = "repos/$OwnerName/$RepositoryName/traffic/views`?per=$($Per.ToLower())"

        'Method' = 'Get'

        'Description' =  "Getting views for $RepositoryName"

        'AccessToken' = $AccessToken

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'TelemetryProperties' = $telemetryProperties

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

    }

    return Invoke-GHRestMethod @params

}

function Get-GitHubCloneTraffic

{

<#

    .SYNOPSIS

        Get the total number of clones and breakdown per day or week for the last 14 days for the given Github Repository.

    .DESCRIPTION

        Get the total number of clones and breakdown per day or week for the last 14 days.

        Timestamps are aligned to UTC midnight of the beginning of the day or week. Week begins on Monday.

        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 Per

        The interval at which return to return the view counts.

    .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-GitHubCloneTraffic -OwnerName Powershell -RepositoryName PowerShellForGitHub

        Get the total number of clones and breakdown per day or week for the last 14 days from the PowerShell\PowerShellForGitHub project.

#>

    [CmdletBinding(

        SupportsShouldProcess,

        DefaultParametersetName='Elements')]

    [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,

        [ValidateSet('Day', 'Week')]

        [string] $Per = 'Day',

        [string] $AccessToken,

        [switch] $NoStatus

    )

    Write-InvocationLog

    $elements = Resolve-RepositoryElements

    $OwnerName = $elements.ownerName

    $RepositoryName = $elements.repositoryName

    $telemetryProperties = @{

        'OwnerName' = (Get-PiiSafeString -PlainText $OwnerName)

        'RepositoryName' = (Get-PiiSafeString -PlainText $RepositoryName)

        'Per' = $Per

    }

    $params = @{

        'UriFragment' = "repos/$OwnerName/$RepositoryName/traffic/clones`?per=$($Per.ToLower())"

        'Method' = 'Get'

        'Description' =  "Getting number of clones for $RepositoryName"

        'AccessToken' = $AccessToken

        'TelemetryEventName' = $MyInvocation.MyCommand.Name

        'TelemetryProperties' = $telemetryProperties

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

    }

    return Invoke-GHRestMethod @params

}

# SIG # Begin signature block

# MIIdkgYJKoZIhvcNAQcCoIIdgzCCHX8CAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUdw6xp62bPhrXxB7Nj2zeU4Pp

# dPKgghhuMIIE2jCCA8KgAwIBAgITMwAAAQ1L4dQLLOpAIgAAAAABDTANBgkqhkiG

# 9w0BAQUFADB3MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G

# A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEw

# HwYDVQQDExhNaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EwHhcNMTgwODIzMjAyMDM1

# WhcNMTkxMTIzMjAyMDM1WjCByjELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# LTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEm

# MCQGA1UECxMdVGhhbGVzIFRTUyBFU046RDA4Mi00QkZELUVFQkExJTAjBgNVBAMT

# HE1pY3Jvc29mdCBUaW1lLVN0YW1wIHNlcnZpY2UwggEiMA0GCSqGSIb3DQEBAQUA

# A4IBDwAwggEKAoIBAQCcQyDq0hR2So06aTHLykaXopMmUOT7ilVfB6W3frYNObMv

# igrLEd6Vk4I7TuEKvHXapV2pMN3LiWRcrFAxM8u0HsfbtsMbKqTyfEndtzzmnpb2

# vQnjm8+7IZLB08P/z83oO9WEx1YSokcMGQFqGHy8JAkntVU7hsEQxI5DuTJzIF2n

# kP3J5qqOf/HqY2hJ+7dJMk1xCQjD+sBpfujXoaoSlXA3A0cDu5K+BtBT6PQi1+8A

# HejWMn0IbEwt0IeS+NlbSj3MocpRkQRxwZivZv7q79z8gKjr84IDgsANWlU5eN29

# WIIov1sVegCaXyw6fP5QIUCmlogY7WuQHcCMCFjxAgMBAAGjggEJMIIBBTAdBgNV

# HQ4EFgQUipqaigPJIkjtkN7vRo8QEJgRn0MwHwYDVR0jBBgwFoAUIzT42VJGcArt

# QPt2+7MrsMM1sw8wVAYDVR0fBE0wSzBJoEegRYZDaHR0cDovL2NybC5taWNyb3Nv

# ZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljcm9zb2Z0VGltZVN0YW1wUENBLmNy

# bDBYBggrBgEFBQcBAQRMMEowSAYIKwYBBQUHMAKGPGh0dHA6Ly93d3cubWljcm9z

# b2Z0LmNvbS9wa2kvY2VydHMvTWljcm9zb2Z0VGltZVN0YW1wUENBLmNydDATBgNV

# HSUEDDAKBggrBgEFBQcDCDANBgkqhkiG9w0BAQUFAAOCAQEACG8XrX9JMdm3D2tN

# ne6oynyR21BCx7B14JXNdQQfih+D58yI3pkbI3qX3lD0LAWnee11ON1vv7Ha4yl7

# M8xdEcxbBizb4KRxQlBPG/PlKLyhfP+ksp2Yw/orYxjZ+qAFbyLaD8+IZTHWZzO2

# xPj3YpfNO3IB6PjEEL4bfhqboZ0ES9K03R6LODzjkhcR/PM7nkkeAdq9lLCjWPEU

# XkHjCNGOySkyfgUK5GU/sCybdNv3iKzbFJhB7d8yktgY6R4+1qLpToAJvhCNtFfQ

# dl37LUME2zF5oIGAhTLIhUHS7XVOUEeTiCZNKFOPR7xcLUgAR5F+cGTo6khgz8LX

# VI+ahzCCBgMwggProAMCAQICEzMAAAEEaeLbufuKDYMAAAAAAQQwDQYJKoZIhvcN

# AQELBQAwfjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV

# BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYG

# A1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMTAeFw0xODA3MTIy

# MDA4NDlaFw0xOTA3MjYyMDA4NDlaMHQxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX

# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg

# Q29ycG9yYXRpb24xHjAcBgNVBAMTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjCCASIw

# DQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJvFlfKX9v8jamydc1lzOJvTtOOE

# rY24PiXnoLggWkqRcDjYFKi9msD9DWse7OH8/wQ84mFgrlVqYZL71wB9nuppNtb9

# V3kZl/6EkfbHVa2mrgKK7bGRR1bNSodmRacwGxrtrHtrBdIzgnO+xm8czNToGgUV

# AC6Rl7ZLyGFnIovnExJowhcUryZatu5Vc3z1RLMhJwYA67U2+fwmiq0/f0QUw3q7

# I8iL3r4WisEhogIB2X+YkuIxU4+HsZAkmxf6FU3KAWwQbFICopNfYgNBJIxwp3As

# jUsv1zNZXP1d4D/X5IQXu30+edOCQ2JUQMibXs9wFDtgPGk/nzfn+BaSM4sCAwEA

# AaOCAYIwggF+MB8GA1UdJQQYMBYGCisGAQQBgjdMCAEGCCsGAQUFBwMDMB0GA1Ud

# DgQWBBS6F+MlaPS71Xsjpri2fOemgqtXrjBUBgNVHREETTBLpEkwRzEtMCsGA1UE

# CxMkTWljcm9zb2Z0IElyZWxhbmQgT3BlcmF0aW9ucyBMaW1pdGVkMRYwFAYDVQQF

# Ew0yMzAwMTIrNDM3OTY2MB8GA1UdIwQYMBaAFEhuZOVQBdOCqhc3NyK1bajKdQKV

# MFQGA1UdHwRNMEswSaBHoEWGQ2h0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lv

# cHMvY3JsL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0wNy0wOC5jcmwwYQYIKwYBBQUH

# AQEEVTBTMFEGCCsGAQUFBzAChkVodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtp

# b3BzL2NlcnRzL01pY0NvZFNpZ1BDQTIwMTFfMjAxMS0wNy0wOC5jcnQwDAYDVR0T

# AQH/BAIwADANBgkqhkiG9w0BAQsFAAOCAgEAKcWCCzmZIAzoJFuJOzhQkoOV25Hy

# O9Kk8NqBW3OOZ0gatsmKB3labM7D/GaYF7K716YWtQNWhXsqfS9ABk6eaddpFBWO

# Y/vMgPXbEZxQ7ksCcUxrBwX+Z1PxGbZubizyj9RFKeE2CLIceIEnloeZQhh3lNzG

# vJ2k21amNtBDSF9ABH5n6YjYAMfrMv/eCndgA3P+nqHHHfPAsy1hh8jxN4Xc/G08

# SxNKEna1UEpN513zTyHkmBKBgf7pXKj8FIzRAp9l+3Z1t2JTx33ax7pC4m57Jkoj

# gjLYjXUeEW+Lf3oG1aofGKVwE+fuaJ0HvAbpiQOWDGriIaslA9i3ARHhxCKWKTF8

# w1VO0BznRcZmAIoVIcTFAXAd4mgBOQ8iIcmoc39w2Cz09WnlSWw5paKpyns51fl3

# bzBzg5bAo4uu5X/dY03aFct7+R3ljsQ6qkr0LUVmn/JeuEkXOePfHUmJYYu6M69e

# Quoa1PVRU/GlXZKbh2e4dqsGVeGu1YOvOf8gMYtc5vq1B8+GJ8dBAiM5bVlOLsB4

# rzpJY2zieOAjdtQrqGcAPGVSWDDSeOl47e27KX2iHzjl7FnHk5lF+QCIykR6R9Ym

# R83UCcK1epAMPRYWfreU20ZSAEoeuT1pyVFlatU/EcQtN5dfksINMQya1ll38FBI

# h4l2k9jzfUqwItgwggYHMIID76ADAgECAgphFmg0AAAAAAAcMA0GCSqGSIb3DQEB

# BQUAMF8xEzARBgoJkiaJk/IsZAEZFgNjb20xGTAXBgoJkiaJk/IsZAEZFgltaWNy

# b3NvZnQxLTArBgNVBAMTJE1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhv

# cml0eTAeFw0wNzA0MDMxMjUzMDlaFw0yMTA0MDMxMzAzMDlaMHcxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xITAfBgNVBAMTGE1pY3Jvc29mdCBU

# aW1lLVN0YW1wIFBDQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAJ+h

# bLHf20iSKnxrLhnhveLjxZlRI1Ctzt0YTiQP7tGn0UytdDAgEesH1VSVFUmUG0KS

# rphcMCbaAGvoe73siQcP9w4EmPCJzB/LMySHnfL0Zxws/HvniB3q506jocEjU8qN

# +kXPCdBer9CwQgSi+aZsk2fXKNxGU7CG0OUoRi4nrIZPVVIM5AMs+2qQkDBuh/NZ

# MJ36ftaXs+ghl3740hPzCLdTbVK0RZCfSABKR2YRJylmqJfk0waBSqL5hKcRRxQJ

# gp+E7VV4/gGaHVAIhQAQMEbtt94jRrvELVSfrx54QTF3zJvfO4OToWECtR0Nsfz3

# m7IBziJLVP/5BcPCIAsCAwEAAaOCAaswggGnMA8GA1UdEwEB/wQFMAMBAf8wHQYD

# VR0OBBYEFCM0+NlSRnAK7UD7dvuzK7DDNbMPMAsGA1UdDwQEAwIBhjAQBgkrBgEE

# AYI3FQEEAwIBADCBmAYDVR0jBIGQMIGNgBQOrIJgQFYnl+UlE/wq4QpTlVnkpKFj

# pGEwXzETMBEGCgmSJomT8ixkARkWA2NvbTEZMBcGCgmSJomT8ixkARkWCW1pY3Jv

# c29mdDEtMCsGA1UEAxMkTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9y

# aXR5ghB5rRahSqClrUxzWPQHEy5lMFAGA1UdHwRJMEcwRaBDoEGGP2h0dHA6Ly9j

# cmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL21pY3Jvc29mdHJvb3Rj

# ZXJ0LmNybDBUBggrBgEFBQcBAQRIMEYwRAYIKwYBBQUHMAKGOGh0dHA6Ly93d3cu

# bWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljcm9zb2Z0Um9vdENlcnQuY3J0MBMG

# A1UdJQQMMAoGCCsGAQUFBwMIMA0GCSqGSIb3DQEBBQUAA4ICAQAQl4rDXANENt3p

# tK132855UU0BsS50cVttDBOrzr57j7gu1BKijG1iuFcCy04gE1CZ3XpA4le7r1ia

# HOEdAYasu3jyi9DsOwHu4r6PCgXIjUji8FMV3U+rkuTnjWrVgMHmlPIGL4UD6ZEq

# JCJw+/b85HiZLg33B+JwvBhOnY5rCnKVuKE5nGctxVEO6mJcPxaYiyA/4gcaMvnM

# MUp2MT0rcgvI6nA9/4UKE9/CCmGO8Ne4F+tOi3/FNSteo7/rvH0LQnvUU3Ih7jDK

# u3hlXFsBFwoUDtLaFJj1PLlmWLMtL+f5hYbMUVbonXCUbKw5TNT2eb+qGHpiKe+i

# myk0BncaYsk9Hm0fgvALxyy7z0Oz5fnsfbXjpKh0NbhOxXEjEiZ2CzxSjHFaRkMU

# vLOzsE1nyJ9C/4B5IYCeFTBm6EISXhrIniIh0EPpK+m79EjMLNTYMoBMJipIJF9a

# 6lbvpt6Znco6b72BJ3QGEe52Ib+bgsEnVLaxaj2JoXZhtG6hE6a/qkfwEm/9ijJs

# sv7fUciMI8lmvZ0dhxJkAj0tr1mPuOQh5bWwymO0eFQF1EEuUKyUsKV4q7OglnUa

# 2ZKHE3UiLzKoCG6gW4wlv6DvhMoh1useT8ma7kng9wFlb4kLfchpyOZu6qeXzjEp

# /w7FW1zYTRuh2Povnj8uVRZryROj/TCCB3owggVioAMCAQICCmEOkNIAAAAAAAMw

# DQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n

# dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y

# YXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRlIEF1dGhv

# cml0eSAyMDExMB4XDTExMDcwODIwNTkwOVoXDTI2MDcwODIxMDkwOVowfjELMAkG

# A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx

# HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9z

# b2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAxMTCCAiIwDQYJKoZIhvcNAQEBBQADggIP

# ADCCAgoCggIBAKvw+nIQHC6t2G6qghBNNLrytlghn0IbKmvpWlCquAY4GgRJun/D

# DB7dN2vGEtgL8DjCmQawyDnVARQxQtOJDXlkh36UYCRsr55JnOloXtLfm1OyCizD

# r9mpK656Ca/XllnKYBoF6WZ26DJSJhIv56sIUM+zRLdd2MQuA3WraPPLbfM6XKEW

# 9Ea64DhkrG5kNXimoGMPLdNAk/jj3gcN1Vx5pUkp5w2+oBN3vpQ97/vjK1oQH01W

# KKJ6cuASOrdJXtjt7UORg9l7snuGG9k+sYxd6IlPhBryoS9Z5JA7La4zWMW3Pv4y

# 07MDPbGyr5I4ftKdgCz1TlaRITUlwzluZH9TupwPrRkjhMv0ugOGjfdf8NBSv4yU

# h7zAIXQlXxgotswnKDglmDlKNs98sZKuHCOnqWbsYR9q4ShJnV+I4iVd0yFLPlLE

# tVc/JAPw0XpbL9Uj43BdD1FGd7P4AOG8rAKCX9vAFbO9G9RVS+c5oQ/pI0m8GLhE

# fEXkwcNyeuBy5yTfv0aZxe/CHFfbg43sTUkwp6uO3+xbn6/83bBm4sGXgXvt1u1L

# 50kppxMopqd9Z4DmimJ4X7IvhNdXnFy/dygo8e1twyiPLI9AN0/B4YVEicQJTMXU

# pUMvdJX3bvh4IFgsE11glZo+TzOE2rCIF96eTvSWsLxGoGyY0uDWiIwLAgMBAAGj

# ggHtMIIB6TAQBgkrBgEEAYI3FQEEAwIBADAdBgNVHQ4EFgQUSG5k5VAF04KqFzc3

# IrVtqMp1ApUwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGG

# MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAUci06AjGQQ7kUBU7h6qfHMdEj

# iTQwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3Br

# aS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNybDBe

# BggrBgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9zb2Z0

# LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNydDCB

# nwYDVR0gBIGXMIGUMIGRBgkrBgEEAYI3LgMwgYMwPwYIKwYBBQUHAgEWM2h0dHA6

# Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvZG9jcy9wcmltYXJ5Y3BzLmh0bTBA

# BggrBgEFBQcCAjA0HjIgHQBMAGUAZwBhAGwAXwBwAG8AbABpAGMAeQBfAHMAdABh

# AHQAZQBtAGUAbgB0AC4gHTANBgkqhkiG9w0BAQsFAAOCAgEAZ/KGpZjgVHkaLtPY

# dGcimwuWEeFjkplCln3SeQyQwWVfLiw++MNy0W2D/r4/6ArKO79HqaPzadtjvyI1

# pZddZYSQfYtGUFXYDJJ80hpLHPM8QotS0LD9a+M+By4pm+Y9G6XUtR13lDni6WTJ

# RD14eiPzE32mkHSDjfTLJgJGKsKKELukqQUMm+1o+mgulaAqPyprWEljHwlpblqY

# luSD9MCP80Yr3vw70L01724lruWvJ+3Q3fMOr5kol5hNDj0L8giJ1h/DMhji8MUt

# zluetEk5CsYKwsatruWy2dsViFFFWDgycScaf7H0J/jeLDogaZiyWYlobm+nt3TD

# QAUGpgEqKD6CPxNNZgvAs0314Y9/HG8VfUWnduVAKmWjw11SYobDHWM2l4bf2vP4

# 8hahmifhzaWX0O5dY0HjWwechz4GdwbRBrF1HxS+YWG18NzGGwS+30HHDiju3mUv

# 7Jf2oVyW2ADWoUa9WfOXpQlLSBCZgB/QACnFsZulP0V3HjXG0qKin3p6IvpIlR+r

# +0cjgPWe+L9rt0uX4ut1eBrs6jeZeRhL/9azI2h15q/6/IvrC4DqaTuv/DDtBEyO

# 3991bWORPdGdVk5Pv4BXIqF4ETIheu9BCrE/+6jMpF3BoYibV3FWTkhFwELJm3Zb

# CoBIa/15n8G9bW1qyVJzEw16UM0xggSOMIIEigIBATCBlTB+MQswCQYDVQQGEwJV

# UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE

# ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQgQ29k

# ZSBTaWduaW5nIFBDQSAyMDExAhMzAAABBGni27n7ig2DAAAAAAEEMAkGBSsOAwIa

# BQCggaIwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO

# MAwGCisGAQQBgjcCARUwIwYJKoZIhvcNAQkEMRYEFM5Tz865cI+YhnNarQTEJZhG

# PKGZMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBho

# dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAiHpnidNj

# J8UFHRwxlBMMRvI746kQxvuE08YPQvB66mnANAiRmis3df9BYbikQZYbg8BCR+hq

# YVewVZ5F6UXI7hPXbPdGD4/Fwa2N2rsIM4YU28jOOwmJyV6jT38rM+1MI+xMG3Y/

# coP4fRvTYTaKNNvtnzcaoRZ4tIbCmckegHqYdPuVFuEld7B1/OFTNnS12kc+Q55E

# Fy42cz68CVbrEX8XRu0Np9AJuR5dL3Uihiz1N2c8Ejph7uvBfXyjxdi6PrwTNA3P

# s9JfPVFV0RY5hq7N1JrzPpgnFkkOfT9sXJtRnubSorRQYOfDlcVIFO98NcrSgro1

# QNNZUV7j7WhCWaGCAigwggIkBgkqhkiG9w0BCQYxggIVMIICEQIBATCBjjB3MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSEwHwYDVQQDExhNaWNy

# b3NvZnQgVGltZS1TdGFtcCBQQ0ECEzMAAAENS+HUCyzqQCIAAAAAAQ0wCQYFKw4D

# AhoFAKBdMBgGCSqGSIb3DQEJAzELBgkqhkiG9w0BBwEwHAYJKoZIhvcNAQkFMQ8X

# DTE5MDEwNzE3Mjk0NVowIwYJKoZIhvcNAQkEMRYEFHApcvRWQzIAnaJCZhpg6mqa

# UHCQMA0GCSqGSIb3DQEBBQUABIIBAHcP/XjxKmBZxKJTw9eUUmrIDJ+RPbAoosW3

# DNfUboey8UEFe4uwbpym0p8nEatHdKLrAFnjBXaV2bTqZEzjTugUaVFxf9UhyZ9G

# OF2WK2n9W2nL0PdVNfzkGzF45Ki8qfqBDsa7gncrK2B1vl7JpoRND9utd+lL0flD

# FXrBkFr6Noh41EVLWhwittTkG+cbQmfdJ9bk6hR0+lvD0foyJqUDzsxXYfN3ffeN

# HTkLtFp2K12nYmxzu9mzjwBcj3WxwnWXMV8GZJEFH3fp5YxZTUYCJymsVVZq8Wlo

# j81APofkAzKRMKASyV8YktHRcPnxnsrZQAnEIKKM0eq76h7UIfw=

# SIG # End signature block