Pulling Dev back into forked repo

.build/tasks/Custom.Data.ps1

@@ -0,0 +1,33 @@
+<#
+    Data file used to create the .nuspec file which is used to create the package.
+    There is a "static" dependency for Vmware.vSphereDsc which is not included with
+    the RequiredModules section in the PowerStig manifest file due to a cyclic
+    dependency bug in PowerShell 5.1 which will not be fixed.
+#>
+data nuspecContents {
+@'
+<?xml version="1.0" encoding="utf-8"?>
+<package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
+  <metadata>
+    <id>PowerStig</id>
+    <version>{0}</version>
+    <authors>{1}</authors>
+    <owners>{2}</owners>
+    <licenseUrl>{3}</licenseUrl>
+    <projectUrl>{4}</projectUrl>
+    <requireLicenseAcceptance>false</requireLicenseAcceptance>
+    <description>{5}</description>
+    <releaseNotes>{6}</releaseNotes>
+    <copyright>{7} {8}</copyright>
+    <tags>{9}</tags>
+    <dependencies>
+{10}
+      <dependency id="Vmware.vSphereDsc" version="[2.1.0.58]" />
+    </dependencies>
+  </metadata>
+  <files>
+    <file src="PowerStig\{11}\**" target="" />
+  </files>
+</package>
+'@
+}

.build/tasks/Custom.Functions.psm1

@@ -0,0 +1,61 @@
+$supportFileList = Get-ChildItem -Path $PSScriptRoot -Filter '*.Data.ps1'
+foreach ($supportFile in $supportFileList)
+{
+    Write-Verbose "Loading $($supportFile.FullName)"
+    . $supportFile.FullName
+}
+
+function New-NuspecFile
+{
+    [CmdletBinding()]
+    param
+    (
+        [Parameter(Mandatory = $true)]
+        [String]
+        $DestinationPath,
+
+        [Parameter(Mandatory = $true)]
+        [String]
+        $ModuleManifestPath
+    )
+
+    # https://docs.microsoft.com/en-us/nuget/reference/nuspec
+
+    $moduleManifest = Import-PowerShellDataFile -Path $ModuleManifestPath
+
+    $requiredModuleStringBuilder = New-Object -TypeName System.Text.StringBuilder
+    foreach ($dependency in $moduleManifest.RequiredModules)
+    {
+        $requiredModuleContents = "      <dependency id='{0}' version='[{1}]' />" -f $dependency.ModuleName, $dependency.ModuleVersion
+        [void] $requiredModuleStringBuilder.AppendLine($requiredModuleContents)
+    }
+
+    $nuspecFileContent = $nuspecContents -f
+        $moduleManifest['ModuleVersion'],
+        $moduleManifest['Author'],
+        $moduleManifest['CompanyName'],
+        $moduleManifest['PrivateData']['PsData']['LicenseUri'],
+        $moduleManifest['PrivateData']['PsData']['ProjectUri'],
+        $moduleManifest['Description'],
+        $moduleManifest['PrivateData']['PsData']['ReleaseNotes'],
+        $moduleManifest['Copyright'],
+        $(Get-Date).Year,
+        $($moduleManifest['PrivateData']['PsData']['Tags'] -join ' '),
+        $($requiredModuleStringBuilder.ToString()),
+        $moduleManifest['ModuleVersion']
+
+    if (-not (Test-Path -Path $DestinationPath))
+    {
+        $null = New-Item -Path $DestinationPath -ItemType 'Directory'
+    }
+
+    $packageName = (Split-Path -Path $ModuleManifestPath -Leaf) -replace 'psd1', 'nuspec'
+    $nuspecFilePath = Join-Path -Path $DestinationPath -ChildPath $packageName
+    $nuspecFile = New-Item -Path $nuspecFilePath -ItemType 'File' -Force
+    $null = Set-Content -Path $nuspecFilePath -Value $nuspecFileContent
+    return $nuspecFile.FullName
+}
+
+Export-ModuleMember -Function @(
+    'New-NuspecFile'
+)

.build/tasks/Custom.NugetPackage.Task.ps1

@@ -0,0 +1,176 @@
+param(
+    # Base directory of all output (default to 'output')
+    [Parameter()]
+    [string]
+    $OutputDirectory = (property OutputDirectory (Join-Path $BuildRoot 'output')),
+
+    [Parameter()]
+    [string]
+    $ChangelogPath = (property ChangelogPath 'CHANGELOG.md'),
+
+    [Parameter()]
+    [string]
+    $ReleaseNotesPath = (property ReleaseNotesPath (Join-Path $OutputDirectory 'ReleaseNotes.md')),
+
+    [Parameter()]
+    [string]
+    $ProjectName = (property ProjectName $(
+        #Find the module manifest to deduce the Project Name
+        (
+            Get-ChildItem $BuildRoot\*\*.psd1 -Exclude 'build.psd1', 'analyzersettings.psd1' |
+                Where-Object {
+                    ($_.Directory.Name -match 'source|src' -or $_.Directory.Name -eq $_.BaseName) -and
+                    $(
+                        try
+                        {
+                            Test-ModuleManifest $_.FullName -ErrorAction Stop
+                        }
+                        catch
+                        {
+                            Write-Warning $_
+                            $false
+                        }
+                    )
+                }
+        ).BaseName
+    )
+    ),
+
+    [Parameter()]
+    [string]
+    $ModuleVersion = (
+        property ModuleVersion $(
+            try
+            {
+                (gitversion | ConvertFrom-Json -ErrorAction Stop).NuGetVersionV2
+            }
+            catch
+            {
+                Write-Verbose "Error attempting to use GitVersion $($_)"
+                ''
+            }
+        )
+    ),
+
+    [Parameter()]
+    [string]
+    # retrieves from Environment variable
+    $GitHubToken = (property GitHubToken ''),
+
+    [Parameter()]
+    [string]
+    $GalleryApiToken = (property GalleryApiToken ''),
+
+    [Parameter()]
+    [string]
+    $NuGetPublishSource = (property NuGetPublishSource 'https://www.powershellgallery.com/'),
+
+    [Parameter()]
+    $PSModuleFeed = (property PSModuleFeed 'PSGallery'),
+
+    [Parameter()]
+    $SkipPublish = (property SkipPublish '')
+)
+
+Import-Module -Name "$PSScriptRoot/Custom.Functions.psm1"
+
+# Synopsis: Packaging the module by Publishing to output folder (incl dependencies)
+task package_module_nupkg {
+
+    # Force registering the output repository mapping to the Project's output path
+    $null = Unregister-PSRepository -Name output -ErrorAction SilentlyContinue
+    $repositoryParams = @{
+        Name            = 'output'
+        SourceLocation  = $OutputDirectory
+        PublishLocation = $OutputDirectory
+        ErrorAction     = 'Stop'
+    }
+
+    $null = Register-PSRepository @repositoryParams
+
+    # Cleaning up existing packaged module
+    $moduleToRemove = Get-ChildItem -Path (Join-Path -Path $OutputDirectory -ChildPath "$ProjectName.*.nupkg")
+    if ($null -ne $moduleToRemove)
+    {
+        Write-Build DarkGray "  Remove existing $ProjectName package"
+        Remove-Item -Path $ModuleToRemove -Force -ErrorAction Stop
+    }
+
+    # find Module manifest
+    $builtModuleManifest = (Get-ChildItem -Path (Join-Path -Path $OutputDirectory -ChildPath $ProjectName) -Depth 2 -Filter "$ProjectName.psd1").FullName |
+        Where-Object {
+            try
+            {
+                Test-ModuleManifest -Path $_ -ErrorAction Stop
+            }
+            catch
+            {
+                $false
+            }
+        }
+
+    if (-not $builtModuleManifest)
+    {
+        throw "No valid manifest found for project $ProjectName."
+    }
+
+    Write-Build -Color DarkGray -Text "  Built module's Manifest found at $builtModuleManifest"
+
+    # load module manifest
+    $moduleInfo = Import-PowerShellDataFile -Path $builtModuleManifest
+
+    # Publish dependencies (from environment) so we can publish the built module
+    foreach ($module in $moduleInfo.RequiredModules)
+    {
+        if (
+            -not ([Microsoft.PowerShell.Commands.ModuleSpecification]$module |
+                Find-Module -Repository output -ErrorAction SilentlyContinue)
+        )
+        {
+            # Replace the module by first (path & version) resolved in PSModulePath
+            $module = Get-Module -ListAvailable -FullyQualifiedName $module | Select-Object -First 1
+            if ($null -ne $module.PrivateData.PSData.Prerelease)
+            {
+                $Prerelease = "-" + $module.PrivateData.PSData.Prerelease
+            }
+
+            $writeBuildText = "  Packaging Required Module {0} v{1}{2}" -f $Module.Name, $Module.Version.ToString(), $Prerelease
+            Write-Build -Color Yellow -Text $writeBuildText
+            Publish-Module -Repository output -Path $module.ModuleBase -ErrorAction SilentlyContinue
+        }
+    }
+
+    Write-Build -Color DarkGray -Text "  Creating nuspec file"
+    $projectPath = Join-Path -Path $OutputDirectory -ChildPath $ProjectName
+    $manifestFileName = '{0}.psd1' -f $ProjectName
+    $moduleManifestPath = Get-ChildItem -Path $projectPath -Filter $manifestFileName -Recurse
+    $newNuspecFileParams = @{
+        ModuleManifestPath = $moduleManifestPath.FullName
+        DestinationPath    = $OutputDirectory
+    }
+    $projectNuspecFile = New-NuspecFile @newNuspecFileParams
+    $nugetResults = Get-Command -Name nuget.exe | Select-Object -First 1
+    $nugetFilePath = $nugetResults.Source
+    Write-Build -Color DarkGray -Text "  nuget Path: $($nugetFilePath)"
+    if ((Test-Path -Path $nugetFilePath) -eq $false)
+    {
+        throw "nuget.exe not found, aborting task package_module_nupkg"
+    }
+    else
+    {
+        $startProcessNugetParams = @{
+            FilePath     = $nugetFilePath
+            Wait         = $true
+            ArgumentList = @(
+                'Pack', $projectNuspecFile
+                '-OutputDirectory', $OutputDirectory
+            )
+        }
+
+        Start-Process @startProcessNugetParams
+        Write-Build -Color Green -Text "  Packaged $ProjectName NuGet package"
+    }
+
+    Write-Build -Color DarkGray -Text "  Cleaning up"
+    $null = Unregister-PSRepository -Name output -ErrorAction SilentlyContinue
+}

.editorconfig

@@ -0,0 +1,18 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# All files
+[*]
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+# PowerShell files
+[*.{ps1,psm1,psd1}]
+indent_style = space
+indent_size = 4
+
+# Markdown files
+[*.md]
+trim_trailing_whitespace = false

.github/ISSUE_TEMPLATE/bug_report.md

@@ -4,20 +4,20 @@ about: Create a report to help us improve
 ---
 
 **Describe the bug**
-A clear and concise description of what the bug is.
+<!--A clear and concise description of what the bug is.-->
 
 **To Reproduce**
-Steps to reproduce the behavior:
+<!--Steps to reproduce the behavior:
 1. Go to '...'
 2. Click on '....'
 3. Scroll down to '....'
-4. See error
+4. See error-->
 
 **Expected behavior**
-A clear and concise description of what you expected to happen.
+<!--A clear and concise description of what you expected to happen.-->
 
 **Screenshots**
-If applicable, add screenshots to help explain your problem.
+<!--If applicable, add screenshots to help explain your problem.-->
 
 **Additional context**
-Add any other context about the problem here.
+<!--Add any other context about the problem here.-->