Merge pull request #93 from PowershellFrameworkCollective/development

2.2.6.62

Author: FriedrichWeinmann

PSModuleDevelopment/PSModuleDevelopment.psd1

@@ -1,73 +1,74 @@
 @{
-	
+
 	# Script module or binary module file associated with this manifest
 	RootModule = 'PSModuleDevelopment.psm1'
-	
+
 	# Version number of this module.
-	ModuleVersion = '2.2.6.51'
-	
+	ModuleVersion = '2.2.6.62'
+
 	# ID used to uniquely identify this module
 	GUID = '37dd5fce-e7b5-4d57-ac37-832055ce49d6'
-	
+
 	# Author of this module
 	Author = 'Friedrich Weinmann'
-	
+
 	# Company or vendor of this module
 	CompanyName = 'Infernal Associates ltd.'
-	
+
 	# Copyright statement for this module
 	Copyright = '(c) 2016. All rights reserved.'
-	
+
 	# Description of the functionality provided by this module
 	Description = 'A module designed to speed up the development of PowerShell modules'
-	
+
 	# Minimum version of the Windows PowerShell engine required by this module
 	PowerShellVersion = '3.0'
-	
+
 	# Name of the Windows PowerShell host required by this module
 	PowerShellHostName = ''
-	
+
 	# Minimum version of the Windows PowerShell host required by this module
 	PowerShellHostVersion = ''
-	
+
 	# Minimum version of the .NET Framework required by this module
 	DotNetFrameworkVersion = '2.0'
-	
+
 	# Minimum version of the common language runtime (CLR) required by this module
 	CLRVersion = '2.0.50727'
-	
+
 	# Processor architecture (None, X86, Amd64, IA64) required by this module
 	ProcessorArchitecture = 'None'
-	
+
 	# Modules that must be imported into the global environment prior to importing
 	# this module
 	RequiredModules	       = @(
 		@{ ModuleName = 'PSFramework'; ModuleVersion = '0.10.31.176' }
 	)
-	
+
 	# Assemblies that must be loaded prior to importing this module
 	RequiredAssemblies = @('bin\PSModuleDevelopment.dll')
-	
+
 	# Script files (.ps1) that are run in the caller's environment prior to
 	# importing this module
 	ScriptsToProcess = @()
-	
+
 	# Type files (.ps1xml) to be loaded when importing this module
 	TypesToProcess = @('xml\PSModuleDevelopment.Types.ps1xml')
-	
+
 	# Format files (.ps1xml) to be loaded when importing this module
 	FormatsToProcess = @('xml\PSModuleDevelopment.Format.ps1xml')
-	
+
 	# Modules to import as nested modules of the module specified in
 	# ModuleToProcess
 	NestedModules = @()
-	
+
 	# Functions to export from this module
     FunctionsToExport = @(
 		'Expand-PSMDTypeName',
 		'Find-PSMDFileContent',
 		'Find-PSMDType',
 		'Format-PSMDParameter',
+		'Get-PSMDArgumentCompleter',
 		'Get-PSMDAssembly',
 		'Get-PSMDConstructor',
 		'Get-PSMDHelpEx',
@@ -98,13 +99,13 @@
 		'Show-PSMDSyntax',
 		'Split-PSMDScriptFile'
     )
-	
+
 	# Cmdlets to export from this module
-	CmdletsToExport = '' 
-	
+	CmdletsToExport = ''
+
 	# Variables to export from this module
 	VariablesToExport = ''
-	
+
 	# Aliases to export from this module
     AliasesToExport = @(
 		'dotnetnew',
@@ -117,36 +118,36 @@
         'rss',
         'smd'
     )
-	
+
 	# List of all modules packaged with this module
 	ModuleList = @()
-	
+
 	# List of all files packaged with this module
 	FileList = @()
-	
+
 	# Private data to pass to the module specified in ModuleToProcess
 	PrivateData = @{
-		
+
 		#Support for PowerShellGet galleries.
 		PSData = @{
-			
+
 			# Tags applied to this module. These help with module discovery in online galleries.
 			Tags = @('Development', 'Module')
-			
+
 			# A URL to the license for this module.
 			# LicenseUri = ''
-			
+
 			# A URL to the main website for this project.
 			ProjectUri = 'http://psframework.org'
-			
+
 			# A URL to an icon representing this module.
 			# IconUri = ''
-			
+
 			# ReleaseNotes of this module
 			# ReleaseNotes = ''
-			
+
 		} # End of PSData hashtable
-		
+
 	} # End of PrivateData hashtable
 }
 

PSModuleDevelopment/PSModuleDevelopment.psm1

@@ -1,5 +1,5 @@
 $script:PSModuleRoot = $PSScriptRoot
-$script:PSModuleVersion = "2.2.6.51"
+$script:PSModuleVersion = (Import-PowerShellDataFile -Path "$($script:PSModuleRoot)\PSModuleDevelopment.psd1").ModuleVersion
 
 $script:doDotSource = $false
 if (Get-PSFConfigValue -FullName PSModuleDevelopment.Import.DoDotSource) { $script:doDotSource = $true }

PSModuleDevelopment/changelog.md

@@ -1,4 +1,17 @@
 # Changelog
+##
+ - New: Get-PSMDArgumentCompleter - Lists registered argument completers on PS5+
+ - New: Template: PSFLoggingProvider - Creates a custom logfile logging provider for module specific logging.
+ - Upd: Template: PSFTest - Adding test against module tags with whitespace
+ - Upd: Get-PSMDConstructor - Added `-NonPublic` parameter to show hidden constructors.
+ - Upd: Template: PSFModule - Improved import speed.
+ - Upd: Template: PSFProject - Add parameter `-LocalRepo`
+ - Upd: Template: PSFProject - Add parameter `-AutoVersion`
+ - Fix: New-PSMDModuleNugetPackage - Resolving input path.
+ - Fix: New-PSMDModuleNugetPackage - Reregistering temp export repository if accidentally not cleaned up.
+ - Fix: Template: PSFModule - Fixed format xml closing tag
+ - Fix: Template: PSFModule - Fixed import from network share.
+ 
 ## 2.2.6.51 (January 29th, 2019)
  - New: Format-PSMDParameter - updates legacy parameter notation
  - New: Measure-PSMDLinesOfCode - Measures the lines of code in a scriptfile.

PSModuleDevelopment/functions/assembly/Get-PSMDConstructor.ps1

@@ -15,6 +15,9 @@
 		
 		.PARAMETER InputObject
 			The object the constructor of which should be retrieved.
+	
+		.PARAMETER NonPublic
+			Show non-public constructors instead.
 		
 		.EXAMPLE
 			Get-ChildItem | Get-PSMDConstructor
@@ -30,7 +33,10 @@
 	[CmdletBinding()]
 	Param (
 		[Parameter(ValueFromPipeline = $true)]
-		$InputObject
+		$InputObject,
+		
+		[switch]
+		$NonPublic
 	)
 
 	begin
@@ -47,16 +53,22 @@
 
 			if ($processedTypes -contains $type) { continue }
 
-			foreach ($constructor in $type.GetConstructors())
+			if ($NonPublic)
+			{
+				foreach ($constructor in $type.GetConstructors([System.Reflection.BindingFlags]'NonPublic, Instance'))
+				{
+					New-Object PSModuleDevelopment.PsmdAssembly.Constructor($constructor)
+				}
+			}
+			else
 			{
-				New-Object PSModuleDevelopment.PsmdAssembly.Constructor($constructor)
+				foreach ($constructor in $type.GetConstructors())
+				{
+					New-Object PSModuleDevelopment.PsmdAssembly.Constructor($constructor)
+				}
 			}
 
 			$processedTypes += $type
 		}
 	}
-	end
-	{
-		
-	}
 }

PSModuleDevelopment/functions/utility/Get-PSMDArgumentCompleter.ps1

@@ -0,0 +1,67 @@
+function Get-PSMDArgumentCompleter
+{
+<#
+	.SYNOPSIS
+		Gets the registered argument completers.
+
+    .DESCRIPTION
+        This function can be used to serach the argument completers registered using either the Register-ArgumentCompleter command or created using the ArgumentCompleter attribute.
+
+	.PARAMETER CommandName
+		Filter the results to a specific command. Wildcards are supported.
+
+	.PARAMETER ParameterName
+		Filter results to a specific parameter name. Wildcards are supported.
+
+	.EXAMPLE
+		PS C:\> Get-PSMDArgumentCompleter
+
+        Get all argument completers in use in the current PowerShell session.
+
+#>
+	[CmdletBinding()]
+	Param (
+        [Parameter(Position = 1, ValueFromPipeline = $true, ValueFromPipelineByPropertyName)]
+        [Alias('Name')]
+        [String]
+        $CommandName = '*',
+
+        [String]
+        $ParameterName = '*'
+    )
+
+	begin
+	{
+        $internalExecutionContext = [PSFramework.Utility.UtilityHost]::GetExecutionContextFromTLS()
+        $customArgumentCompletersProperty = $internalExecutionContext.GetType().GetProperty(
+            'CustomArgumentCompleters',
+            [System.Reflection.BindingFlags]'NonPublic, Instance'
+        )
+        $customArgumentCompleters = $customArgumentCompletersProperty.GetGetMethod($true).Invoke(
+            $internalExecutionContext,
+            [System.Reflection.BindingFlags]'Instance, NonPublic, GetProperty',
+            $null,
+            @(),
+            $psculture
+        )
+	}
+	process
+	{
+        foreach ($argumentCompleter in $customArgumentCompleters.Keys)
+        {
+            $name, $parameter = $argumentCompleter -split ':'
+
+            if ($name -like $CommandName)
+            {
+                if ($parameter -like $ParameterName)
+                {
+                    New-Object PSObject -Property @{
+                        CommandName   = $name
+                        ParameterName = $parameter
+                        Definition    = $customArgumentCompleters[$argumentCompleter]
+                    }
+                }
+            }
+        }
+    }
+}

PSModuleDevelopment/functions/utility/New-PSMDModuleNugetPackage.ps1

@@ -81,15 +81,20 @@
 				return
 			}
 		}
+		$resolvedPath = (Get-Item -Path $PackagePath).FullName
 		#endregion Input validation and prerequisites check
 
 		#region Prepare local Repository
 		try
 		{
+			if (Get-PSRepository | Where-Object Name -EQ 'PSModuleDevelopment_TempLocalRepository')
+			{
+				Unregister-PSRepository -Name 'PSModuleDevelopment_TempLocalRepository'
+			}
 			$paramRegisterPSRepository = @{
 				Name				 = 'PSModuleDevelopment_TempLocalRepository'
-				PublishLocation	     = $PackagePath
-				SourceLocation	     = $PackagePath
+				PublishLocation	     = $resolvedPath
+				SourceLocation	     = $resolvedPath
 				InstallationPolicy   = 'Trusted'
 				ErrorAction		     = 'Stop'
 			}

PSModuleDevelopment/tests/general/manifest.Tests.ps1

@@ -1,48 +1,49 @@
-Describe "Validating the module manifest" {
+Describe "Validating the module manifest" {
 	$moduleRoot = (Resolve-Path "$PSScriptRoot\..\..").Path
 	$manifest = ((Get-Content "$moduleRoot\PSModuleDevelopment.psd1") -join "`n") | Invoke-Expression
-	[version]$moduleVersion = Get-Item "$moduleRoot\PSModuleDevelopment.psm1" | Select-String -Pattern '\$script:PSModuleVersion = "(.*?)"' | ForEach-Object { $_.Matches[0].Groups[1].Value }
 	Context "Basic resources validation" {
 		It "Exports all functions in the public folder" {
 			$files = Get-ChildItem "$moduleRoot\functions" -Recurse -File -Filter "*.ps1"
 			$count = (Compare-Object -ReferenceObject $files.BaseName -DifferenceObject $manifest.FunctionsToExport).Count
 			$count | Should be 0
 		}
-		
+
 		It "Exports none of its internal functions" {
 			$files = Get-ChildItem "$moduleRoot\internal\functions" -Recurse -File -Filter "*.ps1"
 			$files | Where-Object BaseName -In $manifest.FunctionsToExport | Should Be $null
 		}
-		
-		It "Has the same version as the psm1 file" {
-			([version]$manifest.ModuleVersion) | Should Be $moduleVersion
-		}
 	}
-	
+
 	Context "Individual file validation" {
 		It "The root module file exists" {
 			Test-Path "$moduleRoot\$($manifest.RootModule)" | Should Be $true
 		}
-		
+
 		foreach ($format in $manifest.FormatsToProcess)
 		{
 			It "The file $format should exist" {
 				Test-Path "$moduleRoot\$format" | Should Be $true
 			}
 		}
-		
+
 		foreach ($type in $manifest.TypesToProcess)
 		{
 			It "The file $type should exist" {
 				Test-Path "$moduleRoot\$type" | Should Be $true
 			}
 		}
-		
+
 		foreach ($assembly in $manifest.RequiredAssemblies)
 		{
 			It "The file $assembly should exist" {
 				Test-Path "$moduleRoot\$assembly" | Should Be $true
 			}
 		}
+
+		foreach ($tag in $manifest.PrivateData.PSData.Tags) {
+			It "Tags should have no spaces in name" {
+				$tag -match " " | Should -Be $false
+			}
+		}
 	}
-}
+}