GitHubCore.ps1
|
# Copyright (c) Microsoft Corporation. All rights reserved. # Licensed under the MIT License. @{ defaultAcceptHeader = 'application/vnd.github.v3+json' mediaTypeVersion = 'v3' squirrelAcceptHeader = 'application/vnd.github.squirrel-girl-preview' symmetraAcceptHeader = 'application/vnd.github.symmetra-preview+json' mercyAcceptHeader = 'application/vnd.github.mercy-preview+json' nebulaAcceptHeader = 'application/vnd.github.nebula-preview+json' baptisteAcceptHeader = 'application/vnd.github.baptiste-preview+json' scarletWitchAcceptHeader = 'application/vnd.github.scarlet-witch-preview+json' dorianAcceptHeader = 'application/vnd.github.dorian-preview+json' londonAcceptHeader = 'application/vnd.github.london-preview+json' }.GetEnumerator() | ForEach-Object { Set-Variable -Scope Script -Option ReadOnly -Name $_.Key -Value $_.Value } Set-Variable -Scope Script -Option ReadOnly -Name ValidBodyContainingRequestMethods -Value ('Post', 'Patch', 'Put', 'Delete') function Invoke-GHRestMethod { <# .SYNOPSIS A wrapper around Invoke-WebRequest that understands the Store API. .DESCRIPTION A very heavy wrapper around Invoke-WebRequest that understands the Store API and how to perform its operation with and without console status updates. It also understands how to parse and handle errors from the REST calls. The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub .PARAMETER UriFragment The unique, tail-end, of the REST URI that indicates what Store REST action will be performed. This should not start with a leading "/". .PARAMETER Method The type of REST method being performed. This only supports a reduced set of the possible REST methods (delete, get, post, put). .PARAMETER Description A friendly description of the operation being performed for logging and console display purposes. .PARAMETER Body This optional parameter forms the body of a PUT or POST request. It will be automatically encoded to UTF8 and sent as Content Type: "application/json; charset=UTF-8" .PARAMETER AcceptHeader Specify the media type in the Accept header. Different types of commands may require different media types. .PARAMETER ExtendedResult If specified, the result will be a PSObject that contains the normal result, along with the response code and other relevant header detail content. .PARAMETER AccessToken If provided, this will be used as the AccessToken for authentication with the REST Api as opposed to requesting a new one. .PARAMETER TelemetryEventName If provided, the successful execution of this REST command will be logged to telemetry using this event name. .PARAMETER TelemetryProperties If provided, the successful execution of this REST command will be logged to telemetry with these additional properties. This will be silently ignored if TelemetryEventName is not provided as well. .PARAMETER TelemetryExceptionBucket If provided, any exception that occurs will be logged to telemetry using this bucket. It's possible that users will wish to log exceptions but not success (by providing TelemetryEventName) if this is being executed as part of a larger scenario. If this isn't provided, but TelemetryEventName *is* provided, then TelemetryEventName will be used as the exception bucket value in the event of an exception. If neither is specified, no bucket value will be used. .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. .OUTPUTS [PSCustomObject] - The result of the REST operation, in whatever form it comes in. .EXAMPLE Invoke-GHRestMethod -UriFragment "applications/" -Method Get -Description "Get first 10 applications" Gets the first 10 applications for the connected dev account. .EXAMPLE Invoke-GHRestMethod -UriFragment "applications/0ABCDEF12345/submissions/1234567890123456789/" -Method Delete -Description "Delete Submission" -NoStatus Deletes the specified submission, but the request happens in the foreground and there is no additional status shown to the user until a response is returned from the REST request. .NOTES This wraps Invoke-WebRequest as opposed to Invoke-RestMethod because we want access to the headers that are returned in the response (specifically 'MS-ClientRequestId') for logging purposes, and Invoke-RestMethod drops those headers. #> [CmdletBinding(SupportsShouldProcess)] param( [Parameter(Mandatory)] [string] $UriFragment, [Parameter(Mandatory)] [ValidateSet('Delete', 'Get', 'Post', 'Patch', 'Put')] [string] $Method, [string] $Description, [string] $Body = $null, [string] $AcceptHeader = $script:defaultAcceptHeader, [switch] $ExtendedResult, [string] $AccessToken, [string] $TelemetryEventName = $null, [hashtable] $TelemetryProperties = @{}, [string] $TelemetryExceptionBucket = $null, [switch] $NoStatus ) Invoke-UpdateCheck # Normalize our Uri fragment. It might be coming from a method implemented here, or it might # be coming from the Location header in a previous response. Either way, we don't want there # to be a leading "/" or trailing '/' if ($UriFragment.StartsWith('/')) { $UriFragment = $UriFragment.Substring(1) } if ($UriFragment.EndsWith('/')) { $UriFragment = $UriFragment.Substring(0, $UriFragment.Length - 1) } if ([String]::IsNullOrEmpty($Description)) { $Description = "Executing: $UriFragment" } # Telemetry-related $stopwatch = New-Object -TypeName System.Diagnostics.Stopwatch $localTelemetryProperties = @{ 'UriFragment' = $UriFragment 'WaitForCompletion' = ($WaitForCompletion -eq $true) } $TelemetryProperties.Keys | ForEach-Object { $localTelemetryProperties[$_] = $TelemetryProperties[$_] } $errorBucket = $TelemetryExceptionBucket if ([String]::IsNullOrEmpty($errorBucket)) { $errorBucket = $TelemetryEventName } # Since we have retry logic, we won't create a new stopwatch every time, # we'll just always continue the existing one... $stopwatch.Start() $hostName = $(Get-GitHubConfiguration -Name "ApiHostName") if ($hostName -eq 'github.com') { $url = "https://api.$hostName/$UriFragment" } else { $url = "https://$hostName/api/v3/$UriFragment" } # It's possible that we are directly calling the "nextLink" from a previous command which # provides the full URI. If that's the case, we'll just use exactly what was provided to us. if ($UriFragment.StartsWith('http')) { $url = $UriFragment } $headers = @{ 'Accept' = $AcceptHeader 'User-Agent' = 'PowerShellForGitHub' } $AccessToken = Get-AccessToken -AccessToken $AccessToken if (-not [String]::IsNullOrEmpty($AccessToken)) { $headers['Authorization'] = "token $AccessToken" } if ($Method -in $ValidBodyContainingRequestMethods) { $headers.Add("Content-Type", "application/json; charset=UTF-8") } try { Write-Log -Message $Description -Level Verbose Write-Log -Message "Accessing [$Method] $url [Timeout = $(Get-GitHubConfiguration -Name WebRequestTimeoutSec))]" -Level Verbose $NoStatus = Resolve-ParameterWithDefaultConfigurationValue -Name NoStatus -ConfigValueName DefaultNoStatus if ($NoStatus) { if ($PSCmdlet.ShouldProcess($url, "Invoke-WebRequest")) { $params = @{} $params.Add("Uri", $url) $params.Add("Method", $Method) $params.Add("Headers", $headers) $params.Add("UseDefaultCredentials", $true) $params.Add("UseBasicParsing", $true) $params.Add("TimeoutSec", (Get-GitHubConfiguration -Name WebRequestTimeoutSec)) if ($Method -in $ValidBodyContainingRequestMethods -and (-not [String]::IsNullOrEmpty($Body))) { $bodyAsBytes = [System.Text.Encoding]::UTF8.GetBytes($Body) $params.Add("Body", $bodyAsBytes) Write-Log -Message "Request includes a body." -Level Verbose if (Get-GitHubConfiguration -Name LogRequestBody) { Write-Log -Message $Body -Level Verbose } } [Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12 $result = Invoke-WebRequest @params if ($Method -eq 'Delete') { Write-Log -Message "Successfully removed." -Level Verbose } } } else { $jobName = "Invoke-GHRestMethod-" + (Get-Date).ToFileTime().ToString() if ($PSCmdlet.ShouldProcess($jobName, "Start-Job")) { [scriptblock]$scriptBlock = { param($Url, $Method, $Headers, $Body, $ValidBodyContainingRequestMethods, $TimeoutSec, $LogRequestBody, $ScriptRootPath) # We need to "dot invoke" Helpers.ps1 and GitHubConfiguration.ps1 within # the context of this script block since we're running in a different # PowerShell process and need access to Get-HttpWebResponseContent and # config values referenced within Write-Log. . (Join-Path -Path $ScriptRootPath -ChildPath 'Helpers.ps1') . (Join-Path -Path $ScriptRootPath -ChildPath 'GitHubConfiguration.ps1') $params = @{} $params.Add("Uri", $Url) $params.Add("Method", $Method) $params.Add("Headers", $Headers) $params.Add("UseDefaultCredentials", $true) $params.Add("UseBasicParsing", $true) $params.Add("TimeoutSec", $TimeoutSec) if ($Method -in $ValidBodyContainingRequestMethods -and (-not [String]::IsNullOrEmpty($Body))) { $bodyAsBytes = [System.Text.Encoding]::UTF8.GetBytes($Body) $params.Add("Body", $bodyAsBytes) Write-Log -Message "Request includes a body." -Level Verbose if ($LogRequestBody) { Write-Log -Message $Body -Level Verbose } } try { [Net.ServicePointManager]::SecurityProtocol=[Net.SecurityProtocolType]::Tls12 Invoke-WebRequest @params } catch [System.Net.WebException] { # We need to access certain headers in the exception handling, # but the actual *values* of the headers of a WebException don't get serialized # when the RemoteException wraps it. To work around that, we'll extract the # information that we actually care about *now*, and then we'll throw our own exception # that is just a JSON object with the data that we'll later extract for processing in # the main catch. $ex = @{} $ex.Message = $_.Exception.Message $ex.StatusCode = $_.Exception.Response.StatusCode $ex.StatusDescription = $_.Exception.Response.StatusDescription $ex.InnerMessage = $_.ErrorDetails.Message try { $ex.RawContent = Get-HttpWebResponseContent -WebResponse $_.Exception.Response } catch { Write-Log -Message "Unable to retrieve the raw HTTP Web Response:" -Exception $_ -Level Warning } throw (ConvertTo-Json -InputObject $ex -Depth 20) } } $null = Start-Job -Name $jobName -ScriptBlock $scriptBlock -Arg @( $url, $Method, $headers, $Body, $ValidBodyContainingRequestMethods, (Get-GitHubConfiguration -Name WebRequestTimeoutSec), (Get-GitHubConfiguration -Name LogRequestBody), $PSScriptRoot) if ($PSCmdlet.ShouldProcess($jobName, "Wait-JobWithAnimation")) { Wait-JobWithAnimation -Name $jobName -Description $Description } if ($PSCmdlet.ShouldProcess($jobName, "Receive-Job")) { $result = Receive-Job $jobName -AutoRemoveJob -Wait -ErrorAction SilentlyContinue -ErrorVariable remoteErrors } } if ($remoteErrors.Count -gt 0) { throw $remoteErrors[0].Exception } if ($Method -eq 'Delete') { Write-Log -Message "Successfully removed." -Level Verbose } } # Record the telemetry for this event. $stopwatch.Stop() if (-not [String]::IsNullOrEmpty($TelemetryEventName)) { $telemetryMetrics = @{ 'Duration' = $stopwatch.Elapsed.TotalSeconds } Set-TelemetryEvent -EventName $TelemetryEventName -Properties $localTelemetryProperties -Metrics $telemetryMetrics } $finalResult = $result.Content try { $finalResult = $finalResult | ConvertFrom-Json } catch [ArgumentException] { # The content must not be JSON (which is a legitimate situation). We'll return the raw content result instead. # We do this unnecessary assignment to avoid PSScriptAnalyzer's PSAvoidUsingEmptyCatchBlock. $finalResult = $finalResult } if (-not (Get-GitHubConfiguration -Name DisableSmarterObjects)) { $finalResult = ConvertTo-SmarterObject -InputObject $finalResult } $links = $result.Headers['Link'] -split ',' $nextLink = $null foreach ($link in $links) { if ($link -match '<(.*)>; rel="next"') { $nextLink = $matches[1] } } $resultNotReadyStatusCode = 202 if ($result.StatusCode -eq $resultNotReadyStatusCode) { $retryDelaySeconds = Get-GitHubConfiguration -Name RetryDelaySeconds if ($Method -ne 'Get') { # We only want to do our retry logic for GET requests... # We don't want to repeat PUT/PATCH/POST/DELETE. Write-Log -Message "The server has indicated that the result is not yet ready (received status code of [$($result.StatusCode)])." -Level Warning } elseif ($retryDelaySeconds -le 0) { Write-Log -Message "The server has indicated that the result is not yet ready (received status code of [$($result.StatusCode)]), however the module is currently configured to not retry in this scenario (RetryDelaySeconds is set to 0). Please try this command again later." -Level Warning } else { Write-Log -Message "The server has indicated that the result is not yet ready (received status code of [$($result.StatusCode)]). Will retry in [$retryDelaySeconds] seconds." -Level Warning Start-Sleep -Seconds ($retryDelaySeconds) return (Invoke-GHRestMethod @PSBoundParameters) } } if ($ExtendedResult) { $finalResultEx = @{ 'result' = $finalResult 'statusCode' = $result.StatusCode 'requestId' = $result.Headers['X-GitHub-Request-Id'] 'nextLink' = $nextLink 'link' = $result.Headers['Link'] 'lastModified' = $result.Headers['Last-Modified'] 'ifNoneMatch' = $result.Headers['If-None-Match'] 'ifModifiedSince' = $result.Headers['If-Modified-Since'] 'eTag' = $result.Headers['ETag'] 'rateLimit' = $result.Headers['X-RateLimit-Limit'] 'rateLimitRemaining' = $result.Headers['X-RateLimit-Remaining'] 'rateLimitReset' = $result.Headers['X-RateLimit-Reset'] } return ([PSCustomObject] $finalResultEx) } else { return $finalResult } } catch { # We only know how to handle WebExceptions, which will either come in "pure" when running with -NoStatus, # or will come in as a RemoteException when running normally (since it's coming from the asynchronous Job). $ex = $null $message = $null $statusCode = $null $statusDescription = $null $requestId = $null $innerMessage = $null $rawContent = $null if ($_.Exception -is [System.Net.WebException]) { $ex = $_.Exception $message = $_.Exception.Message $statusCode = $ex.Response.StatusCode.value__ # Note that value__ is not a typo. $statusDescription = $ex.Response.StatusDescription $innerMessage = $_.ErrorDetails.Message try { $rawContent = Get-HttpWebResponseContent -WebResponse $ex.Response } catch { Write-Log -Message "Unable to retrieve the raw HTTP Web Response:" -Exception $_ -Level Warning } if ($ex.Response.Headers.Count -gt 0) { $requestId = $ex.Response.Headers['X-GitHub-Request-Id'] } } elseif (($_.Exception -is [System.Management.Automation.RemoteException]) -and ($_.Exception.SerializedRemoteException.PSObject.TypeNames[0] -eq 'Deserialized.System.Management.Automation.RuntimeException')) { $ex = $_.Exception try { $deserialized = $ex.Message | ConvertFrom-Json $message = $deserialized.Message $statusCode = $deserialized.StatusCode $statusDescription = $deserialized.StatusDescription $innerMessage = $deserialized.InnerMessage $requestId = $deserialized['X-GitHub-Request-Id'] $rawContent = $deserialized.RawContent } catch [System.ArgumentException] { # Will be thrown if $ex.Message isn't JSON content Write-Log -Exception $_ -Level Error Set-TelemetryException -Exception $ex -ErrorBucket $errorBucket -Properties $localTelemetryProperties throw } } else { Write-Log -Exception $_ -Level Error Set-TelemetryException -Exception $_.Exception -ErrorBucket $errorBucket -Properties $localTelemetryProperties throw } $output = @() $output += $message if (-not [string]::IsNullOrEmpty($statusCode)) { $output += "$statusCode | $($statusDescription.Trim())" } if (-not [string]::IsNullOrEmpty($innerMessage)) { try { $innerMessageJson = ($innerMessage | ConvertFrom-Json) if ($innerMessageJson -is [String]) { $output += $innerMessageJson.Trim() } elseif (-not [String]::IsNullOrWhiteSpace($innerMessageJson.message)) { $output += "$($innerMessageJson.message.Trim()) | $($innerMessageJson.documentation_url.Trim())" if ($innerMessageJson.details) { $output += "$($innerMessageJson.details | Format-Table | Out-String)" } } else { # In this case, it's probably not a normal message from the API $output += ($innerMessageJson | Out-String) } } catch [System.ArgumentException] { # Will be thrown if $innerMessage isn't JSON content $output += $innerMessage.Trim() } } # It's possible that the API returned JSON content in its error response. if (-not [String]::IsNullOrWhiteSpace($rawContent)) { $output += $rawContent } if ($statusCode -eq 404) { $output += "This typically happens when the current user isn't properly authenticated. You may need an Access Token with additional scopes checked." } if (-not [String]::IsNullOrEmpty($requestId)) { $localTelemetryProperties['RequestId'] = $requestId $message = 'RequestId: ' + $requestId $output += $message Write-Log -Message $message -Level Verbose } $newLineOutput = ($output -join [Environment]::NewLine) Write-Log -Message $newLineOutput -Level Error Set-TelemetryException -Exception $ex -ErrorBucket $errorBucket -Properties $localTelemetryProperties throw $newLineOutput } } function Invoke-GHRestMethodMultipleResult { <# .SYNOPSIS A special-case wrapper around Invoke-GHRestMethod that understands GET URI's which support the 'top' and 'max' parameters. .DESCRIPTION A special-case wrapper around Invoke-GHRestMethod that understands GET URI's which support the 'top' and 'max' parameters. The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub .PARAMETER UriFragment The unique, tail-end, of the REST URI that indicates what Store REST action will be performed. This should *not* include the 'top' and 'max' parameters. These will be automatically added as needed. .PARAMETER Description A friendly description of the operation being performed for logging and console display purposes. .PARAMETER AcceptHeader Specify the media type in the Accept header. Different types of commands may require different media types. .PARAMETER AccessToken If provided, this will be used as the AccessToken for authentication with the REST Api as opposed to requesting a new one. .PARAMETER TelemetryEventName If provided, the successful execution of this REST command will be logged to telemetry using this event name. .PARAMETER TelemetryProperties If provided, the successful execution of this REST command will be logged to telemetry with these additional properties. This will be silently ignored if TelemetryEventName is not provided as well. .PARAMETER TelemetryExceptionBucket If provided, any exception that occurs will be logged to telemetry using this bucket. It's possible that users will wish to log exceptions but not success (by providing TelemetryEventName) if this is being executed as part of a larger scenario. If this isn't provided, but TelemetryEventName *is* provided, then TelemetryEventName will be used as the exception bucket value in the event of an exception. If neither is specified, no bucket value will be used. .PARAMETER SinglePage By default, this function will automatically call any follow-up "nextLinks" provided by the return value in order to retrieve the entire result set. If this switch is provided, only the first "page" of results will be retrieved, and the "nextLink" links will not be followed. WARNING: This might take a while depending on how many results there are. .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. .OUTPUTS [PSCustomObject[]] - The result of the REST operation, in whatever form it comes in. .EXAMPLE Invoke-GHRestMethodMultipleResult -UriFragment "repos/PowerShell/PowerShellForGitHub/issues?state=all" -Description "Get all issues" Gets the first set of issues associated with this project, with the console window showing progress while awaiting the response from the REST request. .EXAMPLE Invoke-GHRestMethodMultipleResult -UriFragment "repos/PowerShell/PowerShellForGitHub/issues?state=all" -Description "Get all issues" -NoStatus Gets the first set of issues associated with this project, but the request happens in the foreground and there is no additional status shown to the user until a response is returned from the REST request. #> [CmdletBinding(SupportsShouldProcess)] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSReviewUnusedParameter", "", Justification="One or more parameters (like NoStatus) are only referenced by helper methods which get access to it from the stack via Get-Variable -Scope 1.")] [OutputType([Object[]])] param( [Parameter(Mandatory)] [string] $UriFragment, [Parameter(Mandatory)] [string] $Description, [string] $AcceptHeader = $script:defaultAcceptHeader, [string] $AccessToken, [string] $TelemetryEventName = $null, [hashtable] $TelemetryProperties = @{}, [string] $TelemetryExceptionBucket = $null, [switch] $SinglePage, [switch] $NoStatus ) $AccessToken = Get-AccessToken -AccessToken $AccessToken $stopwatch = [System.Diagnostics.Stopwatch]::StartNew() $errorBucket = $TelemetryExceptionBucket if ([String]::IsNullOrEmpty($errorBucket)) { $errorBucket = $TelemetryEventName } $finalResult = @() $currentDescription = $Description $nextLink = $UriFragment try { do { $params = @{ 'UriFragment' = $nextLink 'Method' = 'Get' 'Description' = $currentDescription 'AcceptHeader' = $AcceptHeader 'ExtendedResult' = $true 'AccessToken' = $AccessToken 'TelemetryProperties' = $telemetryProperties 'TelemetryExceptionBucket' = $errorBucket 'NoStatus' = (Resolve-ParameterWithDefaultConfigurationValue -Name NoStatus -ConfigValueName DefaultNoStatus) } $result = Invoke-GHRestMethod @params if ($null -ne $result.result) { $finalResult += $result.result } $nextLink = $result.nextLink $currentDescription = "$Description (getting additional results)" } until ($SinglePage -or ([String]::IsNullOrWhiteSpace($nextLink))) # Record the telemetry for this event. $stopwatch.Stop() if (-not [String]::IsNullOrEmpty($TelemetryEventName)) { $telemetryMetrics = @{ 'Duration' = $stopwatch.Elapsed.TotalSeconds } Set-TelemetryEvent -EventName $TelemetryEventName -Properties $TelemetryProperties -Metrics $telemetryMetrics } return $finalResult } catch { throw } } function Split-GitHubUri { <# .SYNOPSIS Extracts the relevant elements of a GitHub repository Uri and returns the requested element. .DESCRIPTION Extracts the relevant elements of a GitHub repository Uri and returns the requested element. Currently supports retrieving the OwnerName and the RepositoryName, when available. The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub .PARAMETER Uri The GitHub repository Uri whose components should be returned. .PARAMETER OwnerName Returns the Owner Name from the Uri if it can be identified. .PARAMETER RepositoryName Returns the Repository Name from the Uri if it can be identified. .OUTPUTS [PSCustomObject] - The OwnerName and RepositoryName elements from the provided URL .EXAMPLE Split-GitHubUri -Uri 'https://github.com/PowerShell/PowerShellForGitHub' PowerShellForGitHub .EXAMPLE Split-GitHubUri -Uri 'https://github.com/PowerShell/PowerShellForGitHub' -RepositoryName PowerShellForGitHub .EXAMPLE Split-GitHubUri -Uri 'https://github.com/PowerShell/PowerShellForGitHub' -OwnerName PowerShell #> [CmdletBinding(DefaultParameterSetName='RepositoryName')] param ( [Parameter(Mandatory)] [ValidateNotNullOrEmpty()] [string] $Uri, [Parameter(ParameterSetName='OwnerName')] [switch] $OwnerName, [Parameter(ParameterSetName='RepositoryName')] [switch] $RepositoryName ) $components = @{ ownerName = [String]::Empty repositoryName = [String]::Empty } $hostName = $(Get-GitHubConfiguration -Name "ApiHostName") if (($Uri -match "^https?://(?:www.)?$hostName/([^/]+)/?([^/]+)?(?:/.*)?$") -or ($Uri -match "^https?://api.$hostName/repos/([^/]+)/?([^/]+)?(?:/.*)?$")) { $components.ownerName = $Matches[1] if ($Matches.Count -gt 2) { $components.repositoryName = $Matches[2] } } if ($OwnerName) { return $components.ownerName } elseif ($RepositoryName -or ($PSCmdlet.ParameterSetName -eq 'RepositoryName')) { return $components.repositoryName } } function Resolve-RepositoryElements { <# .SYNOPSIS Determines the OwnerName and RepositoryName from the possible parameter values. .DESCRIPTION Determines the OwnerName and RepositoryName from the possible parameter values. The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub .PARAMETER BoundParameters The inbound parameters from the calling method. This is expecting values that may include 'Uri', 'OwnerName' and 'RepositoryName' No need to explicitly provide this if you're using the PSBoundParameters from the function that is calling this directly. .PARAMETER DisableValidation By default, this function ensures that it returns with all elements provided, otherwise an exception is thrown. If this is specified, that validation will not occur, and it's possible to receive a result where one or more elements have no value. .OUTPUTS [PSCustomObject] - The OwnerName and RepositoryName elements to be used #> [CmdletBinding(SupportsShouldProcess)] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSShouldProcess", "", Justification="Methods called within here make use of PSShouldProcess, and the switch is passed on to them inherently.")] [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseSingularNouns", "", Justification="This was the most accurate name that I could come up with. Internal only anyway.")] param ( $BoundParameters = (Get-Variable -Name PSBoundParameters -Scope 1 -ValueOnly), [switch] $DisableValidation ) $validate = -not $DisableValidation $elements = @{} if ($BoundParameters.ContainsKey('Uri') -and ($BoundParameters.ContainsKey('OwnerName') -or $BoundParameters.ContainsKey('RepositoryName'))) { $message = "Cannot specify a Uri AND individual OwnerName/RepositoryName. Please choose one or the other." Write-Log -Message $message -Level Error throw $message } if ($BoundParameters.ContainsKey('Uri')) { $elements.ownerName = Split-GitHubUri -Uri $BoundParameters.Uri -OwnerName if ($validate -and [String]::IsNullOrEmpty($elements.ownerName)) { $message = "Provided Uri does not contain enough information: Owner Name." Write-Log -Message $message -Level Error throw $message } $elements.repositoryName = Split-GitHubUri -Uri $BoundParameters.Uri -RepositoryName if ($validate -and [String]::IsNullOrEmpty($elements.repositoryName)) { $message = "Provided Uri does not contain enough information: Repository Name." Write-Log -Message $message -Level Error throw $message } } else { $elements.ownerName = Resolve-ParameterWithDefaultConfigurationValue -BoundParameters $BoundParameters -Name OwnerName -ConfigValueName DefaultOwnerName -NonEmptyStringRequired:$validate $elements.repositoryName = Resolve-ParameterWithDefaultConfigurationValue -BoundParameters $BoundParameters -Name RepositoryName -ConfigValueName DefaultRepositoryName -NonEmptyStringRequired:$validate } return ([PSCustomObject] $elements) } # The list of property names across all of GitHub API v3 that are known to store dates as strings. $script:datePropertyNames = @( 'closed_at', 'committed_at', 'completed_at', 'created_at', 'date', 'due_on', 'last_edited_at', 'last_read_at', 'merged_at', 'published_at', 'pushed_at', 'starred_at', 'started_at', 'submitted_at', 'timestamp', 'updated_at' ) filter ConvertTo-SmarterObject { <# .SYNOPSIS Updates the properties of the input object to be object themselves when the conversion is possible. .DESCRIPTION Updates the properties of the input object to be object themselves when the conversion is possible. At present, this only attempts to convert properties known to store dates as strings into storing them as DateTime objects instead. .PARAMETER InputObject The object to update #> [CmdletBinding()] param( [Parameter( Mandatory, ValueFromPipeline, ValueFromPipelineByPropertyName)] [AllowNull()] [object] $InputObject ) if ($null -eq $InputObject) { return $null } if ($InputObject -is [System.Collections.IList]) { $InputObject | ConvertTo-SmarterObject | Write-Output } elseif ($InputObject -is [PSCustomObject]) { $clone = DeepCopy-Object -InputObject $InputObject $properties = $clone.PSObject.Properties | Where-Object { $null -ne $_.Value } foreach ($property in $properties) { # Convert known date properties from dates to real DateTime objects if (($property.Name -in $script:datePropertyNames) -and ($property.Value -is [String]) -and (-not [String]::IsNullOrWhiteSpace($property.Value))) { try { $property.Value = Get-Date -Date $property.Value } catch { Write-Log -Message "Unable to convert $($property.Name) value of $($property.Value) to a [DateTime] object. Leaving as-is." -Level Verbose } } if ($property.Value -is [System.Collections.IList]) { $property.Value = @(ConvertTo-SmarterObject -InputObject $property.Value) } elseif ($property.Value -is [PSCustomObject]) { $property.Value = ConvertTo-SmarterObject -InputObject $property.Value } } Write-Output -InputObject $clone } else { Write-Output -InputObject $InputObject } } function Get-MediaAcceptHeader { <# .DESCRIPTION Returns a formatted AcceptHeader based on the requested MediaType The Git repo for this module can be found here: http://aka.ms/PowerShellForGitHub .PARAMETER MediaType The format in which the API will return the body of the comment or issue. Raw - Return the raw markdown body. Response will include body. This is the default if you do not pass any specific media type. Text - Return a text only representation of the markdown body. Response will include body_text. Html - Return HTML rendered from the body's markdown. Response will include body_html. Full - Return raw, text and HTML representations. Response will include body, body_text, and body_html. Object - Return a json object representation a file or folder. .PARAMETER AsJson If this switch is specified as +json value is appended to the MediaType header. .PARAMETER AcceptHeader The accept header that should be included with the MediaType accept header. .EXAMPLE Get-MediaAcceptHeader -MediaType Raw Returns a formatted AcceptHeader for v3 of the response object #> [CmdletBinding()] param( [ValidateSet('Raw', 'Text', 'Html', 'Full', 'Object')] [string] $MediaType = 'Raw', [switch] $AsJson, [string] $AcceptHeader ) $resultHeaders = "application/vnd.github.$mediaTypeVersion.$($MediaType.ToLower())" if ($AsJson) { $resultHeaders = $resultHeaders + "+json" } if (-not [String]::IsNullOrEmpty($AcceptHeader)) { $resultHeaders = "$AcceptHeader,$resultHeaders" } return $resultHeaders } # SIG # Begin signature block # MIIjigYJKoZIhvcNAQcCoIIjezCCI3cCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAObj21JWCaqGoy # Qw94zg8Q/djSZtr9wV6++vOExxrjE6CCDYUwggYDMIID66ADAgECAhMzAAABiK9S # 1rmSbej5AAAAAAGIMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p # bmcgUENBIDIwMTEwHhcNMjAwMzA0MTgzOTQ4WhcNMjEwMzAzMTgzOTQ4WjB0MQsw # CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u # ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB # AQCSCNryE+Cewy2m4t/a74wZ7C9YTwv1PyC4BvM/kSWPNs8n0RTe+FvYfU+E9uf0 # t7nYlAzHjK+plif2BhD+NgdhIUQ8sVwWO39tjvQRHjP2//vSvIfmmkRoML1Ihnjs # 9kQiZQzYRDYYRp9xSQYmRwQjk5hl8/U7RgOiQDitVHaU7BT1MI92lfZRuIIDDYBd # vXtbclYJMVOwqZtv0O9zQCret6R+fRSGaDNfEEpcILL+D7RV3M4uaJE4Ta6KAOdv # V+MVaJp1YXFTZPKtpjHO6d9pHQPZiG7NdC6QbnRGmsa48uNQrb6AfmLKDI1Lp31W # MogTaX5tZf+CZT9PSuvjOCLNAgMBAAGjggGCMIIBfjAfBgNVHSUEGDAWBgorBgEE # AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQUj9RJL9zNrPcL10RZdMQIXZN7MG8w # VAYDVR0RBE0wS6RJMEcxLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh # dGlvbnMgTGltaXRlZDEWMBQGA1UEBRMNMjMwMDEyKzQ1ODM4NjAfBgNVHSMEGDAW # gBRIbmTlUAXTgqoXNzcitW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8v # d3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIw # MTEtMDctMDguY3JsMGEGCCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDov # L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDEx # XzIwMTEtMDctMDguY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIB # ACnXo8hjp7FeT+H6iQlV3CcGnkSbFvIpKYafgzYCFo3UHY1VHYJVb5jHEO8oG26Q # qBELmak6MTI+ra3WKMTGhE1sEIlowTcp4IAs8a5wpCh6Vf4Z/bAtIppP3p3gXk2X # 8UXTc+WxjQYsDkFiSzo/OBa5hkdW1g4EpO43l9mjToBdqEPtIXsZ7Hi1/6y4gK0P # mMiwG8LMpSn0n/oSHGjrUNBgHJPxgs63Slf58QGBznuXiRaXmfTUDdrvhRocdxIM # i8nXQwWACMiQzJSRzBP5S2wUq7nMAqjaTbeXhJqD2SFVHdUYlKruvtPSwbnqSRWT # GI8s4FEXt+TL3w5JnwVZmZkUFoioQDMMjFyaKurdJ6pnzbr1h6QW0R97fWc8xEIz # LIOiU2rjwWAtlQqFO8KNiykjYGyEf5LyAJKAO+rJd9fsYR+VBauIEQoYmjnUbTXM # SY2Lf5KMluWlDOGVh8q6XjmBccpaT+8tCfxpaVYPi1ncnwTwaPQvVq8RjWDRB7Pa # 8ruHgj2HJFi69+hcq7mWx5nTUtzzFa7RSZfE5a1a5AuBmGNRr7f8cNfa01+tiWjV # Kk1a+gJUBSP0sIxecFbVSXTZ7bqeal45XSDIisZBkWb+83TbXdTGMDSUFKTAdtC+ # r35GfsN8QVy59Hb5ZYzAXczhgRmk7NyE6jD0Ym5TKiW5MIIHejCCBWKgAwIBAgIK # YQ6Q0gAAAAAAAzANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNV # BAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jv # c29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlm # aWNhdGUgQXV0aG9yaXR5IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEw # OTA5WjB+MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYD # VQQDEx9NaWNyb3NvZnQgQ29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG # 9w0BAQEFAAOCAg8AMIICCgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+la # UKq4BjgaBEm6f8MMHt03a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc # 6Whe0t+bU7IKLMOv2akrrnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4D # dato88tt8zpcoRb0RrrgOGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+ # lD3v++MrWhAfTVYoonpy4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nk # kDstrjNYxbc+/jLTswM9sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6 # A4aN91/w0FK/jJSHvMAhdCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmd # X4jiJV3TIUs+UsS1Vz8kA/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL # 5zmhD+kjSbwYuER8ReTBw3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zd # sGbiwZeBe+3W7UvnSSmnEyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3 # T8HhhUSJxAlMxdSlQy90lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS # 4NaIjAsCAwEAAaOCAe0wggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRI # bmTlUAXTgqoXNzcitW2oynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTAL # BgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBD # uRQFTuHqp8cx0SOJNDBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jv # c29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf # MDNfMjIuY3JsMF4GCCsGAQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3 # dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFf # MDNfMjIuY3J0MIGfBgNVHSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEF # BQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1h # cnljcHMuaHRtMEAGCCsGAQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkA # YwB5AF8AcwB0AGEAdABlAG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn # 8oalmOBUeRou09h0ZyKbC5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7 # v0epo/Np22O/IjWll11lhJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0b # pdS1HXeUOeLpZMlEPXh6I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/ # KmtYSWMfCWluWpiW5IP0wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvy # CInWH8MyGOLwxS3OW560STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBp # mLJZiWhub6e3dMNABQamASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJi # hsMdYzaXht/a8/jyFqGaJ+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYb # BL7fQccOKO7eZS/sl/ahXJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbS # oqKfenoi+kiVH6v7RyOA9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sL # gOppO6/8MO0ETI7f33VtY5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtX # cVZOSEXAQsmbdlsKgEhr/Xmfwb1tbWrJUnMTDXpQzTGCFVswghVXAgEBMIGVMH4x # CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt # b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01p # Y3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMTECEzMAAAGIr1LWuZJt6PkAAAAA # AYgwDQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQw # HAYKKwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIAXJ # Dv7m/lOC13AAz+m0arbpESfOrSsrFp6Ik456iWlKMEIGCisGAQQBgjcCAQwxNDAy # oBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5j # b20wDQYJKoZIhvcNAQEBBQAEggEACI28vdKbQrNj16I1ue6NBwPDLrSJzTLJ/swI # 6lYDFR95EFgSgYQMoQIvPWwnbp7vqkQ3yLkzs4+vc+g9utcxlOp8qkSC2gwbcVhb # yGWrjhYt6HkMcOmuoNA1sNTExAlEm62kGKIFAP726R3HWnY1/IWm46v8nB/+vv2V # /7ZCtOmiJ417R32Tb+eqfdjYjwfIptP50Zir1NhP0FEO5U6U5Es9g1zKB/cZKnw0 # KdTZeK1I1an9aQF1KJZb9HjtO8lzoGkTCOk0RQ8/9YfTkdaSd39cLXGgpSwJeFyD # UUoD6y0dHHaHq3/5A7RgO8BKrzBqRdPKLytaEJeKXzBX4CX0JqGCEuUwghLhBgor # BgEEAYI3AwMBMYIS0TCCEs0GCSqGSIb3DQEHAqCCEr4wghK6AgEDMQ8wDQYJYIZI # AWUDBAIBBQAwggFRBgsqhkiG9w0BCRABBKCCAUAEggE8MIIBOAIBAQYKKwYBBAGE # WQoDATAxMA0GCWCGSAFlAwQCAQUABCCRhCm+pniuN6YK9ktknTkWmfRbIWtXbNbE # zu401JrFpgIGXqxBYl5CGBMyMDIwMDUzMTA3MjAwNi4zODFaMASAAgH0oIHQpIHN # MIHKMQswCQYDVQQGEwJVUzELMAkGA1UECBMCV0ExEDAOBgNVBAcTB1JlZG1vbmQx # HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9z # b2Z0IElyZWxhbmQgT3BlcmF0aW9ucyBMaW1pdGVkMSYwJAYDVQQLEx1UaGFsZXMg # VFNTIEVTTjo4RDQxLTRCRjctQjNCNzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUt # U3RhbXAgU2VydmljZaCCDjwwggTxMIID2aADAgECAhMzAAABClLIOQFS0XBLAAAA # AAEKMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo # aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y # cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw # MB4XDTE5MTAyMzIzMTkxNVoXDTIxMDEyMTIzMTkxNVowgcoxCzAJBgNVBAYTAlVT # MQswCQYDVQQIEwJXQTEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z # b2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVy # YXRpb25zIExpbWl0ZWQxJjAkBgNVBAsTHVRoYWxlcyBUU1MgRVNOOjhENDEtNEJG # Ny1CM0I3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIIB # IjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAuz4brZShcMWfhnj1P1dKTJHt # teR0l/D3C19YY2FG8ghEQRbO/8BMK28DCGXTqOzQ6nCFIV17d5MYNTqgScbqM1XA # ifCcEcv1SO/adWXi20r92jDMaLjs6KmjS/w5m/Ak/VBHKqtzxdfLzL9XGX5PGaYb # lUhjzNHlrCbxNZHz1wibGM7Gbbq6tIxCOlwYfYabikKvCkl76KghN+xGVq2Fst7o # USZ7K3eE6tmIGLMlkP2kBdtHW+92VsCLVxuE1JcuCENKXEIvf1B937FbtOqvP8jb # 3OzHyHJp2DlDzshTAYdBFudfSv5oP8WIDIbZmZZ85rx56+Z6cyU4sGwboZ8FJwID # AQABo4IBGzCCARcwHQYDVR0OBBYEFPhElKX9OkxNUN6R+DqtAaKRcYUoMB8GA1Ud # IwQYMBaAFNVjOlyKMZDzQ3t8RhvFM2hahW1VMFYGA1UdHwRPME0wS6BJoEeGRWh0 # dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1RpbVN0 # YVBDQV8yMDEwLTA3LTAxLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKG # Pmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljVGltU3RhUENB # XzIwMTAtMDctMDEuY3J0MAwGA1UdEwEB/wQCMAAwEwYDVR0lBAwwCgYIKwYBBQUH # AwgwDQYJKoZIhvcNAQELBQADggEBAFSXrnzUFfLd03MlqtErt51WGX3UXFeorE6d # GY+YIwSmfFRKRNwEe8cmLt0EOxezyTV6+/fdYTyrPcPDvgR3k6F5sHeKExohjrqc # jxAa3yVQ9SJZakXZVKzaHWzbvMuA8kcmzj0J/Y6/pk57aFsp/kr+lu5aNdw5V3Wg # itJYpwE6foZQsBrTTPNRhIXVMHnPEk6s2+7nC6Ty9ZLIJhYeMyqLuitJGKvEiRhD # 8PYzkGJnLkjp61ICDk/00ZVZvvlXLonth32ZooeZ9/+760o9g2lUhF8oaLHCB1i8 # 2dUChXdzZulUEwQ5CZWh8WIjQZSUuvOO1vV0FfOqdNwcDyXuFdIwggZxMIIEWaAD # AgECAgphCYEqAAAAAAACMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzET # MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV # TWljcm9zb2Z0IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBD # ZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAxMDAeFw0xMDA3MDEyMTM2NTVaFw0yNTA3 # MDEyMTQ2NTVaMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIIBIjANBgkq # hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAqR0NvHcRijog7PwTl/X6f2mUa3RUENWl # CgCChfvtfGhLLF/Fw+Vhwna3PmYrW/AVUycEMR9BGxqVHc4JE458YTBZsTBED/Fg # iIRUQwzXTbg4CLNC3ZOs1nMwVyaCo0UN0Or1R4HNvyRgMlhgRvJYR4YyhB50YWeR # X4FUsc+TTJLBxKZd0WETbijGGvmGgLvfYfxGwScdJGcSchohiq9LZIlQYrFd/Xcf # PfBXday9ikJNQFHRD5wGPmd/9WbAA5ZEfu/QS/1u5ZrKsajyeioKMfDaTgaRtogI # Neh4HLDpmc085y9Euqf03GS9pAHBIAmTeM38vMDJRF1eFpwBBU8iTQIDAQABo4IB # 5jCCAeIwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFNVjOlyKMZDzQ3t8RhvF # M2hahW1VMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMAsGA1UdDwQEAwIBhjAP # BgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP6KJcYmjRPZSQW9fOmhjE # MFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kv # Y3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNybDBaBggrBgEF # BQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9w # a2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3J0MIGgBgNVHSABAf8E # gZUwgZIwgY8GCSsGAQQBgjcuAzCBgTA9BggrBgEFBQcCARYxaHR0cDovL3d3dy5t # aWNyb3NvZnQuY29tL1BLSS9kb2NzL0NQUy9kZWZhdWx0Lmh0bTBABggrBgEFBQcC # AjA0HjIgHQBMAGUAZwBhAGwAXwBQAG8AbABpAGMAeQBfAFMAdABhAHQAZQBtAGUA # bgB0AC4gHTANBgkqhkiG9w0BAQsFAAOCAgEAB+aIUQ3ixuCYP4FxAz2do6Ehb7Pr # psz1Mb7PBeKp/vpXbRkws8LFZslq3/Xn8Hi9x6ieJeP5vO1rVFcIK1GCRBL7uVOM # zPRgEop2zEBAQZvcXBf/XPleFzWYJFZLdO9CEMivv3/Gf/I3fVo/HPKZeUqRUgCv # OA8X9S95gWXZqbVr5MfO9sp6AG9LMEQkIjzP7QOllo9ZKby2/QThcJ8ySif9Va8v # /rbljjO7Yl+a21dA6fHOmWaQjP9qYn/dxUoLkSbiOewZSnFjnXshbcOco6I8+n99 # lmqQeKZt0uGc+R38ONiU9MalCpaGpL2eGq4EQoO4tYCbIjggtSXlZOz39L9+Y1kl # D3ouOVd2onGqBooPiRa6YacRy5rYDkeagMXQzafQ732D8OE7cQnfXXSYIghh2rBQ # Hm+98eEA3+cxB6STOvdlR3jo+KhIq/fecn5ha293qYHLpwmsObvsxsvYgrRyzR30 # uIUBHoD7G4kqVDmyW9rIDVWZeodzOwjmmC3qjeAzLhIp9cAvVCch98isTtoouLGp # 25ayp0Kiyc8ZQU3ghvkqmqMRZjDTu3QyS99je/WZii8bxyGvWbWu3EQ8l1Bx16HS # xVXjad5XwdHeMMD9zOZN+w2/XU/pnR4ZOC+8z1gFLu8NoFA12u8JJxzVs341Hgi6 # 2jbb01+P3nSISRKhggLOMIICNwIBATCB+KGB0KSBzTCByjELMAkGA1UEBhMCVVMx # CzAJBgNVBAgTAldBMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv # ZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh # dGlvbnMgTGltaXRlZDEmMCQGA1UECxMdVGhhbGVzIFRTUyBFU046OEQ0MS00QkY3 # LUIzQjcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2WiIwoB # ATAHBgUrDgMCGgMVADm9dqVx0X/uUa0VckV24hpoY975oIGDMIGApH4wfDELMAkG # A1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQx # HjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9z # b2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQEFBQACBQDifaOMMCIY # DzIwMjAwNTMxMTEzMTI0WhgPMjAyMDA2MDExMTMxMjRaMHcwPQYKKwYBBAGEWQoE # ATEvMC0wCgIFAOJ9o4wCAQAwCgIBAAICE5UCAf8wBwIBAAICEdQwCgIFAOJ+9QwC # AQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQACAwehIKEK # MAgCAQACAwGGoDANBgkqhkiG9w0BAQUFAAOBgQCA08UnFYdtr415fc5v08ktBevY # XH1cLXJOhSEFozNpMBluFUl7U2Nb8r7TC3QTP5iCkrklmXSrQ4kEvMz0mtONDG6E # +6txwpiXgDcjgtuLfF38KvFKRK3HUN0/yRaGcB9MRJqOa67Jbn9DBV4QYs1GEVA/ # wYicrGAsxReDN/ZAZzGCAw0wggMJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w # IFBDQSAyMDEwAhMzAAABClLIOQFS0XBLAAAAAAEKMA0GCWCGSAFlAwQCAQUAoIIB # SjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIM+i # Pif4zN54opGk+322afkqh3U4RCMbMHE2y4JXWizVMIH6BgsqhkiG9w0BCRACLzGB # 6jCB5zCB5DCBvQQgVwM2JDO6oQwoDehG8V22bUdxzZDWWhkjGB83y+TSrKowgZgw # gYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD # VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAQpSyDkBUtFw # SwAAAAABCjAiBCBWyfdFeWZSaytKBRU8TR2y2fubOSZ/CfTg1C4YghqCNTANBgkq # hkiG9w0BAQsFAASCAQAltNf6CMjCVlIA1Q5XOHD6EfHM+pOHj7crr8c4myqgf7aG # yne0ky1PQtorcOqXVDSVK/NUuftAZLQo09fJAYbVvNux7fGxGDaPxAvSeoLjAdwz # ih2VBlTH3e+MmyrJh9A6JfuxViuhP9ZZrQ/e3BAiSskwjRUK0AHs8wabgdXPE/0L # QYex4EZnnCAeDv55lxBfupUwKmxudoVVIoT6aSIT5BNNmddInikdHVN2GQR8cFwe # Q/ZUfMKaGeZV64qN6XwHbNP8gZC4705LkP2OUqd3kOGsrFMelREGyJ0Cmkv+50WR # rh5VlfFHNU+FE/wQOhAmJJluRXJmDxJKa42Z/zuF # SIG # End signature block |