Obs/bin/TestObservability/TestObservability.psm1

<###################################################
 # #
 # Copyright (c) Microsoft. All rights reserved. #
 # #
 ##################################################>

 
 Import-Module $PSScriptRoot\HelperFiles\TestObsHelper.psm1 -Force -Verbose:$false
 Import-Module $PSScriptRoot\HelperFiles\ReportHelper.psm1 -Force -Verbose:$false
 Import-Module $PSScriptRoot\HelperFiles\HTMLReportHelper.psm1 -Force -Verbose:$false
 Import-Module $PSScriptRoot\HelperFiles\GeneralReportInformation.psm1 -Force -Verbose:$false

 function Test-Observability
 {
     [CmdletBinding(DefaultParametersetName='RunTests')] 
     Param(
        [Parameter(Mandatory=$false, ParameterSetName='RunTests')]
        [string[]]
        $TestsToRun,

        [Parameter(Mandatory=$false, ParameterSetName='ListTests')]
        [switch]
        $ListTests,

        [Parameter(Mandatory=$false, ParameterSetName='RunTestCategories')]
        [string[]]
        $TestCategoriesToRun,

        [Parameter(Mandatory=$false, ParameterSetName='ListTestCategories')]
        [switch]
        $ListTestCategories
     )

     $OutputFilePath = "$env:SystemDrive\Observability\TestObservability"

     if (-not (Test-Path $OutputFilePath))
     {
        New-Item -Path $OutputFilePath -ItemType Directory
     }

     # don't create transript if we are just listing tests
     if (!$ListTests -and !$ListTestCategories)
     {
         $functionName = $($MyInvocation.MyCommand.Name)
         $transcriptName = "TestObservability.log"
         $transcriptPath = Join-Path $OutputFilePath $transcriptName
         Start-Transcript $transcriptPath
     }
     
     try
     {
         $deviceType = Get-DeviceType
         # If we can't get device type, set to unknown
         if ($null -eq $deviceType)
         {
             $deviceType = "Unknown"
         }

         $availableTestsJSON = "$PSScriptRoot\HelperFiles\ListTests.json"
         $availableTests = Get-TestNamesFromJson -TestsJSONFile $availableTestsJSON
         $availableTestCategories = Get-TestCategoryNamesFromJSON -TestsJSONFile $availableTestsJSON

         if ($ListTests)
         {
             $availableTests | Out-String
             return
         }

         if ($ListTestCategories)
         {
             $availableTestCategories | Out-String
             return
         }

         if (!$TestCategoriesToRun)
         {
             $testNames = Get-FilteredTestNames -AllTests $availableTests -TestsToRun $TestsToRun
         }
         else
         {
             $testNames = Get-TestNamesFromJson -TestsJSONFile $availableTestsJSON -CategoriesToRun $TestCategoriesToRun
         }

         if ([string]::IsNullOrEmpty($testNames))
         {
             Trace-Progress "$functionName : There are no tests to run. Aborting Test-Observability."
             return
         }

         # Remove everything in TestObservability path, except TestObservability.log
         Get-ChildItem -Path $OutputFilePath -Recurse `
            | Where-Object { -not ($_.Name.EndsWith($transcriptName)) } `
            | Remove-Item -Recurse -Force

         $pathToTestReports = Join-Path $OutputFilePath "TestReports"
         New-Item -Path $pathToTestReports -ItemType Directory

         $testsLocation = "$PSScriptRoot\TestModules"
         Get-GeneralReportInformation -PathToTestReports $pathToTestReports

         foreach ($nameOfTest in $testNames)
         {
             try
             {
                 $testReportJSON = $nameOfTest + ".json"
                 $testReportJSONName = Join-Path $PathToTestReports $testReportJSON
                 
                 $testLocation = Join-Path $testsLocation $nameOfTest
                 $testFile = $nameOfTest + ".psm1"
                 $testModule = Join-Path $testLocation $testFile
                 Import-Module $testModule

                 $component = $nameOfTest.Replace("Test", "-")
                 $functionName = "Test" + $component

                 $testReport = New-TestReport -TestName $nameOfTest
                 $testReport = & $functionName -TestReport $testReport -DeviceType $deviceType
                 $testReport.OverallResult = Get-OverallResult -TestReport $testReport
                 $testReport | ConvertTo-Json | Out-File $TestReportJSONName
             }
             catch
             {
                 Trace-Progress "$functionName : Error running test $nameOfTest. $_" -Error
             }
         }

         $functionName = $($MyInvocation.MyCommand.Name)
         Trace-Progress "$functionName : Attempting to generate TestObservability HTML report."
         try
         {
             $reportPath = Generate-HTMLReport -PathToTestReports $pathToTestReports -TestNames $testNames
             Trace-Progress "$functionName : Successfully generated the TestObservability report at $reportPath."
         }
         catch
         {
             Trace-Progress "$functionName : Failed to generate TestObservability HTML report. Failed with errror: $_"
         }
         
     }
     catch
     {
         Trace-Progress "$functionName failed with: $_" -Error
     }
     finally
     {
         if (!$ListTests -and !$ListTestCategories)
         {
             Stop-Transcript
         }
     }
 }



Export-ModuleMember -Function Test-Observability
# SIG # Begin signature block
# MIIoKwYJKoZIhvcNAQcCoIIoHDCCKBgCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAcdumctyVVHMZ6
# VjTVylvro4zwes1BOFupM4TACw8PPaCCDXYwggX0MIID3KADAgECAhMzAAADrzBA
# DkyjTQVBAAAAAAOvMA0GCSqGSIb3DQEBCwUAMH4xCzAJBgNVBAYTAlVTMRMwEQYD
# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25p
# bmcgUENBIDIwMTEwHhcNMjMxMTE2MTkwOTAwWhcNMjQxMTE0MTkwOTAwWjB0MQsw
# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u
# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYDVQQDExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIB
# AQDOS8s1ra6f0YGtg0OhEaQa/t3Q+q1MEHhWJhqQVuO5amYXQpy8MDPNoJYk+FWA
# hePP5LxwcSge5aen+f5Q6WNPd6EDxGzotvVpNi5ve0H97S3F7C/axDfKxyNh21MG
# 0W8Sb0vxi/vorcLHOL9i+t2D6yvvDzLlEefUCbQV/zGCBjXGlYJcUj6RAzXyeNAN
# xSpKXAGd7Fh+ocGHPPphcD9LQTOJgG7Y7aYztHqBLJiQQ4eAgZNU4ac6+8LnEGAL
# go1ydC5BJEuJQjYKbNTy959HrKSu7LO3Ws0w8jw6pYdC1IMpdTkk2puTgY2PDNzB
# tLM4evG7FYer3WX+8t1UMYNTAgMBAAGjggFzMIIBbzAfBgNVHSUEGDAWBgorBgEE
# AYI3TAgBBggrBgEFBQcDAzAdBgNVHQ4EFgQURxxxNPIEPGSO8kqz+bgCAQWGXsEw
# RQYDVR0RBD4wPKQ6MDgxHjAcBgNVBAsTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEW
# MBQGA1UEBRMNMjMwMDEyKzUwMTgyNjAfBgNVHSMEGDAWgBRIbmTlUAXTgqoXNzci
# tW2oynUClTBUBgNVHR8ETTBLMEmgR6BFhkNodHRwOi8vd3d3Lm1pY3Jvc29mdC5j
# b20vcGtpb3BzL2NybC9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3JsMGEG
# CCsGAQUFBwEBBFUwUzBRBggrBgEFBQcwAoZFaHR0cDovL3d3dy5taWNyb3NvZnQu
# Y29tL3BraW9wcy9jZXJ0cy9NaWNDb2RTaWdQQ0EyMDExXzIwMTEtMDctMDguY3J0
# MAwGA1UdEwEB/wQCMAAwDQYJKoZIhvcNAQELBQADggIBAISxFt/zR2frTFPB45Yd
# mhZpB2nNJoOoi+qlgcTlnO4QwlYN1w/vYwbDy/oFJolD5r6FMJd0RGcgEM8q9TgQ
# 2OC7gQEmhweVJ7yuKJlQBH7P7Pg5RiqgV3cSonJ+OM4kFHbP3gPLiyzssSQdRuPY
# 1mIWoGg9i7Y4ZC8ST7WhpSyc0pns2XsUe1XsIjaUcGu7zd7gg97eCUiLRdVklPmp
# XobH9CEAWakRUGNICYN2AgjhRTC4j3KJfqMkU04R6Toyh4/Toswm1uoDcGr5laYn
# TfcX3u5WnJqJLhuPe8Uj9kGAOcyo0O1mNwDa+LhFEzB6CB32+wfJMumfr6degvLT
# e8x55urQLeTjimBQgS49BSUkhFN7ois3cZyNpnrMca5AZaC7pLI72vuqSsSlLalG
# OcZmPHZGYJqZ0BacN274OZ80Q8B11iNokns9Od348bMb5Z4fihxaBWebl8kWEi2O
# PvQImOAeq3nt7UWJBzJYLAGEpfasaA3ZQgIcEXdD+uwo6ymMzDY6UamFOfYqYWXk
# ntxDGu7ngD2ugKUuccYKJJRiiz+LAUcj90BVcSHRLQop9N8zoALr/1sJuwPrVAtx
# HNEgSW+AKBqIxYWM4Ev32l6agSUAezLMbq5f3d8x9qzT031jMDT+sUAoCw0M5wVt
# CUQcqINPuYjbS1WgJyZIiEkBMIIHejCCBWKgAwIBAgIKYQ6Q0gAAAAAAAzANBgkq
# hkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24x
# EDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlv
# bjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5
# IDIwMTEwHhcNMTEwNzA4MjA1OTA5WhcNMjYwNzA4MjEwOTA5WjB+MQswCQYDVQQG
# EwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwG
# A1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSgwJgYDVQQDEx9NaWNyb3NvZnQg
# Q29kZSBTaWduaW5nIFBDQSAyMDExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIIC
# CgKCAgEAq/D6chAcLq3YbqqCEE00uvK2WCGfQhsqa+laUKq4BjgaBEm6f8MMHt03
# a8YS2AvwOMKZBrDIOdUBFDFC04kNeWSHfpRgJGyvnkmc6Whe0t+bU7IKLMOv2akr
# rnoJr9eWWcpgGgXpZnboMlImEi/nqwhQz7NEt13YxC4Ddato88tt8zpcoRb0Rrrg
# OGSsbmQ1eKagYw8t00CT+OPeBw3VXHmlSSnnDb6gE3e+lD3v++MrWhAfTVYoonpy
# 4BI6t0le2O3tQ5GD2Xuye4Yb2T6xjF3oiU+EGvKhL1nkkDstrjNYxbc+/jLTswM9
# sbKvkjh+0p2ALPVOVpEhNSXDOW5kf1O6nA+tGSOEy/S6A4aN91/w0FK/jJSHvMAh
# dCVfGCi2zCcoOCWYOUo2z3yxkq4cI6epZuxhH2rhKEmdX4jiJV3TIUs+UsS1Vz8k
# A/DRelsv1SPjcF0PUUZ3s/gA4bysAoJf28AVs70b1FVL5zmhD+kjSbwYuER8ReTB
# w3J64HLnJN+/RpnF78IcV9uDjexNSTCnq47f7Fufr/zdsGbiwZeBe+3W7UvnSSmn
# Eyimp31ngOaKYnhfsi+E11ecXL93KCjx7W3DKI8sj0A3T8HhhUSJxAlMxdSlQy90
# lfdu+HggWCwTXWCVmj5PM4TasIgX3p5O9JawvEagbJjS4NaIjAsCAwEAAaOCAe0w
# ggHpMBAGCSsGAQQBgjcVAQQDAgEAMB0GA1UdDgQWBBRIbmTlUAXTgqoXNzcitW2o
# ynUClTAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMAQTALBgNVHQ8EBAMCAYYwDwYD
# VR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBRyLToCMZBDuRQFTuHqp8cx0SOJNDBa
# BgNVHR8EUzBRME+gTaBLhklodHRwOi8vY3JsLm1pY3Jvc29mdC5jb20vcGtpL2Ny
# bC9wcm9kdWN0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3JsMF4GCCsG
# AQUFBwEBBFIwUDBOBggrBgEFBQcwAoZCaHR0cDovL3d3dy5taWNyb3NvZnQuY29t
# L3BraS9jZXJ0cy9NaWNSb29DZXJBdXQyMDExXzIwMTFfMDNfMjIuY3J0MIGfBgNV
# HSAEgZcwgZQwgZEGCSsGAQQBgjcuAzCBgzA/BggrBgEFBQcCARYzaHR0cDovL3d3
# dy5taWNyb3NvZnQuY29tL3BraW9wcy9kb2NzL3ByaW1hcnljcHMuaHRtMEAGCCsG
# AQUFBwICMDQeMiAdAEwAZQBnAGEAbABfAHAAbwBsAGkAYwB5AF8AcwB0AGEAdABl
# AG0AZQBuAHQALiAdMA0GCSqGSIb3DQEBCwUAA4ICAQBn8oalmOBUeRou09h0ZyKb
# C5YR4WOSmUKWfdJ5DJDBZV8uLD74w3LRbYP+vj/oCso7v0epo/Np22O/IjWll11l
# hJB9i0ZQVdgMknzSGksc8zxCi1LQsP1r4z4HLimb5j0bpdS1HXeUOeLpZMlEPXh6
# I/MTfaaQdION9MsmAkYqwooQu6SpBQyb7Wj6aC6VoCo/KmtYSWMfCWluWpiW5IP0
# wI/zRive/DvQvTXvbiWu5a8n7dDd8w6vmSiXmE0OPQvyCInWH8MyGOLwxS3OW560
# STkKxgrCxq2u5bLZ2xWIUUVYODJxJxp/sfQn+N4sOiBpmLJZiWhub6e3dMNABQam
# ASooPoI/E01mC8CzTfXhj38cbxV9Rad25UAqZaPDXVJihsMdYzaXht/a8/jyFqGa
# J+HNpZfQ7l1jQeNbB5yHPgZ3BtEGsXUfFL5hYbXw3MYbBL7fQccOKO7eZS/sl/ah
# XJbYANahRr1Z85elCUtIEJmAH9AAKcWxm6U/RXceNcbSoqKfenoi+kiVH6v7RyOA
# 9Z74v2u3S5fi63V4GuzqN5l5GEv/1rMjaHXmr/r8i+sLgOppO6/8MO0ETI7f33Vt
# Y5E90Z1WTk+/gFcioXgRMiF670EKsT/7qMykXcGhiJtXcVZOSEXAQsmbdlsKgEhr
# /Xmfwb1tbWrJUnMTDXpQzTGCGgswghoHAgEBMIGVMH4xCzAJBgNVBAYTAlVTMRMw
# EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN
# aWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNp
# Z25pbmcgUENBIDIwMTECEzMAAAOvMEAOTKNNBUEAAAAAA68wDQYJYIZIAWUDBAIB
# BQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEO
# MAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEINsUx6TC16QZKQHyYxcf2HtJ
# PdeTByO3oWnxqF5z+GMkMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8A
# cwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEB
# BQAEggEAb94wP1ZSJyC3c1two98D/YZCUjfRTXso3n0Frd87ATrzUH03JEc0IT4Q
# N1QIRQYTtD9a2SXr0EJ7A76YafROwmQaN8/oCEc/vyWWa5S6p1U63SaVaaZuK8JH
# iI1aWkVYFNLe3MTv91HHi1fvNV9lsmgTDZq7Q5cprp3zPw4AiZ+DrHFfdahpTx30
# LV8GreA9dMBVb11c1wPGObs6vk722Z0pMcP+mjR2PD5Vzp1jKk96RRnv7Wc6TgY8
# rCi6Q4KOfpSLTuhSTTZF9YEQpPqWvLMLSnRd6RW97WtfDcpbAGr8hwGU20B730dz
# XV5IXjWDyxzgFyYczheduR3EW6n+u6GCF5UwgheRBgorBgEEAYI3AwMBMYIXgTCC
# F30GCSqGSIb3DQEHAqCCF24wghdqAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFQBgsq
# hkiG9w0BCRABBKCCAT8EggE7MIIBNwIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFl
# AwQCAQUABCDemIxggGmLdaFWGzkpM6lMC8W19zf2rlAjhaJfXbLwegIGZbwTMZFC
# GBEyMDI0MDIxMjE0MDgyNC43WjAEgAIB9KCB0aSBzjCByzELMAkGA1UEBhMCVVMx
# EzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoT
# FU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJp
# Y2EgT3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOkE5MzUtMDNF
# MC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloIIR
# 7TCCByAwggUIoAMCAQICEzMAAAHpD3Ewfl3xEjYAAQAAAekwDQYJKoZIhvcNAQEL
# BQAwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT
# B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE
# AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwHhcNMjMxMjA2MTg0NTI2
# WhcNMjUwMzA1MTg0NTI2WjCByzELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hp
# bmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jw
# b3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2EgT3BlcmF0aW9uczEn
# MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOkE5MzUtMDNFMC1EOTQ3MSUwIwYDVQQD
# ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEF
# AAOCAg8AMIICCgKCAgEArJqMMUEVYKeE0nN502usqwDyZ1egO2mWJ08P8sfdLtQ0
# h/PZ730Dc2/uX5gSvKaR++k5ic4x1HCJnfOOQP6b2WOTvDwgbuxqvseV3uqZULeM
# cFVFHECE8ZJTmdUZvXyeZ4fIJ8TsWnsxTDONbAyOyzKSsCCkDMFw3LWCrwskMupD
# trFSwetpBfPdmcHGKYiFcdy09Sz3TLdSHkt+SmOTMcpUXU0uxNSaHJd9DYHAYiX6
# pzHHtOXhIqSLEzuAyJ//07T9Ucee1V37wjvDUgofXcbMr54NJVFWPrq6vxvEERaD
# pf+6DiNEX/EIPt4cmGsh7CPcLbwxxp099Da+Ncc06cNiOmVmiIT8DLuQ73ZBBs1e
# 72E97W/bU74mN6bLpdU+Q/d/PwHzS6mp1QibT+Ms9FSQUhlfoeumXGlCTsaW0iIy
# JmjixdfDTo5n9Z8A2rbAaLl1lxSuxOUtFS0cqE6gwsRxuJlt5qTUKKTP1NViZ47L
# FkJbivHm/jAypZPRP4TgWCrNin3kOBxu3TnCvsDDmphn8L5CHu3ZMpc5vAXgFEAv
# C8awEMpIUh8vhWkPdwwJX0GKMGA7cxl6hOsDgE3ihSN9LvWJcQ08wLiwytO93J3T
# FeKmg93rlwOsVDQqM4O64oYh1GjONwJm/RBrkZdNtvsj8HJZspLLJN9GuEad7/UC
# AwEAAaOCAUkwggFFMB0GA1UdDgQWBBSRfjOJxQh2I7iI9Frr/o3I7QfsTjAfBgNV
# HSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5o
# dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBU
# aW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwG
# CCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRz
# L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNV
# HRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIH
# gDANBgkqhkiG9w0BAQsFAAOCAgEAVrEqfq5rMRS3utQBPdCnp9lz4EByQ4kuEmy4
# b831Ywzw5jnURO+bkKIWIRTHRsBym1ZiytJR1dQKc/x3ImaKMnqAL5B0Gh5i4cAR
# pKMgAFcXGmlJxzSFEvS73i9ND8JnEgy4DdFfxcpNtEKRwxLpMCkfJH2gRF/NwMr0
# M5X/26AzaFihIKXQLC/Esws1xS5w6M8wiRqtEc8EIHhAa/BOCtsENllyP2ScWUv/
# ndxXcBuBKwRc81Ikm1dpt8bDD93KgkRQ7SdQt/yZ41zAoZ5vWyww9cGie0z6ecGH
# b9DpffmjdLdQZjswo/A5qirlMM4AivU47cOSlI2jukI3oB853V/7Wa2O/dnX0QF6
# +XRqypKbLCB6uq61juD5S9zkvuHIi/5fKZvqDSV1hl2CS+R+izZyslyVRMP9RWzu
# Phs/lOHxRcbNkvFML6wW2HHFUPTvhZY+8UwHiEybB6bQL0RKgnPv2Mc4SCpAPPEP
# EISSlA7Ws2rSR+2TnYtCwisIKkDuB/NSmRg0i5LRbzUYYfGQQHp59aVvuVARmM9h
# qYHMVVyk9QrlGHZR0fQ+ja1YRqnYRk4OzoP3f/KDJTxt2I7qhcYnYiLKAMNvjISN
# c16yIuereiZCe+SevRfpZIfZsiSaTZMeNbEgdVytoyVoKu1ZQbj9Qbl42d6oMpva
# 9cL9DLUwggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3
# DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G
# A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMTIw
# MAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0ZSBBdXRob3JpdHkgMjAx
# MDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMyMjVaMHwxCzAJBgNVBAYTAlVT
# MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK
# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1l
# LVN0YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA
# 5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1V/YBf2xK4OK9uT4XYDP/
# XE/HZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY6GB9alKDRLemjkZrBxTzxXb1
# hlDcwUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmvHaus9ja+NSZk2pg7uhp7
# M62AW36MEBydUv626GIl3GoPz130/o5Tz9bshVZN7928jaTjkY+yOSxRnOlwaQ3K
# Ni1wjjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3tpK56KTesy+uDRedGbsoy
# 1cCGMFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74kpEeHT39IM9zfUGaRnXNxF80
# 3RKJ1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2K26oElHovwUDo9Fzpk03dJQc
# NIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5TI4CvEJoLhDqhFFG4tG9ahha
# YQFzymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZki1ugpoMhXV8wdJGUlNi5UPkL
# iWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9QBXpsxREdcu+N+VLEhReTwDwV
# 2xo3xwgVGD94q0W29R6HXtqPnhZyacaue7e3PmriLq0CAwEAAaOCAd0wggHZMBIG
# CSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYEFCqnUv5kxJq+gpE8RjUp
# zxD/LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJlpxtTNRnpcjBcBgNVHSAEVTBT
# MFEGDCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNodHRwOi8vd3d3Lm1pY3Jv
# c29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9yeS5odG0wEwYDVR0lBAwwCgYI
# KwYBBQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBDAEEwCwYDVR0PBAQDAgGG
# MA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZWy4/oolxiaNE9lJBb186a
# GMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3Br
# aS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMuY3JsMFoGCCsG
# AQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3dy5taWNyb3NvZnQuY29t
# L3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0yMy5jcnQwDQYJKoZIhvcN
# AQELBQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/ypb+pcFLY+TkdkeLEGk5c9MTO1
# OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpTTd2YurYeeNg2LpypglYA
# A7AFvonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM9W0jVOR4U3UkV7ndn/OOPcbz
# aN9l9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3+SmJw7wXsFSFQrP8DJ6L
# GYnn8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4FOmRsqlb30mjdAy87JGA0j3m
# Sj5mO0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSwethQ/gpY3UA8x1RtnWN0
# SCyxTkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPXfx5bRAGOWhmRaw2fpCjcZxko
# JLo4S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVXVAmxaQFEfnyhYWxz/gq77EFm
# PWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGConsXHRWJjXD+57XQKBqJC482
# 2rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU5nR0W2rRnj7tfqAxM328y+l7
# vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDUDCC
# AjgCAQEwgfmhgdGkgc4wgcsxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n
# dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y
# YXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJzAl
# BgNVBAsTHm5TaGllbGQgVFNTIEVTTjpBOTM1LTAzRTAtRDk0NzElMCMGA1UEAxMc
# TWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsOAwIaAxUAq2mH
# 9cQ5NqzJ1P1SaNhhitZ8aPGggYMwgYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UE
# CBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9z
# b2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQ
# Q0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAOl0aJwwIhgPMjAyNDAyMTIwOTUxMjRa
# GA8yMDI0MDIxMzA5NTEyNFowdzA9BgorBgEEAYRZCgQBMS8wLTAKAgUA6XRonAIB
# ADAKAgEAAgItuQIB/zAHAgEAAgIT/zAKAgUA6XW6HAIBADA2BgorBgEEAYRZCgQC
# MSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYagMA0GCSqG
# SIb3DQEBCwUAA4IBAQAEn7XGAcba+00JpDuImk+yxSvNtcVnuFZHwzlnxkHPeqq/
# iXGDMMdtjBY37VZLFghDsAblhz8MlMPbH+x0LjuHH1RLk/12N7/8k5pGE3CQzM/o
# 6kJXy9dDUgPsYX0lgYr54BJ4aSHJfQMIBZGI1YH7whpXqWij43QuoJIn7J/puKW+
# s9CmMJuUEMhy9Kv0yxTr35WeI8b7w8z33GK83+J2FtoDZGYuNcNzhbB5Iu4t5J+L
# yf6WvYXvNOsjwD8Hg7FSRS87QbtmxcXCv/mrcklnohUIhRBoV4MTRTskmjm5p22j
# 6hPcfxjYRSTDqnln3VV6hp2FYjRp8uZ4AxFfvgWfMYIEDTCCBAkCAQEwgZMwfDEL
# MAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1v
# bmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWlj
# cm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAHpD3Ewfl3xEjYAAQAAAekw
# DQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0BCRABBDAv
# BgkqhkiG9w0BCQQxIgQgNIwgWdNZZyuwQ1nujQyC1dQDbzJcsi2i0LugG5sX9wow
# gfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCCkkJJ4l2k3Jo9UykFhfsdlOK4l
# aKxg/E8JoFWzfarEJTCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX
# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg
# Q29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAy
# MDEwAhMzAAAB6Q9xMH5d8RI2AAEAAAHpMCIEIEvuuwh53GZXFDr89wDnAkDzQPid
# 5ZrJ8dezDouZmqH9MA0GCSqGSIb3DQEBCwUABIICACLmbSjER6gD/pLf7ubrlHKa
# QbZl+fwwfzynaeygD0dNELvVXsD50IXJgfT7mFaGLvgA68mmWCEUmgOg+Rh0VobA
# jcxOTPS9gO+DgASibfqeiRQgV1b0VbWMVwm+lcBUZHkGkDa29/RotoG7G4mj97eU
# Bv6jpjuPtoufw+9Ko5NtG8D3/qZep+24eR3/5kpX37fbaSKLNd5kD9JjatQlsmRd
# xpxPvr6Z7nn9c/cr3JEXlgWhwpk9j0qDa6IR3Wl+rS3krqx6NQ6AfrUxnbyU9Wfo
# vbWasLfcn7SH6YNLglhGXG3r9QhZHL1qQyCS88xNXfKExKPDqzY6ur4xCE6mMrWN
# kGPaW1RNlcCnQiJ3UgZEcTTfD05MZ9lcNUQ9PsgO71F0eFrSOk4jssoBRC8suvS1
# P86eRJNaNF5hhQ4S1RELLkgODKWnYBYhM3AcgRF9l+SO+7FnHr1wG4mOY/l7svgO
# X3ITl83fJ/r6rGWWiMvWO3rbWvugS5C6BcTffNQU5UpfTGpJfWmqDCxjLGkS4G3e
# atf3tVAppqvYfnQLJbm4XiU2/2zJbxdqfBofBN7Wd7WOuh67pU6pAn/LMsz4CEBN
# 1vjAyfj2EHqpBWqf4eA8PPofPUeIvOLTqGBIPFoHykM9tS1XEy1MlRa9i9KSIW6G
# O8oC+uHTE0+7nVDQ+y5a
# SIG # End signature block