Rename CopyDirectories to CopyPaths because it supports files

Add an alias for backward compatibility
Add a test for functionality and parameter existence

Author: Jaykul

Source/Public/Build-Module.ps1

@@ -17,7 +17,7 @@ function Build-Module {
             The optimization process:
             1. The OutputDirectory is created
             2. All psd1/psm1/ps1xml files (except build.psd1) in the Source will be copied to the output
-            3. If specified, $CopyDirectories (relative to the Source) will be copied to the output
+            3. If specified, $CopyPaths (relative to the Source) will be copied to the output
             4. The ModuleName.psm1 will be generated (overwritten completely) by concatenating all .ps1 files in the $SourceDirectories subdirectories
             5. The ModuleVersion and ExportedFunctions in the ModuleName.psd1 may be updated (depending on parameters)
 
@@ -88,7 +88,8 @@ function Build-Module {
         # Folders which should be copied intact to the module output
         # Can be relative to the  module folder
         [AllowEmptyCollection()]
-        [string[]]$CopyDirectories = @(),
+        [Alias("CopyDirectories")]
+        [string[]]$CopyPaths = @(),
 
         # Folders which contain source .ps1 scripts to be concatenated into the module
         # Defaults to Enum, Classes, Private, Public
@@ -194,9 +195,9 @@ function Build-Module {
             Write-Verbose "Copy files to $OutputDirectory"
             # Copy the files and folders which won't be processed
             Copy-Item *.psm1, *.psd1, *.ps1xml -Exclude "build.psd1" -Destination $OutputDirectory -Force
-            if ($ModuleInfo.CopyDirectories) {
-                Write-Verbose "Copy Entire Directories: $($ModuleInfo.CopyDirectories)"
-                Copy-Item -Path $ModuleInfo.CopyDirectories -Recurse -Destination $OutputDirectory -Force
+            if ($ModuleInfo.CopyPaths) {
+                Write-Verbose "Copy Entire Directories: $($ModuleInfo.CopyPaths)"
+                Copy-Item -Path $ModuleInfo.CopyPaths -Recurse -Destination $OutputDirectory -Force
             }
 
             Write-Verbose "Combine scripts to $RootModule"

Tests/Public/Build-Module.Tests.ps1

@@ -49,6 +49,14 @@ Describe "Build-Module" {
             $parameters["Target"].Attributes.Where{$_ -is [ValidateSet]}.ValidValues | Should -Be "Clean", "Build", "CleanBuild"
         }
 
+        It "supports an optional string array parameter CopyPaths (which used to be CopyDirectories)" {
+            $parameters.ContainsKey("CopyPaths") | Should -Be $true
+
+            # Techincally we could implement this a few other ways ...
+            $parameters["CopyPaths"].ParameterType | Should -Be ([string[]])
+            $parameters["CopyPaths"].Aliases | Should -Contain "CopyDirectories"
+        }
+
         It "has an Passthru switch parameter" {
             $parameters.ContainsKey("Passthru") | Should -Be $true
             $parameters["Passthru"].ParameterType | Should -Be ([switch])
@@ -229,7 +237,7 @@ Describe "Build-Module" {
                 OutputDirectory = "TestDrive:\$Version"
                 Name            = "MyModule"
                 ModuleBase      = "TestDrive:\MyModule\"
-                CopyDirectories = @()
+                CopyPaths = @()
                 Encoding        = "UTF8"
                 PublicFilter    = "Public\*.ps1"
             }
@@ -344,7 +352,7 @@ Describe "Build-Module" {
                 OutputDirectory = "TestDrive:\$Version"
                 Name            = "MyModule"
                 ModuleBase      = "TestDrive:\MyModule\"
-                CopyDirectories = @()
+                CopyPaths = @()
                 Encoding        = "UTF8"
                 PublicFilter    = "Public\*.ps1"
             }
@@ -455,7 +463,7 @@ Describe "Build-Module" {
                     OutputDirectory = "TestDrive:\$Version"
                     Name            = "MyModule"
                     ModuleBase      = "TestDrive:\MyModule\"
-                    CopyDirectories = @()
+                    CopyPaths = @()
                     Encoding        = "UTF8"
                     PublicFilter    = "Public\*.ps1"
                 }
@@ -551,4 +559,38 @@ Describe "Build-Module" {
             'TestDrive:\output\MyModule.psm1' | Should -FileContentMatch 'MATCHING TEST CONTENT'
         }
     }
+
+    Context "Copies additional items specified in CopyPaths" {
+
+        $null = New-Item "TestDrive:\build.psd1" -Type File -Force -Value "@{}"
+        $null = New-ModuleManifest "TestDrive:\MyModule.psd1" -ModuleVersion "1.0.0" -Author "Tester"
+        $null = New-Item "TestDrive:\Public\Test.ps1" -Type File -Value 'MATCHING TEST CONTENT' -Force
+        $null = New-Item "TestDrive:\MyModule.format.ps1xml" -Type File -Value '<Configuration />' -Force
+        $null = New-Item "TestDrive:\lib\imaginary1.dll" -Type File -Value '1' -Force
+        $null = New-Item "TestDrive:\lib\subdir\imaginary2.dll" -Type File -Value '2' -Force
+
+        Mock GetBuildInfo -ModuleName ModuleBuilder {
+            [PSCustomObject]@{
+                SourcePath        = "TestDrive:\MyModule.psd1"
+                Version           = [Version]"1.0.0"
+                OutputDirectory   = "./output"
+                CopyPaths         = "./lib", "./MyModule.format.ps1xml"
+                Encoding          = 'UTF8'
+                SourceDirectories = @('Public')
+            }
+        }
+
+        $Result = Build-Module -SourcePath 'TestDrive:\build.psd1' -OutputDirectory '.\output' -Passthru -Target Build
+
+        It "Copies single files that are in CopyPaths" {
+            $Result.ModuleBase | Should -Be ("TestDrive:\output" | Convert-Path).TrimEnd('\')
+            'TestDrive:\output\MyModule.format.ps1xml' | Should -Exist
+            'TestDrive:\output\MyModule.format.ps1xml' | Should -FileContentMatch '<Configuration />'
+        }
+
+        It "Recursively copies all the files in folders that are in CopyPaths" {
+            'TestDrive:\output\lib\imaginary1.dll' | Should -FileContentMatch '1'
+            'TestDrive:\output\lib\subdir\imaginary2.dll' | Should -FileContentMatch '2'
+        }
+    }
 }

nuget.config

@@ -1,12 +1,11 @@
-<?xml version="1.0" encoding="utf-8"?>
+<?xml version="1.0" encoding="utf-8"?>
 <configuration>
   <!-- install packages to a custom path -->
   <config>
-    <add key="globalPackagesFolder" value="Tools"/>
+    <add key="globalPackagesFolder" value="Tools" />
   </config>
   <packageSources>
     <clear />
-    <add key="powershell" value="https://www.Preview.PowerShellGallery.Com/api/v2" />
     <add key="nuget" value="https://api.nuget.org/v3/index.json" />
   </packageSources>
 </configuration>