Updated CI pipeline for testing PSModule DSC resources (#413)

Author: johlju

.gitignore

@@ -269,3 +269,7 @@ FakesAssemblies/
 *.xproj
 *.xproj.user
 *.suo
+
+# Ignore DscResource.Tests repository when it is cloned
+# when running DSC resource unit tests locally.
+DSC/DscResource.Tests

CHANGELOG.md

@@ -1,4 +1,34 @@
 # Changelog
+
+## Unreleased
+
+* Update the AppVeyor CI test pipeline with a new job to run tests for
+  the DSC resources, primarily for the resource `PSModule`.
+  The new job uses the test framework used for the DSC Resource Kit,
+  the [DscResource.Tests](https://github.com/PowerShell/DscResource.Tests) repository.
+* Update .gitignore to ignore the [DscResource.Tests](https://github.com/PowerShell/DscResource.Tests)
+  test framework. When running unit test locally it is cloned into the
+  local repository folder.
+* Added module PowerShellGet.LocalizationHelper containing localization
+  helper functions for DSC resources, and unit tests for the helper
+  functions.
+* Moved helper functions for the DSC resource `PSModule` to the module
+  PowerShellGet.ResourceHelper. Added improved localization support, and
+  code formatting against workspace VS Code settings.
+* Changes to PSModule.
+  * Added improved localization support.
+  * Changed type on the parameters that had `[Switch]` to correctly use
+    `Systen.Boolean` to match the schema.mof.
+  * Code formatting against workspace VS Code settings.
+  * Added unit tests.
+  * Added integration tests
+  * It is now possible to install a module and passing in `AllowClobber`
+    when the modules package source is trusted (it already worked in
+    other scenarios).
+* Changed the AppVeyor CI build pipeline so it added the DSC resource
+  `PSModule` and dependent helper modules (the `Modules` folder) to the
+  AppVeyor artifact.
+
 ## 2.0.4
 Bug Fix
 * Remove PSGallery availability checks (#374)

DSC/DSC.psd1

@@ -0,0 +1,63 @@
+<#
+    This is a dummy PowerShell manifest file so that the DscResource.Tests
+    test framework recognize the module folder as correct (expected) folder
+    and file structure.
+    THIS FILE IS NOT USE DURING DEPLOYMENT.
+#>
+@{
+    # Version number of this module.
+    moduleVersion      = '0.0.0.1'
+
+    # ID used to uniquely identify this module
+    GUID               = 'e102ebd2-bdc3-4d0f-bc93-4b8cc3eb7074'
+
+    # Author of this module
+    Author             = 'Microsoft Corporation'
+
+    # Company or vendor of this module
+    CompanyName        = 'Microsoft Corporation'
+
+    # Copyright statement for this module
+    Copyright          = '(c) 2019 Microsoft Corporation. All rights reserved.'
+
+    # Description of the functionality provided by this module
+    Description        = 'Module with DSC Resources for deployment of PowerShell modules.'
+
+    # Minimum version of the Windows PowerShell engine required by this module
+    PowerShellVersion  = '5.0'
+
+    # Minimum version of the common language runtime (CLR) required by this module
+    CLRVersion         = '4.0'
+
+    # Functions to export from this module
+    FunctionsToExport  = @()
+
+    # Cmdlets to export from this module
+    CmdletsToExport    = @()
+
+    RequiredAssemblies = @()
+
+    <#
+        Private data to pass to the module specified in RootModule/ModuleToProcess.
+        This may also contain a PSData hashtable with additional module metadata used by PowerShell.
+    #>
+    PrivateData        = @{
+
+        PSData = @{
+
+            # Tags applied to this module. These help with module discovery in online galleries.
+            Tags         = @('DesiredStateConfiguration', 'DSC', 'DSCResource')
+
+            # A URL to the license for this module.
+            LicenseUri   = 'https://github.com/PowerShell/PowerShellGet/blob/master/LICENSE'
+
+            # A URL to the main website for this project.
+            ProjectUri   = 'https://github.com/PowerShell/PowerShellGet'
+
+            # ReleaseNotes of this module
+            ReleaseNotes = ''
+
+        } # End of PSData hashtable
+
+    } # End of PrivateData hashtable
+}