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 # MIInRAYJKoZIhvcNAQcCoIInNTCCJzECAQExDzANBglghkgBZQMEAgEFADB5Bgor # 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 # 1cY2L4A7GTQG1h32HHAvfQESWP0xghngMIIZ3AIBATBuMFcxCzAJBgNVBAYTAlVT # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv # c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w # DQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJ # KoZIhvcNAQkEMSIEIGIbs9IJ6igKC0DrpwVHFmK/rBhaxv9/Tn2ARJKtifA8MEIG # CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v # d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEASZATDdnPs61fVI0B # AcX4Akx5mvOFi3ec6wtr8XPSXAIVALSx8nVuu5G2y9P3Swu/aenvB8EXACARrSQY # 0AVnv+PadLTmOviArf3vqsdQuBLF+DbwAvUPpPDlKAE1niGDeCZ4Kra0NeGqKzsG # TeVvNk8KA3LT8Au7adj2sKKJRKi1du7CXl7+b87tR0ehf/velQdSslEeNiQuI8VK # w/lF8+B40I6TWLqM5Sj4q3Ro3YjeKbCiF9Qvt7Xg4YboxyS3NIuXB1EiXqJ68DNL # 7MGQBe0TsiqV98rYDkfHGkVhYhzp7TFdMUTvxHJ91bK2sBTUsotIJWuk9C8YVsU3 # ldPbtKGCF7AwghesBgorBgEEAYI3AwMBMYIXnDCCF5gGCSqGSIb3DQEHAqCCF4kw # gheFAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG9w0BCRABBKCCAUkEggFF # MIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCCJbxgJc4wj5HDN # X1gmPEmoif2QIcxXP3tI63UeOGIS+AIGavNMZ1crGBMyMDI2MTExODE0MDM1Mi4x # MTlaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExp # bWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjozMjFBLTA1RTAtRDk0NzEl # MCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEf4wggcoMIIF # EKADAgECAhMzAAACLD5lujjFQzAsAAEAAAIsMA0GCSqGSIb3DQEBCwUAMHwxCzAJ # BgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25k # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jv # c29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI2MTAxNTE4MzczMFoXDTI4MDEx # MTE4MzczMFowgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw # DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x # LTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJhdGlvbnMgTGltaXRlZDEn # MCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjMyMUEtMDVFMC1EOTQ3MSUwIwYDVQQD # ExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIICIjANBgkqhkiG9w0BAQEF # AAOCAg8AMIICCgKCAgEA5gm6XJ6k0U1gZrEItXrJw6heQU8Pdc8N+9ehJOoPF/3b # WtjjiqihiueL/4fAcnE6Uswy9Bd6p7B7Dj1RN/qE7vyO1V4tp4Vjzv2YXYZ6GOqT # 6WmpgQia5e+PM+2Z65iv9XHCH/5tPTF725BPCsd/FTC+39xbVlEVbK3Y8vjVT6Xc # SWcB7h9Y3lZvoGkDNYgxZPGaxasA2Ovnzs3NeoZJVG0kU768+wAVlqgYdqhODoJB # sjaLhkKaM4/zHvMqD3zpi//y5V6/RdByJ/HQks4c8dC/6q4ZAciPcmO8Ar8223CR # yHHbqabU5cvAAl6fhaIy6lzOEGkFMn/JKgPlKFyTrQQcLIFDQqFzR9Qr4XumDduW # Ewx9ukvXX2NFIjM1OEC7tji0fKhq7UdVwvsYdMmQXhJT1iFPiCveBXR0WH8YbTSl # +oNV5tCBM+iSEsOi4haV+WuOdMLUXayZq2+we/Hv95laxGVvdpmm4gCIpqSV0Iba # ZRzjx3g0lETBm7QC7gfwkBBPYmtr4IlGa4+uNGpy7IHpGA6M+oYo5JNDuZY/4d3d # zaUC/6ju41Bze+s7JW4LVyqh1s+eL0AlxHRgpoARoGzM8OF/CvaWxuIHjho9ZOd+ # daroFxMdQXYJY3oXgwALxu1RI1rJBRbrZn+poW3HXfapA6IUIvbtuWndDeW0TwEC # AwEAAaOCAUkwggFFMB0GA1UdDgQWBBQnQwSwc37Wcpo4pSa2oXXhfOB6ATAfBgNV # HSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNVHR8EWDBWMFSgUqBQhk5o # dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NybC9NaWNyb3NvZnQlMjBU # aW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYIKwYBBQUHAQEEYDBeMFwG # CCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2NlcnRz # L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNydDAMBgNV # HRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMIMA4GA1UdDwEB/wQEAwIH # gDANBgkqhkiG9w0BAQsFAAOCAgEABBz1+ZhL6yC4p9GKUdeWarzTZ1xDvkYqAnhW # ZihJdtkFdaM9xd5WxyK2/J42q1m6FDCBymBY/vgfjKWA2/E6CafohJHfNG83fdle # IC+q4P7xCw3XY5+rczR6ytZvHADuOSlGyatjiduzoqTgCT864L4iZpA9nQSh8cbE # gA1MNPLFK63gZaxsPkfx6CxEE4LBBc5uf4uu8LCb4GQrYP+f52DNolnbqsQg0/q7 # d8cuj8nqLIndG1gjKLI7RFCzwK/TGeLAhznyzD67T5T7Bug0Kabh1/Ij5T9wlSbf # +EzKWZLbwi5HADnjVvUuCBJMS2hdskQRm99edGFSXtE9tM+daFjb70daiwGFkW6Z # r5NWsXnfTTifdWhw5HJuIKOgIK7GTZIauJPY1yHG8UaR3HTfyNwL9FNOpfWf2RL2 # X7jEIES1KxxwZK519ikphKG6lP/c3ouIFYEjIkim3a3m/MqUWrEZlfnv/FXka5Wf # Wat03KibyN9tZzU1vuHdORrTUfts8Z5qSJmNndoe0sXqoSFooLaQw0LGN0nxox5m # 9fPzMD9yqvzQyEm907nPADqoZLoWbjsapNFb82g4W+oZLCdNC5jaz47TL2s+5EqE # 5IJDG4xf6ZyKnqgwt+gnTyw2cnjR3YF4O8tA8RZz6N2EikP816iTuSsAadeLHYQI # 6zpBfVMwggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZAAAAAAAVMA0GCSqGSIb3 # 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/2XBjU02N7oJtpQUQwXEGahC0HVUzWLOhcGbyoYIDWTCC # AkECAQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExp # bWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjozMjFBLTA1RTAtRDk0NzEl # MCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaIjCgEBMAcGBSsO # AwIaAxUAHhea24tUJySTx61iIZTFJ2kXoFOggYMwgYCkfjB8MQswCQYDVQQGEwJV # UzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UE # ChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGlt # ZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIFAO6nrR0wIhgPMjAyNjEx # MTgwNDUwMzdaGA8yMDI2MTExOTA0NTAzN1owdzA9BgorBgEEAYRZCgQBMS8wLTAK # AgUA7qetHQIBADAKAgEAAgIWIgIB/zAHAgEAAgITEzAKAgUA7qj+nQIBADA2Bgor # BgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIBAAIDB6EgoQowCAIBAAID # AYagMA0GCSqGSIb3DQEBCwUAA4IBAQC/TNciJHVUNvP8427CgcL1dy+5DVlLUO3v # 5ZKRT6W4IkrBHuYdfzgtLDTzpAfgdOhO7zi2qUNSOODBUNk5cgjn13L7xz/WOKrv # J9S49Ag4Iu197lfjAbzreySePqq9hcE5l2R58NalkcQQQ4NkSxDFjFWAjK7i9x1L # gRk/B+IpGxfqyr4bGQMQ20bglVmlMMApvfT5YBREdXRVSENRb7FXNjUxtZmi26T2 # RgZrDbguzKya7MIROq2lLWOdixKeHUBPauQrv1ZEGZBtpC3FNyyLlI+fFVdP+sZ0 # Q28YzOfuDf0+zsoEca2VbGSyexXmku/lO7xHLb9/gsGDOPvHdyneMYIEDTCCBAkC # AQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNV # BAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQG # A1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTACEzMAAAIsPmW6OMVD # MCwAAQAAAiwwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqGSIb3DQEJAzENBgsqhkiG # 9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgxLL3JaU7zajOaZkcZkhTZgjraptEIBOa # P4aAU0Fx2hYwgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHkMIG9BCD17qs1bMdkda9v # oe4Qotug9uW9KBAUHND8HpjvjtlhPjCBmDCBgKR+MHwxCzAJBgNVBAYTAlVTMRMw # EQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVN # aWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0 # YW1wIFBDQSAyMDEwAhMzAAACLD5lujjFQzAsAAEAAAIsMCIEIP6KeO4cT8svkut6 # hLG0ycOQbSY7ASQUKgopAJERHofhMA0GCSqGSIb3DQEBCwUABIICAA6aSsELtqm9 # q5kYIelAryxLjR8GUtwtXJvBUe85Oc1XAR7PaX8d4UQCnsyCs1FbsMaE7FlnuFO4 # CCewDcghS4mxCzyNrBdjPfjNialoKp9/hfFgM4FvK8HFTWQAfLl46GL6FUaTmR39 # Tff7qRJUYgtGOUgJdiHFA2OuyodG3mBOqvuzs2WMud6UXiiDQHXrczuMToWYhjb3 # 4E8z6tg0+gh/HzFBV66s5Np6MPgSHpQUd/mRpJxR7fZ5yTU9afMCZbngQqmeEXp7 # YlpsOtaDWfp2TWWnMUy7386jZT4sF7oJgrPt1FzjDY5qal66KtdTFIdoUJ4XhZ+V # kOnESzZZhSemNDD6ONdzw0z1JoRXIsrEnlu2tUZst63oC3VQDCOS/QhhosRbVEEE # yWM+uz1P+9tl7uLQPt/qzAWJLWWo5Yngjckeo7DEOSvL6+ZpXFBOR5nZi3xeQiJq # dEXXAHENofU15cfA8FmdaB487HdpXw+xLx1Wm3OlZwvOWnWUHJj+4CaUNciTeM5N # 4o8nYW6R5aM6SkQN1X8vjFQHsOeNzummkW7RJDJZkDpOjixD+p77/7am3+f5AQUQ # JiqIsyRcxfYbwOitUPlNn03t+FzCIllvhoNBNYR75GBWNSeWMRND00WN8bzTf6VO # kKOPFu3DYHwmqbfSnx4fOy3OVib/MbUj # SIG # End signature block |