dbatools

1.1.90

internal/functions/Get-DbaHelp.ps1

                                function Get-DbaHelp {

    <#

    .SYNOPSIS

        Massages inline help data to a more useful format

    .DESCRIPTION

        Takes the inline help and outputs a more usable object

    .PARAMETER Name

        The function/command to extract help from

    .PARAMETER OutputAs

        Output format (raw PSObject or MDString)

    .NOTES

    Author: Simone Bizzotto (@niphlod)

    Website: https://dbatools.io

    Copyright: (c) 2018 by dbatools, licensed under MIT

    License: MIT https://opensource.org/licenses/MIT

    .LINK

        https://dbatools.io/Get-DbaHelp

    .EXAMPLE

        Get-DbaHelp Get-DbaDatabase

        Parses the inline help from Get-DbaDatabase and outputs the massaged object

    .EXAMPLE

        Get-DbaHelp Get-DbaDatabase -OutputAs "PSObject"

        Parses the inline help from Get-DbaDatabase and outputs the massaged object

    .EXAMPLE

        PS C:\> Get-DbaHelp Get-DbaDatabase -OutputAs "MDString" | Out-File Get-DbaDatabase.md

        PS C:\> & code Get-DbaDatabase.md

        Parses the inline help from Get-DbaDatabase as MarkDown, saves the file and opens it

        via VSCode

    #>

    [CmdletBinding()]

    param (

        [parameter(Mandatory)]

        [string]$Name,

        [ValidateSet("PSObject", "MDString")]

        [string]$OutputAs = "PSObject"

    )

    begin {

        function Get-DbaTrimmedString($Text) {

            return $Text.Trim() -replace '(\r\n){2,}', "`n"

        }

        $tagsRex = ([regex]'(?m)^[\s]{0,15}Tags:(.*)$')

        $authorRex = ([regex]'(?m)^[\s]{0,15}Author:(.*)$')

        $minverRex = ([regex]'(?m)^[\s]{0,15}MinimumVersion:(.*)$')

        $maxverRex = ([regex]'(?m)^[\s]{0,15}MaximumVersion:(.*)$')

        $availability = 'Windows, Linux, macOS'

        function Get-DbaDocsMD($doc_to_render) {

            $rtn = New-Object -TypeName "System.Collections.ArrayList"

            $null = $rtn.Add("# $($doc_to_render.CommandName)" )

            if ($doc_to_render.Author -or $doc_to_render.Availability) {

                $null = $rtn.Add('|  |  |')

                $null = $rtn.Add('| - | - |')

                if ($doc_to_render.Author) {

                    $null = $rtn.Add('|  **Author**  | ' + $doc_to_render.Author.replace('|', ',') + ' |')

                }

                if ($doc_to_render.Availability) {

                    $null = $rtn.Add('| **Availability** | ' + $doc_to_render.Availability + ' |')

                }

                $null = $rtn.Add('')

            }

            $null = $rtn.Add("`n" + '&nbsp;' + "`n")

            if ($doc_to_render.Alias) {

                $null = $rtn.Add('')

                $null = $rtn.Add('*Aliases : ' + $doc_to_render.Alias + '*')

                $null = $rtn.Add('')

            }

            $null = $rtn.Add('## Synopsis')

            $null = $rtn.Add($doc_to_render.Synopsis)

            $null = $rtn.Add('')

            $null = $rtn.Add('## Description')

            $null = $rtn.Add($doc_to_render.Description)

            $null = $rtn.Add('')

            if ($doc_to_render.Syntax) {

                $null = $rtn.Add('## Syntax')

                $null = $rtn.Add('```')

                $splitted_paramsets = @()

                foreach ($val in ($doc_to_render.Syntax -split $doc_to_render.CommandName)) {

                    if ($val) {

                        $splitted_paramsets += $doc_to_render.CommandName + $val

                    }

                }

                foreach ($syntax in $splitted_paramsets) {

                    $x = 0

                    foreach ($val in ($syntax.Replace("`r", '').Replace("`n", '') -split ' \[')) {

                        if ($x -eq 0) {

                            $null = $rtn.Add($val)

                        } else {

                            $null = $rtn.Add('    [' + $val.replace("`n", '').replace("`n", ''))

                        }

                        $x += 1

                    }

                    $null = $rtn.Add('')

                }

                $null = $rtn.Add('```')

                $null = $rtn.Add("`n" + '&nbsp;' + "`n")

            }

            $null = $rtn.Add('')

            $null = $rtn.Add('## Examples')

            $null = $rtn.Add("`n" + '&nbsp;' + "`n")

            $examples = $doc_to_render.Examples.Replace("`r`n", "`n") -replace '(\r\n){2,8}', '\n'

            $examples = $examples.replace("`r", '').split("`n")

            $inside = 0

            foreach ($row in $examples) {

                if ($row -like '*----') {

                    $null = $rtn.Add("");

                    $null = $rtn.Add('#####' + ($row -replace '-{4,}([^-]*)-{4,}', '$1').replace('EXAMPLE', 'Example: '))

                } elseif (($row -like 'PS C:\>*') -or ($row -like '>>*')) {

                    if ($inside -eq 0) { $null = $rtn.Add('```') }

                    $null = $rtn.Add(($row.Trim() -replace 'PS C:\\>\s*', "PS C:\> "))

                    $inside = 1

                } elseif ($row.Trim() -eq '' -or $row.Trim() -eq 'Description') {

                } else {

                    if ($inside -eq 1) {

                        $inside = 0

                        $null = $rtn.Add('```')

                    }

                    $null = $rtn.Add("$row<br>")

                }

            }

            if ($inside -eq 1) {

                $inside = 0

                $null = $rtn.Add('```')

            }

            if ($doc_to_render.Params) {

                $dotitle = 0

                $filteredparams = @()

                foreach ($p in $doc_to_render.Params) {

                    if ($p[3] -eq $true) {

                        $filteredparams += , $p

                    }

                }

                $dotitle = 0

                foreach ($el in $filteredparams) {

                    if ($dotitle -eq 0) {

                        $dotitle = 1

                        $null = $rtn.Add('### Required Parameters')

                    }

                    $null = $rtn.Add('##### -' + $el[0])

                    $null = $rtn.Add($el[1] + '<br>')

                    $null = $rtn.Add('')

                    $null = $rtn.Add('|  |  |')

                    $null = $rtn.Add('| - | - |')

                    $null = $rtn.Add('| Alias | ' + $el[2] + ' |')

                    $null = $rtn.Add('| Required | ' + $el[3] + ' |')

                    $null = $rtn.Add('| Pipeline | ' + $el[4] + ' |')

                    $null = $rtn.Add('| Default Value | ' + $el[5] + ' |')

                    if ($el[6]) {

                        $null = $rtn.Add('| Accepted Values | ' + $el[6] + ' |')

                    }

                    $null = $rtn.Add('')

                }

                $dotitle = 0

                $filteredparams = @()

                foreach ($p in $doc_to_render.Params) {

                    if ($p[3] -eq $false) {

                        $filteredparams += , $p

                    }

                }

                foreach ($el in $filteredparams) {

                    if ($dotitle -eq 0) {

                        $dotitle = 1

                        $null = $rtn.Add('### Optional Parameters')

                    }

                    $null = $rtn.Add('##### -' + $el[0])

                    $null = $rtn.Add($el[1] + '<br>')

                    $null = $rtn.Add('')

                    $null = $rtn.Add('|  |  |')

                    $null = $rtn.Add('| - | - |')

                    $null = $rtn.Add('| Alias | ' + $el[2] + ' |')

                    $null = $rtn.Add('| Required | ' + $el[3] + ' |')

                    $null = $rtn.Add('| Pipeline | ' + $el[4] + ' |')

                    $null = $rtn.Add('| Default Value | ' + $el[5] + ' |')

                    if ($el[6]) {

                        $null = $rtn.Add('| Accepted Values | ' + $el[6] + ' |')

                    }

                    $null = $rtn.Add('')

                }

            }

            $null = $rtn.Add('')

            $null = $rtn.Add("`n" + '&nbsp;' + "`n")

            $null = $rtn.Add('Want to see the source code for this command? Check out [' + $doc_to_render.CommandName + '](https://github.com/dataplat/dbatools/blob/master/functions/' + $doc_to_render.CommandName + '.ps1) on GitHub.')

            $null = $rtn.Add("<br>")

            $null = $rtn.Add('Want to see the Bill Of Health for this command? Check out [' + $doc_to_render.CommandName + '](https://dataplat.github.io/boh#' + $doc_to_render.CommandName + ').')

            $null = $rtn.Add('')

            return $rtn

        }

    }

    process {

        if ($Name -in $script:noncoresmo -or $Name -in $script:windowsonly) {

            $availability = 'Windows only'

        }

        try {

            $thishelp = Get-Help $Name -Full

        } catch {

            Stop-Function -Message "Issue getting help for $Name" -Target $Name -ErrorRecord $_ -Continue

        }

        $thebase = @{ }

        $thebase.CommandName = $Name

        $thebase.Name = $thishelp.Name

        $thebase.Availability = $availability

        $alias = Get-Alias -Definition $Name -ErrorAction SilentlyContinue

        $thebase.Alias = $alias.Name -Join ','

        ## fetch the description

        $thebase.Description = $thishelp.Description.Text

        ## fetch examples

        $thebase.Examples = Get-DbaTrimmedString -Text ($thishelp.Examples | Out-String -Width 200)

        ## fetch help link

        $thebase.Links = ($thishelp.relatedLinks).NavigationLink.Uri

        ## fetch the synopsis

        $thebase.Synopsis = $thishelp.Synopsis

        ## fetch the syntax

        $thebase.Syntax = Get-DbaTrimmedString -Text ($thishelp.Syntax | Out-String -Width 600)

        ## store notes

        $as = $thishelp.AlertSet | Out-String -Width 600

        ## fetch the tags

        $tags = $tagsrex.Match($as).Groups[1].Value

        if ($tags) {

            $thebase.Tags = $tags.Split(',').Trim()

        }

        ## fetch the author

        $author = $authorRex.Match($as).Groups[1].Value

        if ($author) {

            $thebase.Author = $author.Trim()

        }

        ## fetch MinimumVersion

        $MinimumVersion = $minverRex.Match($as).Groups[1].Value

        if ($MinimumVersion) {

            $thebase.MinimumVersion = $MinimumVersion.Trim()

        }

        ## fetch MaximumVersion

        $MaximumVersion = $maxverRex.Match($as).Groups[1].Value

        if ($MaximumVersion) {

            $thebase.MaximumVersion = $MaximumVersion.Trim()

        }

        ## fetch Parameters

        $parameters = $thishelp.parameters.parameter

        $command = Get-Command $Name

        $params = @()

        foreach ($p in $parameters) {

            $paramAlias = $command.parameters[$p.Name].Aliases

            $validValues = $command.parameters[$p.Name].Attributes.ValidValues -Join ','

            $paramDescr = Get-DbaTrimmedString -Text ($p.Description | Out-String -Width 200)

            $params += , @($p.Name, $paramDescr, ($paramAlias -Join ','), ($p.Required -eq $true), $p.PipelineInput, $p.DefaultValue, $validValues)

        }

        $thebase.Params = $params

        if ($OutputAs -eq "PSObject") {

            [pscustomobject]$thebase

        } elseif ($OutputAs -eq "MDString") {

            Get-DbaDocsMD -doc_to_render $thebase

        }

    }

    end {

    }

}

# SIG # Begin signature block

# MIIdsAYJKoZIhvcNAQcCoIIdoTCCHZ0CAQExCzAJBgUrDgMCGgUAMGkGCisGAQQB

# gjcCAQSgWzBZMDQGCisGAQQBgjcCAR4wJgIDAQAABBAfzDtgWUsITrck0sYpfvNR

# AgEAAgEAAgEAAgEAAgEAMCEwCQYFKw4DAhoFAAQUQvvyNfkAXGjWVCv9llvtBaAh

# rpmgghfOMIIFGjCCBAKgAwIBAgIQAwW7hiGwoWNfv96uEgTnbTANBgkqhkiG9w0B

# AQsFADByMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYD

# VQQLExB3d3cuZGlnaWNlcnQuY29tMTEwLwYDVQQDEyhEaWdpQ2VydCBTSEEyIEFz

# c3VyZWQgSUQgQ29kZSBTaWduaW5nIENBMB4XDTIwMDUxMjAwMDAwMFoXDTIzMDYw

# ODEyMDAwMFowVzELMAkGA1UEBhMCVVMxETAPBgNVBAgTCFZpcmdpbmlhMQ8wDQYD

# VQQHEwZWaWVubmExETAPBgNVBAoTCGRiYXRvb2xzMREwDwYDVQQDEwhkYmF0b29s

# czCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBALy/Y3ur47++CAG2mOa1

# 6h8WjXjSTvcldDmw4PpAvOOCKNr6xyhg/FOYVIiaeq2N9kVaa5wBawOIxVWuj/rI

# aOxeYklQDugPkGUx0Ap+6KrjnnxgE6ONzQGnc1tjlka6N0KazD2WodEBWKXo/Vmk

# C/cP9PJVWroCMOwlj7GtEv2IxzxikPm2ICP5KxFK5PmrA+5bzcHJEeqRonlgMn9H

# zZkqHr0AU1egnfEIlH4/v6lry1t1KBF/bnDhl9g/L0icS+ychFVkx4OOO4a+qvT8

# xqvvdQjv3PQ1hbzTI3/tXOWu9XxGeeIdZjaJv16FmWKCnloSp1Xb9cVU9XhIpomz

# xH0CAwEAAaOCAcUwggHBMB8GA1UdIwQYMBaAFFrEuXsqCqOl6nEDwGD5LfZldQ5Y

# MB0GA1UdDgQWBBTwwKD7tgOAQ077Cdfd33qxy+OeIjAOBgNVHQ8BAf8EBAMCB4Aw

# EwYDVR0lBAwwCgYIKwYBBQUHAwMwdwYDVR0fBHAwbjA1oDOgMYYvaHR0cDovL2Ny

# bDMuZGlnaWNlcnQuY29tL3NoYTItYXNzdXJlZC1jcy1nMS5jcmwwNaAzoDGGL2h0

# dHA6Ly9jcmw0LmRpZ2ljZXJ0LmNvbS9zaGEyLWFzc3VyZWQtY3MtZzEuY3JsMEwG

# A1UdIARFMEMwNwYJYIZIAYb9bAMBMCowKAYIKwYBBQUHAgEWHGh0dHBzOi8vd3d3

# LmRpZ2ljZXJ0LmNvbS9DUFMwCAYGZ4EMAQQBMIGEBggrBgEFBQcBAQR4MHYwJAYI

# KwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBOBggrBgEFBQcwAoZC

# aHR0cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0U0hBMkFzc3VyZWRJ

# RENvZGVTaWduaW5nQ0EuY3J0MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQAD

# ggEBAI/N+XCVDB/WNqQSrKY85zScHGJjsXgXByYvsitMuG5vo+ODhlh+ILv0CTPl

# o2Wo75MnSSqCWR+c6xyN8pDPMPBxm2EtVmXzeKDMIudYyjxmT8PZ3hktj16wXCo8

# 2+65UOse+CHsfoMn/M9WbkQ4rSyWNPRRDodATC2i4flLyeuoIZnyMoz/4N4mWb6s

# IAYZ/tNXzm6qwCfkmoMSf9tcTUCXIbVDliJcUZLlJ/SpLg2KzDu9GtnpBzg3AG3L

# hwBiPMM8OLGitYjz4VU5RYox0vu1XyLf3f9fKTCxxwKy0EKntWdJk37i+DOMQlCq

# Xm5B/KyNxb2utv+qLGlyw9MphEcwggUwMIIEGKADAgECAhAECRgbX9W7ZnVTQ7Vv

# lVAIMA0GCSqGSIb3DQEBCwUAMGUxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdp

# Q2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xJDAiBgNVBAMTG0Rp

# Z2lDZXJ0IEFzc3VyZWQgSUQgUm9vdCBDQTAeFw0xMzEwMjIxMjAwMDBaFw0yODEw

# MjIxMjAwMDBaMHIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMx

# GTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xMTAvBgNVBAMTKERpZ2lDZXJ0IFNI

# QTIgQXNzdXJlZCBJRCBDb2RlIFNpZ25pbmcgQ0EwggEiMA0GCSqGSIb3DQEBAQUA

# A4IBDwAwggEKAoIBAQD407Mcfw4Rr2d3B9MLMUkZz9D7RZmxOttE9X/lqJ3bMtdx

# 6nadBS63j/qSQ8Cl+YnUNxnXtqrwnIal2CWsDnkoOn7p0WfTxvspJ8fTeyOU5JEj

# lpB3gvmhhCNmElQzUHSxKCa7JGnCwlLyFGeKiUXULaGj6YgsIJWuHEqHCN8M9eJN

# YBi+qsSyrnAxZjNxPqxwoqvOf+l8y5Kh5TsxHM/q8grkV7tKtel05iv+bMt+dDk2

# DZDv5LVOpKnqagqrhPOsZ061xPeM0SAlI+sIZD5SlsHyDxL0xY4PwaLoLFH3c7y9

# hbFig3NBggfkOItqcyDQD2RzPJ6fpjOp/RnfJZPRAgMBAAGjggHNMIIByTASBgNV

# HRMBAf8ECDAGAQH/AgEAMA4GA1UdDwEB/wQEAwIBhjATBgNVHSUEDDAKBggrBgEF

# BQcDAzB5BggrBgEFBQcBAQRtMGswJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRp

# Z2ljZXJ0LmNvbTBDBggrBgEFBQcwAoY3aHR0cDovL2NhY2VydHMuZGlnaWNlcnQu

# Y29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNydDCBgQYDVR0fBHoweDA6oDig

# NoY0aHR0cDovL2NybDQuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9v

# dENBLmNybDA6oDigNoY0aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0

# QXNzdXJlZElEUm9vdENBLmNybDBPBgNVHSAESDBGMDgGCmCGSAGG/WwAAgQwKjAo

# BggrBgEFBQcCARYcaHR0cHM6Ly93d3cuZGlnaWNlcnQuY29tL0NQUzAKBghghkgB

# hv1sAzAdBgNVHQ4EFgQUWsS5eyoKo6XqcQPAYPkt9mV1DlgwHwYDVR0jBBgwFoAU

# Reuir/SSy4IxLVGLp6chnfNtyA8wDQYJKoZIhvcNAQELBQADggEBAD7sDVoks/Mi

# 0RXILHwlKXaoHV0cLToaxO8wYdd+C2D9wz0PxK+L/e8q3yBVN7Dh9tGSdQ9RtG6l

# jlriXiSBThCk7j9xjmMOE0ut119EefM2FAaK95xGTlz/kLEbBw6RFfu6r7VRwo0k

# riTGxycqoSkoGjpxKAI8LpGjwCUR4pwUR6F6aGivm6dcIFzZcbEMj7uo+MUSaJ/P

# QMtARKUT8OZkDCUIQjKyNookAv4vcn4c10lFluhZHen6dGRrsutmQ9qzsIzV6Q3d

# 9gEgzpkxYz0IGhizgZtPxpMQBvwHgfqL2vmCSfdibqFT+hKUGIUukpHqaGxEMrJm

# oecYpJpkUe8wggauMIIElqADAgECAhAHNje3JFR82Ees/ShmKl5bMA0GCSqGSIb3

# DQEBCwUAMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAX

# BgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lDZXJ0IFRydXN0

# ZWQgUm9vdCBHNDAeFw0yMjAzMjMwMDAwMDBaFw0zNzAzMjIyMzU5NTlaMGMxCzAJ

# BgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjE7MDkGA1UEAxMyRGln

# aUNlcnQgVHJ1c3RlZCBHNCBSU0E0MDk2IFNIQTI1NiBUaW1lU3RhbXBpbmcgQ0Ew

# ggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDGhjUGSbPBPXJJUVXHJQPE

# 8pE3qZdRodbSg9GeTKJtoLDMg/la9hGhRBVCX6SI82j6ffOciQt/nR+eDzMfUBML

# JnOWbfhXqAJ9/UO0hNoR8XOxs+4rgISKIhjf69o9xBd/qxkrPkLcZ47qUT3w1lbU

# 5ygt69OxtXXnHwZljZQp09nsad/ZkIdGAHvbREGJ3HxqV3rwN3mfXazL6IRktFLy

# dkf3YYMZ3V+0VAshaG43IbtArF+y3kp9zvU5EmfvDqVjbOSmxR3NNg1c1eYbqMFk

# dECnwHLFuk4fsbVYTXn+149zk6wsOeKlSNbwsDETqVcplicu9Yemj052FVUmcJgm

# f6AaRyBD40NjgHt1biclkJg6OBGz9vae5jtb7IHeIhTZgirHkr+g3uM+onP65x9a

# bJTyUpURK1h0QCirc0PO30qhHGs4xSnzyqqWc0Jon7ZGs506o9UD4L/wojzKQtwY

# SH8UNM/STKvvmz3+DrhkKvp1KCRB7UK/BZxmSVJQ9FHzNklNiyDSLFc1eSuo80Vg

# vCONWPfcYd6T/jnA+bIwpUzX6ZhKWD7TA4j+s4/TXkt2ElGTyYwMO1uKIqjBJgj5

# FBASA31fI7tk42PgpuE+9sJ0sj8eCXbsq11GdeJgo1gJASgADoRU7s7pXcheMBK9

# Rp6103a50g5rmQzSM7TNsQIDAQABo4IBXTCCAVkwEgYDVR0TAQH/BAgwBgEB/wIB

# ADAdBgNVHQ4EFgQUuhbZbU2FL3MpdpovdYxqII+eyG8wHwYDVR0jBBgwFoAU7Nfj

# gtJxXWRM3y5nP+e6mK4cD08wDgYDVR0PAQH/BAQDAgGGMBMGA1UdJQQMMAoGCCsG

# AQUFBwMIMHcGCCsGAQUFBwEBBGswaTAkBggrBgEFBQcwAYYYaHR0cDovL29jc3Au

# ZGlnaWNlcnQuY29tMEEGCCsGAQUFBzAChjVodHRwOi8vY2FjZXJ0cy5kaWdpY2Vy

# dC5jb20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0LmNydDBDBgNVHR8EPDA6MDigNqA0

# hjJodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkUm9vdEc0

# LmNybDAgBgNVHSAEGTAXMAgGBmeBDAEEAjALBglghkgBhv1sBwEwDQYJKoZIhvcN

# AQELBQADggIBAH1ZjsCTtm+YqUQiAX5m1tghQuGwGC4QTRPPMFPOvxj7x1Bd4ksp

# +3CKDaopafxpwc8dB+k+YMjYC+VcW9dth/qEICU0MWfNthKWb8RQTGIdDAiCqBa9

# qVbPFXONASIlzpVpP0d3+3J0FNf/q0+KLHqrhc1DX+1gtqpPkWaeLJ7giqzl/Yy8

# ZCaHbJK9nXzQcAp876i8dU+6WvepELJd6f8oVInw1YpxdmXazPByoyP6wCeCRK6Z

# JxurJB4mwbfeKuv2nrF5mYGjVoarCkXJ38SNoOeY+/umnXKvxMfBwWpx2cYTgAnE

# tp/Nh4cku0+jSbl3ZpHxcpzpSwJSpzd+k1OsOx0ISQ+UzTl63f8lY5knLD0/a6fx

# ZsNBzU+2QJshIUDQtxMkzdwdeDrknq3lNHGS1yZr5Dhzq6YBT70/O3itTK37xJV7

# 7QpfMzmHQXh6OOmc4d0j/R0o08f56PGYX/sr2H7yRp11LB4nLCbbbxV7HhmLNriT

# 1ObyF5lZynDwN7+YAN8gFk8n+2BnFqFmut1VwDophrCYoCvtlUG3OtUVmDG0YgkP

# Cr2B2RP+v6TR81fZvAT6gt4y3wSJ8ADNXcL50CN/AAvkdgIm2fBldkKmKYcJRyvm

# fxqkhQ/8mJb2VVQrH4D6wPIOK+XW+6kvRBVK5xMOHds3OBqhK/bt1nz8MIIGxjCC

# BK6gAwIBAgIQCnpKiJ7JmUKQBmM4TYaXnTANBgkqhkiG9w0BAQsFADBjMQswCQYD

# VQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xOzA5BgNVBAMTMkRpZ2lD

# ZXJ0IFRydXN0ZWQgRzQgUlNBNDA5NiBTSEEyNTYgVGltZVN0YW1waW5nIENBMB4X

# DTIyMDMyOTAwMDAwMFoXDTMzMDMxNDIzNTk1OVowTDELMAkGA1UEBhMCVVMxFzAV

# BgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMSQwIgYDVQQDExtEaWdpQ2VydCBUaW1lc3Rh

# bXAgMjAyMiAtIDIwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC5KpYj

# ply8X9ZJ8BWCGPQz7sxcbOPgJS7SMeQ8QK77q8TjeF1+XDbq9SWNQ6OB6zhj+TyI

# ad480jBRDTEHukZu6aNLSOiJQX8Nstb5hPGYPgu/CoQScWyhYiYB087DbP2sO37c

# KhypvTDGFtjavOuy8YPRn80JxblBakVCI0Fa+GDTZSw+fl69lqfw/LH09CjPQnkf

# O8eTB2ho5UQ0Ul8PUN7UWSxEdMAyRxlb4pguj9DKP//GZ888k5VOhOl2GJiZERTF

# KwygM9tNJIXogpThLwPuf4UCyYbh1RgUtwRF8+A4vaK9enGY7BXn/S7s0psAiqwd

# jTuAaP7QWZgmzuDtrn8oLsKe4AtLyAjRMruD+iM82f/SjLv3QyPf58NaBWJ+cCzl

# K7I9Y+rIroEga0OJyH5fsBrdGb2fdEEKr7mOCdN0oS+wVHbBkE+U7IZh/9sRL5ID

# MM4wt4sPXUSzQx0jUM2R1y+d+/zNscGnxA7E70A+GToC1DGpaaBJ+XXhm+ho5GoM

# j+vksSF7hmdYfn8f6CvkFLIW1oGhytowkGvub3XAsDYmsgg7/72+f2wTGN/GbaR5

# Sa2Lf2GHBWj31HDjQpXonrubS7LitkE956+nGijJrWGwoEEYGU7tR5thle0+C2Fa

# 6j56mJJRzT/JROeAiylCcvd5st2E6ifu/n16awIDAQABo4IBizCCAYcwDgYDVR0P

# AQH/BAQDAgeAMAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgw

# IAYDVR0gBBkwFzAIBgZngQwBBAIwCwYJYIZIAYb9bAcBMB8GA1UdIwQYMBaAFLoW

# 2W1NhS9zKXaaL3WMaiCPnshvMB0GA1UdDgQWBBSNZLeJIf5WWESEYafqbxw2j92v

# DTBaBgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGln

# aUNlcnRUcnVzdGVkRzRSU0E0MDk2U0hBMjU2VGltZVN0YW1waW5nQ0EuY3JsMIGQ

# BggrBgEFBQcBAQSBgzCBgDAkBggrBgEFBQcwAYYYaHR0cDovL29jc3AuZGlnaWNl

# cnQuY29tMFgGCCsGAQUFBzAChkxodHRwOi8vY2FjZXJ0cy5kaWdpY2VydC5jb20v

# RGlnaUNlcnRUcnVzdGVkRzRSU0E0MDk2U0hBMjU2VGltZVN0YW1waW5nQ0EuY3J0

# MA0GCSqGSIb3DQEBCwUAA4ICAQANLSN0ptH1+OpLmT8B5PYM5K8WndmzjJeCKZxD

# bwEtqzi1cBG/hBmLP13lhk++kzreKjlaOU7YhFmlvBuYquhs79FIaRk4W8+JOR1w

# cNlO3yMibNXf9lnLocLqTHbKodyhK5a4m1WpGmt90fUCCU+C1qVziMSYgN/uSZW3

# s8zFp+4O4e8eOIqf7xHJMUpYtt84fMv6XPfkU79uCnx+196Y1SlliQ+inMBl9AEi

# ZcfqXnSmWzWSUHz0F6aHZE8+RokWYyBry/J70DXjSnBIqbbnHWC9BCIVJXAGcqlE

# O2lHEdPu6cegPk8QuTA25POqaQmoi35komWUEftuMvH1uzitzcCTEdUyeEpLNypM

# 81zctoXAu3AwVXjWmP5UbX9xqUgaeN1Gdy4besAzivhKKIwSqHPPLfnTI/KeGeAN

# lCig69saUaCVgo4oa6TOnXbeqXOqSGpZQ65f6vgPBkKd3wZolv4qoHRbY2beayy4

# eKpNcG3wLPEHFX41tOa1DKKZpdcVazUOhdbgLMzgDCS4fFILHpl878jIxYxYaa+r

# PeHPzH0VrhS/inHfypex2EfqHIXgRU4SHBQpWMxv03/LvsEOSm8gnK7ZczJZCOct

# kqEaEf4ymKZdK5fgi9OczG21Da5HYzhHF1tvE9pqEG4fSbdEW7QICodaWQR2EaGn

# dwITHDGCBUwwggVIAgEBMIGGMHIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdp

# Q2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xMTAvBgNVBAMTKERp

# Z2lDZXJ0IFNIQTIgQXNzdXJlZCBJRCBDb2RlIFNpZ25pbmcgQ0ECEAMFu4YhsKFj

# X7/erhIE520wCQYFKw4DAhoFAKB4MBgGCisGAQQBgjcCAQwxCjAIoAKAAKECgAAw

# GQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisG

# AQQBgjcCARUwIwYJKoZIhvcNAQkEMRYEFOJRJClCcnlh9pXpFvrtPXsWq+HAMA0G

# CSqGSIb3DQEBAQUABIIBABw2FnFkGfDWjsLBPhMXnw17afob+dYvJGBZ+DcmKjVl

# kLOp+RkY14QdKXkpscaH7/8hm56Xc+qd1MriF4M2WxvydEYoICJysRId4c4JyEZr

# IsvbXcfgmdfX57k/OwW5dDz2EuM/HO/AiKSvrpIwQp25WorsNkNfKRMCXfp6j9vz

# CRch2SScBFvQJKwzc6fGvt/jrSAzjV+G6yFzvgux2OxyPZWkZE1HyfwlvDG/NvTm

# hsPM3x8K2YNwtRpPrL1Uo27WqTsA5on3jUdtigf5gAFoqsO2b2VckhpSwfCacE9i

# 623bbaNPokdyUcGSya+o6LMimo64LMETmJRLKvumlyyhggMgMIIDHAYJKoZIhvcN

# AQkGMYIDDTCCAwkCAQEwdzBjMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNl

# cnQsIEluYy4xOzA5BgNVBAMTMkRpZ2lDZXJ0IFRydXN0ZWQgRzQgUlNBNDA5NiBT

# SEEyNTYgVGltZVN0YW1waW5nIENBAhAKekqInsmZQpAGYzhNhpedMA0GCWCGSAFl

# AwQCAQUAoGkwGAYJKoZIhvcNAQkDMQsGCSqGSIb3DQEHATAcBgkqhkiG9w0BCQUx

# DxcNMjIwNTAzMTk1ODQxWjAvBgkqhkiG9w0BCQQxIgQgW7+ZLNVsbzbovxK2pSuc

# 4Rk2UWazZiBye7uMmU3ho7EwDQYJKoZIhvcNAQEBBQAEggIAIymyHat8Y1y8j+G9

# ipz+TxK4SezvFGoAQC1qmRqmKGS+N/4h5LOFVJF9nORsmCvjqA4rBQ+ZSo3ge99L

# BVpfAOSSeCL9ZcVvP48I+A9HkRpMFqAa2VUlXf6rFmE1q3POV2W2n00sfn+76wI8

# LiqhvK2xM6MLsjJF+P0TUI4fdMviFwHiG+EBj0gwHs+VZk2PNwNjYS14knUIo7Pc

# nHbZEr8ZErUiudEF/9oILOOQw4Kiqi276cZ+IvR4SVsXzpmEdHcKv4PUo3em5hXo

# UmZ2CNFo9WX+9KD5P/YYQybNWYCMuKsTDtKUyuif29ccYvGLMZ5zGxYYZ4y7QCCE

# BH0f8DSmK+Vl0nwNY8agKNLOCvRF87LM3QnMmIo/DEXJoBaHAeUwYk9SRemONBaj

# jun9lDPmTkq/NEY1v+s8PvS1Ywh/Bj1ILK4YjUS21M7rYnxW1AhC5pRSRRuqyQMH

# 4r6XmtVYpKjaLFNNeQUsUJR9LJkkgWWQj7ApXrZPibZc1MgQ8yKmSNuUBDsZnQOm

# a8PG4PK0m4AVqoswk1xI3FvS9c2M4gxE+8gOICQk6NVKJMZwWPLOPa0nnwP3hMbj

# xmcpW0LrXag8XZgmRXyCYh7AoRZqMScY41fWMMyX9WJUKvqINL4Nhri8YhtV8R2D

# dxoSKDp1y0FYJ0F8Ic48iCbxn10=

# SIG # End signature block