Private/Docs/Get-AvmBicepDocsCustomValue.ps1
|
function Get-AvmBicepDocsCustomValue { [CmdletBinding()] [OutputType([hashtable])] param( [Parameter(Mandatory)] [string] $ModulePath, [Parameter(Mandatory)] [string] $ToolPath, [Parameter(Mandatory)] [string] $RepositoryRoot, [System.Collections.Generic.Dictionary[string, object]] $CompiledTemplateCache ) Set-StrictMode -Version 3.0 $ErrorActionPreference = 'Stop' $items = @(Get-ChildItem -LiteralPath $ModulePath -Force) $readmes = @($items | Where-Object { $_.Name -ieq 'README.md' }) $sidecars = @($items | Where-Object { $_.Name -ieq 'README.notes.md' }) foreach ($file in @($readmes + $sidecars)) { if ($file.PSIsContainer -or ($file.Attributes -band [System.IO.FileAttributes]::ReparsePoint) -or ($file.Name -cne 'README.md' -and $file.Name -cne 'README.notes.md')) { throw [AvmConfigurationException]::new( "Bicep documentation needs exactly cased, regular README files in '$ModulePath'.") } } if ($readmes.Count -gt 1 -or $sidecars.Count -gt 1) { throw [AvmConfigurationException]::new( "Bicep documentation found ambiguous README files in '$ModulePath'.") } $utf8 = [System.Text.UTF8Encoding]::new($false, $true) $notes = '' if ($sidecars.Count -eq 1) { $bytes = [System.IO.File]::ReadAllBytes($sidecars[0].FullName) if ($bytes.Length -ge 3 -and $bytes[0] -eq 0xef -and $bytes[1] -eq 0xbb -and $bytes[2] -eq 0xbf) { throw [AvmConfigurationException]::new( "Bicep Notes sidecar must be UTF-8 without BOM: $($sidecars[0].FullName)") } try { $notes = $utf8.GetString($bytes) } catch [System.Text.DecoderFallbackException] { throw [AvmConfigurationException]::new( "Bicep Notes sidecar must contain valid UTF-8: $($sidecars[0].FullName)") } if ($notes.Contains("`r")) { throw [AvmConfigurationException]::new( "Bicep Notes sidecar must use LF line endings: $($sidecars[0].FullName)") } } elseif ($readmes.Count -eq 1) { $bytes = [System.IO.File]::ReadAllBytes($readmes[0].FullName) try { $existing = $utf8.GetString($bytes) } catch [System.Text.DecoderFallbackException] { throw [AvmConfigurationException]::new( "Bicep README must contain valid UTF-8: $($readmes[0].FullName)") } if ($null -ne (Get-AvmLegacyReadmeNote -Content $existing)) { throw [AvmConfigurationException]::new( "The README in '$ModulePath' has authored Notes but no README.notes.md. Move the Notes body into a README.notes.md sidecar before generating documentation; documentation generation never copies Notes from an existing README.") } } $banners = @{} foreach ($name in @('DEPRECATED.md', 'MOVED-TO-AVM.md')) { $bannerMatches = @($items | Where-Object { $_.Name -ieq $name }) if ($bannerMatches.Count -gt 1) { throw [AvmConfigurationException]::new( "Bicep documentation found ambiguous '$name' files in '$ModulePath'.") } $lines = @() if ($bannerMatches.Count -eq 1) { $file = $bannerMatches[0] if ($file.PSIsContainer -or $file.Name -cne $name -or ($file.Attributes -band [System.IO.FileAttributes]::ReparsePoint)) { throw [AvmConfigurationException]::new( "Bicep documentation needs a regular, exactly cased '$name' in '$ModulePath'.") } try { $lines = [System.IO.File]::ReadAllLines($file.FullName, $utf8) } catch [System.Text.DecoderFallbackException] { throw [AvmConfigurationException]::new( "Bicep documentation banner must contain valid UTF-8: $($file.FullName)") } } $banners[$name] = ConvertTo-Json -InputObject $lines -Compress } $normalized = [System.IO.Path]::GetFullPath($ModulePath).Replace('\', '/') $reference = [regex]::Match($normalized, '(?:^|/)(avm/(?:res|ptn|utl)/.+)$') $moduleReference = if ($reference.Success) { $reference.Groups[1].Value } else { '' } $segments = $moduleReference.Split('/') $moduleName = if ($segments.Count -ge 4) { $segments[3] } else { [System.IO.Path]::GetFileName([System.IO.Path]::GetFullPath($ModulePath)) } $specialNames = @{ 'public-ip-addresses' = 'publicIPAddresses' 'public-ip-prefixes' = 'publicIPPrefixes' } if ($specialNames.ContainsKey($moduleName)) { $symbol = $specialNames[$moduleName] } else { $nameParts = $moduleName.Split('-', [System.StringSplitOptions]::RemoveEmptyEntries) $symbol = $nameParts[0].ToLowerInvariant() for ($index = 1; $index -lt $nameParts.Length; $index++) { $symbol += [cultureinfo]::GetCultureInfo('en-US').TextInfo.ToTitleCase($nameParts[$index]) } } $headerType = '' if ($segments.Count -ge 4 -and $segments[1] -in @('ptn', 'utl')) { $textInfo = [cultureinfo]::GetCultureInfo('en-US').TextInfo $parent = $textInfo.ToTitleCase(($segments[2] -replace '[^0-9A-Z]', ' ')) -replace ' ' $childName = $segments[3..($segments.Count - 1)] -join ' ' $child = $textInfo.ToTitleCase(($childName -replace '[^0-9A-Z]', ' ')) -replace ' ' $headerType = "$parent/$child" } $metadataPath = Join-Path $ModulePath 'metadata.json' if ([System.IO.File]::Exists($metadataPath)) { try { $metadata = $utf8.GetString([System.IO.File]::ReadAllBytes($metadataPath)) | ConvertFrom-Json -AsHashtable -ErrorAction Stop } catch { throw [AvmConfigurationException]::new( "Cannot read Bicep module metadata '$metadataPath': $($_.Exception.Message)") } if ($metadata -isnot [System.Collections.IDictionary]) { throw [AvmConfigurationException]::new( "Bicep module metadata must contain a JSON object: $metadataPath") } if ($metadata['canonicalType'] -is [string] -and -not [string]::IsNullOrWhiteSpace($metadata['canonicalType']) -and $segments.Count -ge 4 -and $segments[1] -eq 'res' -and $metadata['canonicalType'] -cne 'helper') { $headerType = $metadata['canonicalType'] } } $typelessOutputs = @() $compiledPath = Join-Path $ModulePath 'main.json' $sourcePath = [System.IO.Path]::GetFullPath((Join-Path $ModulePath 'main.bicep')) $cached = if ($null -ne $CompiledTemplateCache -and $CompiledTemplateCache.ContainsKey($sourcePath)) { $CompiledTemplateCache[$sourcePath] } else { $null } if ($null -ne $cached) { $compiled = $cached.Template } else { $compiledJson = if ([System.IO.File]::Exists($compiledPath)) { $utf8.GetString([System.IO.File]::ReadAllBytes($compiledPath)) } else { Get-AvmBicepCompiledJson -SourcePath $sourcePath -ToolPath $ToolPath } try { $compiled = $compiledJson | ConvertFrom-Json -AsHashtable -ErrorAction Stop } catch { throw [AvmConfigurationException]::new( "Cannot read compiled Bicep module '$compiledPath': $($_.Exception.Message)") } } if ($compiled -isnot [System.Collections.IDictionary]) { throw [AvmConfigurationException]::new( "Compiled Bicep module must be a JSON object: $compiledPath") } $descriptionSuffix = '' if ($compiled['metadata'] -is [System.Collections.IDictionary] -and $compiled['metadata'].Contains('description')) { if ($compiled['metadata']['description'] -isnot [string]) { throw [AvmConfigurationException]::new( "Compiled Bicep description must be a string in '$compiledPath'.") } $descriptionSuffix = [regex]::Match( $compiled['metadata']['description'], '\n+$').Value } if ($compiled['outputs'] -is [System.Collections.IDictionary]) { $typelessOutputs = @($compiled['outputs'].psbase.Keys | Where-Object { -not $compiled['outputs'][$_].ContainsKey('type') }) } $resourceTypes = @(Get-AvmBicepDocsResourceType -Template $compiled) if ($segments.Count -ge 4 -and $segments[1] -eq 'res') { $slug = $segments[-1].Replace('-', '').Replace('_', '').ToLowerInvariant() $names = [System.Collections.Generic.HashSet[string]]::new( [System.StringComparer]::OrdinalIgnoreCase) $null = $names.Add($slug) $null = $names.Add($slug + 's') if ($slug.EndsWith('y', [System.StringComparison]::Ordinal)) { $null = $names.Add($slug.Substring(0, $slug.Length - 1) + 'ies') } $matchingTypes = @($resourceTypes | Where-Object { $lastSegment = ($_.Type -split '/')[-1].Replace('-', '').Replace('_', '') $names.Contains($lastSegment) } | Select-Object -ExpandProperty Type -Unique) if ($matchingTypes.Count -eq 1) { $headerType = $matchingTypes[0] } } $roleNames = Get-AvmBicepDocsRoleName -Template $compiled -SourcePath $compiledPath $compiledDetails = Get-AvmBicepDocsCompiledParameter ` -Template $compiled -SourcePath $compiledPath $references = @(Get-AvmBicepDocsReference -ModulePath $ModulePath -RepositoryRoot $RepositoryRoot) $compiledParameters = if ($compiled['parameters'] -is [System.Collections.IDictionary]) { $compiled['parameters'] } else { @{} } $compiledOutputs = if ($compiled['outputs'] -is [System.Collections.IDictionary]) { $compiled['outputs'] } else { @{} } $requiredParameters = @( if ($null -ne $cached) { $cached.Required } else { Get-AvmBicepDocsRequiredParameter -Template $compiled -SourcePath $compiledPath } ) if ($null -ne $CompiledTemplateCache -and $null -eq $cached) { $CompiledTemplateCache[$sourcePath] = [pscustomobject]@{ Template = $compiled Required = [string[]]$requiredParameters } } $examples = Get-AvmBicepDocsExample -ModulePath $ModulePath ` -RepositoryRoot $RepositoryRoot -ToolPath $ToolPath ` -CompiledTemplate $compiled -RequiredParameters $requiredParameters ` -CompiledTemplateCache $CompiledTemplateCache $scopeChildren = @($items | Where-Object { $_.PSIsContainer -and $_.Name -clike '*-scope' } | Sort-Object -Culture 'en-US' -Property Name | ForEach-Object { if ($_.Attributes -band [System.IO.FileAttributes]::ReparsePoint) { throw [AvmConfigurationException]::new( "Bicep documentation does not follow linked scope directories: $($_.FullName)") } $_.Name }) return @{ moduleReference = $moduleReference moduleSymbol = $symbol headerType = $headerType descriptionSuffix = $descriptionSuffix isVersioned = if ([System.IO.File]::Exists((Join-Path $ModulePath 'version.json'))) { 'true' } else { 'false' } typelessOutputs = '|' + ($typelessOutputs -join '|') + '|' resourceTypes = ConvertTo-Json -InputObject $resourceTypes -Compress -Depth 5 roleNames = ConvertTo-Json -InputObject $roleNames -Compress -Depth 5 references = ConvertTo-Json -InputObject $references -Compress -Depth 5 compiledParameters = ConvertTo-Json -InputObject $compiledParameters -Compress -Depth 99 compiledOutputs = ConvertTo-Json -InputObject $compiledOutputs -Compress -Depth 99 compiledDetails = ConvertTo-Json -InputObject $compiledDetails -Compress -Depth 50 examples = ConvertTo-Json -InputObject $examples -Compress -Depth 99 scopeChildren = ConvertTo-Json -InputObject $scopeChildren -Compress deprecatedLines = $banners['DEPRECATED.md'] movedLines = $banners['MOVED-TO-AVM.md'] hasNotes = if ($sidecars.Count -gt 0) { 'true' } else { 'false' } notes = $notes } } # SIG # Begin signature block # MIInQQYJKoZIhvcNAQcCoIInMjCCJy4CAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCgg9igfbSWIYQ+ # S9Mg89MEff0NrOc5hhu9Fn3pLy1426CCDLowggX1MIID3aADAgECAhMzAAACHU0Z # yE7XD1dIAAAAAAIdMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD # VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD # b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQzWhcNMjcwNDE1MTg1 # OTQzWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE # BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD # VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB # DwAwggEKAoIBAQDQvewXxx9gZZFC6Ys1WBay8BJ8kGA4JQnH5CMafqOASlTpK9H8 # o5ZXTXt0caVQTNMUPt445wXYD+dFtaKWTwDn1I52oUSrC9vJin1Gsqt+zyKJL5Dg # 3eQXbQNR61DmMy20GLTIO3SFed9Rfi/ophgCLGFLDR3r0KvHjwMb/jYWS0celV/4 # Lz27LfAekm8v9E5IXaeiXbAUYZKK090n4CVl3JBtbN+9DtI9SNu/yjvozW52/u7R # X/Ttpa/KDlpuokZ+Zcbvmtd9ur9gFLvZzh41o9MsE/clQtdaFWGvuo6Jua/ntpgk # ey3E5/vBFe+MJPG6phdnuo6r57ZudCudiI1bAgMBAAGjggGbMIIBlzAOBgNVHQ8B # Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O # BBYEFH6QuMwqcPG0hQlQ6c5jCtTTLrVeMEUGA1UdEQQ+MDykOjA4MR4wHAYDVQQL # ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xFjAUBgNVBAUTDTIzMDAxMis1MDc1NTkw # HwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEwYAYDVR0fBFkwVzBVoFOg # UYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0 # JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNybDBtBggrBgEFBQcBAQRh # MF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv # Y2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy # dDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4ICAQBKTbYOjzwTG/DXGaz9 # s6+fQeaTtDcFmMY+5UyVFCyj7Pv+5i37qfX8lSL/tBIfYQfWsMuBQlfZurJD6r4H # VJ2CeH+1fgiq8dcHdVKoZ3Sa2qXoX3cq9iS8cVb06B7+5/XJ7I0OxHH9fDsvJ3T3 # w5V/ZtAIFmLrl+P0CtG+92uzRsn0nTbdFjOkLMLWPLAU3THohKRlSEMgFJpPkm5n # 5UAZ35xX6FWCrDLsSKb555bTifwa8mJBwdlof0bmfYidH+dxZ1FdDxvLnNl9zeKs # A4kejaaIqqIPguhwAti5Ql7BlTNoJNwxCvBmqW2MQLnCkYN/VVUsR3V2x/rcTNzo # Bf/Z/SpROvdaA2ZOOd1uioXJt3tdLQ7vHpqpib0KfWr/FWXW10q38VxfCnRQBqzb # SuztR7nEMuzX7Ck+B/XaPDXd1qh72+QYyB0Z2VzWmO9zsnb9Uq/dwu8LGeQqnyu6 # 7SDGACvnXii2fb9+US492VTnXSnFKyqwgzUyFMtZK1/sHYTv6bG4TtQUygQxTN+Z # V+aJIlKO2MqZ7bKrAnOzS9m6NgoTdWOq11bTOZwKlIEV/EhV9SWkDmdpR/hPPT2v # 6TEj4F8PT/zHjRezIU5c/DGlt/VhY/pK0XkJtEyMmmS1BMtjU/rqBZVMIm3dnxQs # /TBByr+Cf8Z1r7aifQVQ+WSqzjCCBr0wggSloAMCAQICEzMAAAA5O7Y3Gb8GHWcA # AAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX # YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg # Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl # IEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoXDTM2MDMyMjIyMTMwNFow # VzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEo # MCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAyNDCCAiIwDQYJ # KoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeqlRYHNa265v4IY9fH8TKh # emHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo0dtS/EW6I/yEL/bLSY8h # KpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATvQVL4tcf03aTycsz8QeCd # M0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a1uv1zerOYMnsneRRwCbp # yW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1FyQfK0fVkaya8SmVHQ/t # Of23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfOGSWHIIV4YrTJTT6PNty5 # REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7ttOu1bVnXfHaqPYl2rPs # 20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJuz2MXMCt7iw7lFPG9LXK # Gjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxSCwyoGIq0PhaA7Y+VPct5 # pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOmVQop36wUVUYklUy++vDW # eEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3SkE/xIkgpfl22MM1itkZ # 35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8EBAMCAYYwEAYJKwYBBAGC # NxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPXLQaUEggxMBkGCSsGAQQB # gjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU # ci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDovL2Ny # bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0MjAx # MV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKGQmh0 # dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0MjAx # MV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOCAgEAFJQfOChP7onn6fLI # MKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D5W4wMwYeLystcEqfkjz4 # NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBYnbu0+THSuVHTe0VTTPVh # ily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSIvgn0JksVBVMYVI5QFu/q # hnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6aR9y34aiM1qmxaxBi6OU # nyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4wPKC5OmHm1DQIt/MNokbb # H3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7RTX8AdBPo0I6OEojf39z # uFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK/fg8B2qjW88MT/WF5V5u # vZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSKYBv0VisCzfxgeU+dquXW # 9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkwYTu/9dLeH2pDqeJZAABV # DWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVTQl0v4q8J/AUmQN5W4n10 # 1cY2L4A7GTQG1h32HHAvfQESWP0xghndMIIZ2QIBATBuMFcxCzAJBgNVBAYTAlVT # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv # c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w # DQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJ # KoZIhvcNAQkEMSIEIGIbs9IJ6igKC0DrpwVHFmK/rBhaxv9/Tn2ARJKtifA8MEIG # CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v # d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEASZATDdnPs61fVI0B # AcX4Akx5mvOFi3ec6wtr8XPSXAIVALSx8nVuu5G2y9P3Swu/aenvB8EXACARrSQY # 0AVnv+PadLTmOviArf3vqsdQuBLF+DbwAvUPpPDlKAE1niGDeCZ4Kra0NeGqKzsG # TeVvNk8KA3LT8Au7adj2sKKJRKi1du7CXl7+b87tR0ehf/velQdSslEeNiQuI8VK # w/lF8+B40I6TWLqM5Sj4q3Ro3YjeKbCiF9Qvt7Xg4YboxyS3NIuXB1EiXqJ68DNL # 7MGQBe0TsiqV98rYDkfHGkVhYhzp7TFdMUTvxHJ91bK2sBTUsotIJWuk9C8YVsU3 # ldPbtKGCF60wghepBgorBgEEAYI3AwMBMYIXmTCCF5UGCSqGSIb3DQEHAqCCF4Yw # gheCAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFF # MIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCCJbxgJc4wj5HDN # X1gmPEmoif2QIcxXP3tI63UeOGIS+AIGavNNX/U2GBMyMDI2MTExNjE2MDYyOC44 # NTlaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExp # bWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo0MzFBLTA1RTAtRDk0NzEl # MCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEfswggcoMIIF # EKADAgECAhMzAAACNZsWed5GYdQrAAEAAAI1MA0GCSqGSIb3DQEBCwUAMHwxCzAJ # BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jv # c29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI2MTAxNTE4Mzc0M1oXDTI4MDEx # MTE4Mzc0M1owgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # LTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEn # MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjQzMUEtMDVFMC1EOTQ3MSUwIwYDVQQD # ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEF # AAOCAg8AMIICCgKCAgEAvA2sNh2bPpbdonwoPppQdy7rBQU2AYvZmVhKyXoLox21 # OwvocY4P+BvqLOAtL67cWoekZxO9MMZ66lvqROg6EI8fsWbHn+OT/RYZps9h4drA # IPhiE3fUzjwVM3XdZ90VvxutuVbCaj0z2xAbfGJnC1emXUNnZ/1BR85NvWen44bC # rJYtghstvh4So+UpUZg2ZdVDpR1n7spqnkG5hJBwK1pSom46V/SwisMIhfcY7Ie8 # 9Na9TJ5S47U1Nwf9JWEdrFLsCwrnh+65fAdfOzGy9oBdjSn/HEBE4H/7mgHIO+vk # x2/q2TRWjNdSIi2Sj+THCRPZe+c+LBM925/pncGt42JE/gH1QcAKtF6x0sLIh9yy # UfJZom5ZiD5s4aq/QDxEQZLA1UcWHIqFc5z+Aartxjre04B3bvwiVC6C5Yt7yxgz # ZHsQlLsOoVKPwS2fO2yA5XWNEKpuomBjICT9owmvSW/dpVGSwbypHDZt5kWO3PrN # iOTjpQXijznyE5bXFi9JlQF5Bm/BaF2Sxg7sLHstgxpP5SYoRoBjOPLqVWqtQfGE # G7G1qxJL0YfaFnhWM8U0M90oQvV5jeGwAYq+ArsvGsYAV8r2po/xCK8R7eaNTzL5 # cjPzt23S0AO224NZnGmqm5G/QXVQOX3YI/NvqSoH6kYUmqmx6n22W9B7vq9jGYUC # AwEAAaOCAUkwggFFMB0GA1UdDgQWBBQwSUMAYtxdCS9tvQtArQCayL3kLDAfBgNV # HSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5o # dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBU # aW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwG # CCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRz # L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNV # HRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIH # gDANBgkqhkiG9w0BAQsFAAOCAgEApX6cT9hL8p3gSnGdvnoPm07DiccGrmj2SFZY # aPRyraviUBiKmjVy3jLXKQT0Mfbzkf8zfm5l2kr0YFQ9JW/LB/zt4p4cIVCAe+Ed # oxIJVzTGeLDkHDcvmZqhIFeh33uPrbtX9HQc5QU5TpOWute7AfohT6tqTblNLlz5 # OLKVKFEJBQGFh/Mnw2t9ZLeCm4Gf1DeZ1sWNft/rHbzkwudXBh280BFKVG3AoyHb # OMo3W5GwAyVq7IAAI39QcThuYKxNHPoVrL36WHcyfjk9eIDz6GMQhOoWI7MdgQHr # 0jOf9UQHWhN0jG6pBMKnfgPWFXUL6XlHCGYROaETJVxpzmmKQblHmWmnCTYNWb0Q # PWiQb5ZNNYD+zWI6KcpsGcRC6cYITgwYw+OfjejWV4wQW6V5mvN7e87RSMMjcMtR # Foy8FULlM8l/B6hlnFiBbrCO24X57A0SO1TTFPn3dSx/37bjhI9ABaHuiGZlDe9I # jsEVLTzfOdE59i9ZhooyUsO/ceSZp4x0Icw3PJzq1r4/1AOlG8mQDbCsddauUM6n # 8VSfq8rBJCdqdrcWpRqUerFnyAp0S+97C0YfBsaVpXUGVBPfqF+KwKlGGjxP32s3 # qcUiTM8Mqt1OwRbp66d6k4/8XXLPrfqx1StgUwDjd/N8vzMPFj1pDYt1GiVXwjKN # NvnRei8wggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3 # 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/2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDVjCC # Aj4CAQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExp # bWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo0MzFBLTA1RTAtRDk0NzEl # MCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsO # AwIaAxUAWss3eoS1rlla0gVyedUYK2xMzzCggYMwgYCkfjB8MQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt # ZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAO6lC1owIhgPMjAyNjEx # MTYwNDU1NTRaGA8yMDI2MTExNzA0NTU1NFowdDA6BgorBgEEAYRZCgQBMSwwKjAK # AgUA7qULWgIBADAHAgEAAgIC3zAHAgEAAgITkjAKAgUA7qZc2gIBADA2BgorBgEE # AYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAIDAYag # MA0GCSqGSIb3DQEBCwUAA4IBAQAcK8nhHZkvpIcZxn6rmkLH1Kw4WwK0d313+t9e # sc7I+iRafSGnhoP3anjFx2x3Ztu4nHZx740HOj7K8iz/JLfiGA0xI0J6nDVKFBkC # +4na2wMbot8hZsDy3KaXWdaqX8QQ09yW9k8HSAJEuZn+gN97gwRHEixddne+vcVo # eQCKgnGnYu7eIjibnS6VKrGEb6fNqA3A7mXs6YS0BXRLdGDKxvOCPpIIszx4hyv1 # LbwyBZULk6b2Dmgkunkx2qtAmRWOf5wEabTotk7YX2ATzzA9m4CAs/iSoDAdDLL6 # 2U1R5LTVY/UhnZKcYSVl6cVv4MmnG4KMyu1lUueWhV+D9D/LMYIEDTCCBAkCAQEw # gZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcT # B1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UE # AxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAI1mxZ53kZh1CsA # AQAAAjUwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG9w0B # CRABBDAvBgkqhkiG9w0BCQQxIgQgQ6TNRy4UTw7UhC9GJacdJp5cTrpvI/pgi+nG # 9s6LGO8wgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCC0prgqLL0fJ/QFvLoA # JjPkKYKBTfY+qqYaz/ZOSnMQyjCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMwEQYD # VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy # b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w # IFBDQSAyMDEwAhMzAAACNZsWed5GYdQrAAEAAAI1MCIEIJl91Fb3hpt1XzWQ6m1w # AVVsMYmZPhaI5ruGm+EMrE8DMA0GCSqGSIb3DQEBCwUABIICACuE3d2yXrUQtKGS # SAxede2l44g8zwPDQmawVCzV6M1YGoTbczg/eBkUwSPGKh6RJKdUzdfB22nQFMNl # pKU5gt5I/0oaxRr/zVikNPbuUIRK4ZRm3rt9hLYROTD+kw51HX6NOf6aN+jhR2xD # C6B5m5YtF65wQEt/wiJ1CI+Fnf4i6lhdk7KxG6/c/Js1mqpQQE6VZAj/2F0mGRnS # H5d7SYskV3YcKf4VnnV8Ici+XMLLRoAs6NYKt3n7TlyEKxNNNCNgdN6f4m/xQS3x # j/nd2B2UqnLhpgk6WX4qaiwh2EukoEv3jfDurIG4t6Ex2gfQu8SQDcqiVMLIwJwm # pELCITzLOzMwEKNcb7rP/5gCBrtGX6aZ6QiQV3EgGLKYA73rOXOnOnywFLTjGbvr # 6ACIcCi+Ygv6dINxoxxROZScYGd0RTPRNj74U1D1vehp2WhKURXZXf0u38kBHtVr # pNrUUoFNKvS3yONBOWpV5dOw9BRHphJ5XXCzDfcMigavZEshL++3fI1gjCtBfJ5k # CJoA8yhA8TqXQVD3IAY+zVS28XLYyS3zkeZMRocnAd3PTaEzvhT4zitVmuABbQtI # JpF+Ajf/VD0VLktnd+CaJllIUYFwFGZf5XrBEFyuFnUPoirvxXBthGoVa8I8BgT8 # fdW23Q5tpbdy9hwtHfyCNA6N8sgJ # SIG # End signature block |