Adding localization test

Author: FriedrichWeinmann

PSModuleDevelopment/changelog.md

@@ -3,6 +3,7 @@
  - New: Export-PSMDString - Parses strings from modules using the PSFramework localization feature.
  - Upd: Template PSFProject - Adding `-IncludAZ` switch parameter to `vsts-packageFunction.ps1`, making the template include the AZ module as managed dependency.
  - Upd: Refactored module structure to comply with current Fred Reference Architecture
+ - Upd: Template PSFTests - Added localization string tests
  - Fix: Template PSFProject - Publish Folder created during build is created using `-Force`
  - Fix: Template PSFProject - Cleaning up Azure Function conversion
  - Fix: Template PSFTests - Encoding test no longer fails on core (#104)

templates/PSFTests/general/strings.Exceptions.ps1

@@ -0,0 +1,19 @@
+$exceptions = @{ }
+
+<#
+A list of entries that MAY be in the language files, without causing the tests to fail.
+This is commonly used in modules that generate localized messages straight from C#.
+Specify the full key as it is written in the language files, do not prepend the modulename,
+as you would have to in C# code.
+
+Example:
+$exceptions['LegalSurplus'] = @(
+    'Exception.Streams.FailedCreate'
+    'Exception.Streams.FailedDispose'
+)
+#>
+$exceptions['LegalSurplus'] = @(
+
+)
+
+$exceptions

templates/PSFTests/general/strings.Tests.ps1

@@ -0,0 +1,22 @@
+<#
+.DESCRIPTION
+    This test verifies, that all strings that have been used,
+    are listed in the language files and thus have a message being displayed.
+
+    It also checks, whether the language files have orphaned entries that need cleaning up.
+#>
+
+$moduleRoot = (Get-Module þnameþ).ModuleBase
+$stringsResults = Export-PSMDString -ModuleRoot $moduleRoot
+$exceptions = & "$PSScriptRoot\strings.Exceptions.ps1"
+
+Describe "Testing localization strings" {
+    foreach ($stringEntry in $stringsResults) {
+        It "Should be used & have text: $($stringEntry.String)" {
+            if ($exceptions.LegalSurplus -notcontains $stringEntry.String) {
+                $stringEntry.Surplus | Should -BeFalse
+            }
+            $stringEntry.Text | Should -Not -BeNullOrEmpty
+        }
+    }
+}