Merge pull request #72 from PowershellFrameworkCollective/development

2.2.5.40

Author: FriedrichWeinmann

PSModuleDevelopment/PSModuleDevelopment.psd1

@@ -4,7 +4,7 @@
 	RootModule = 'PSModuleDevelopment.psm1'
 
 	# Version number of this module.
-	ModuleVersion = '2.2.5.37'
+	ModuleVersion = '2.2.5.40'
 
 	# ID used to uniquely identify this module
 	GUID = '37dd5fce-e7b5-4d57-ac37-832055ce49d6'
@@ -68,6 +68,7 @@
 		'Get-PSMDAssembly',
 		'Get-PSMDConstructor',
 		'Get-PSMDHelpEx',
+		'Get-PSMDMember',
 		'Get-PSMDModuleDebug',
 		'Get-PSMDTemplate',
 		'Import-PSMDModuleDebug',
@@ -89,6 +90,7 @@
 		'Set-PSMDCmdletBinding',
 		'Set-PSMDModulePath',
 		'Set-PSMDParameterHelp',
+		'Show-PSMDSyntax',
 		'Split-PSMDScriptFile'
     )
 

PSModuleDevelopment/PSModuleDevelopment.psm1

@@ -1,5 +1,5 @@
 $script:PSModuleRoot = $PSScriptRoot
-$script:PSModuleVersion = "2.2.5.37"
+$script:PSModuleVersion = "2.2.5.40"
 
 $script:doDotSource = $false
 if (Get-PSFConfigValue -FullName PSModuleDevelopment.Import.DoDotSource) { $script:doDotSource = $true }

PSModuleDevelopment/changelog.md

@@ -1,5 +1,10 @@
 # Changelog
-## 2.2.5.37 ( October 20th, 2018)
+## 2.2.5.40 (December 17th, 2018)
+ - New: Command Show-PSMDSyntax, used to show the parameter syntax with proper highlighting
+ - New: Command Get-PSMDMember, used to show the members in a more organic and useful way
+ - Fix: Template PSFProject build step was broken
+ 
+## 2.2.5.37 (October 20th, 2018)
  - Upd: Set-PSMDModulePath - add `-Module` parameter to persist the setting
  - Upd: Set-PSMDModulePath - add `-Register` parameter for integrated persistence
  - Upd: Set-PSMDEncoding - use `PSFEncoding` parameter class & tabcompletion

PSModuleDevelopment/functions/assembly/Get-PSMDMember.ps1

@@ -0,0 +1,126 @@
+function Get-PSMDMember
+{
+<#
+.ForwardHelpTargetName Microsoft.PowerShell.Utility\Get-Member
+.ForwardHelpCategory Cmdlet
+#>
+	[CmdletBinding(HelpUri = 'https://go.microsoft.com/fwlink/?LinkID=113322', RemotingCapability = 'None')]
+	param (
+		[Parameter(ValueFromPipeline = $true)]
+		[psobject]
+		$InputObject,
+		
+		[Parameter(Position = 0)]
+		[ValidateNotNullOrEmpty()]
+		[string[]]
+		$Name,
+		
+		[Alias('Type')]
+		[System.Management.Automation.PSMemberTypes]
+		$MemberType,
+		
+		[System.Management.Automation.PSMemberViewTypes]
+		$View,
+		
+		[string]
+		$ArgumentType,
+		
+		[string]
+		$ReturnType,
+		
+		[switch]
+		$Static,
+		
+		[switch]
+		$Force
+	)
+	
+	begin
+	{
+		try
+		{
+			$outBuffer = $null
+			if ($PSBoundParameters.TryGetValue('OutBuffer', [ref]$outBuffer))
+			{
+				$PSBoundParameters['OutBuffer'] = 1
+			}
+			if ($ArgumentType) { $PSBoundParameters.Remove("ArgumentType") }
+			if ($ReturnType) { $PSBoundParameters.Remove("ReturnType") }
+			$wrappedCmd = $ExecutionContext.InvokeCommand.GetCommand('Microsoft.PowerShell.Utility\Get-Member', [System.Management.Automation.CommandTypes]::Cmdlet)
+			$scriptCmd = { & $wrappedCmd @PSBoundParameters }
+			$steppablePipeline = $scriptCmd.GetSteppablePipeline($myInvocation.CommandOrigin)
+			$steppablePipeline.Begin($true)
+		}
+		catch
+		{
+			throw
+		}
+		
+		function Split-Member
+		{
+			[CmdletBinding()]
+			param (
+				[Parameter(ValueFromPipeline = $true)]
+				[Microsoft.PowerShell.Commands.MemberDefinition]
+				$Member
+			)
+			
+			process
+			{
+				if ($Member.MemberType -notlike "Method") { return $Member }
+				
+				if ($Member.Definition -notlike "*), *") { return $Member }
+				
+				foreach ($definition in $Member.Definition.Replace("), ", ")þþþ").Split("þþþ"))
+				{
+					if (-not $definition) { continue }
+					New-Object Microsoft.PowerShell.Commands.MemberDefinition($Member.TypeName, $Member.Name, $Member.MemberType, $definition)
+				}
+			}
+		}
+		
+	}
+	
+	process
+	{
+		try
+		{
+			$members = $steppablePipeline.Process($_) | Split-Member
+			
+			if ($ArgumentType)
+			{
+				$tempMembers = @()
+				foreach ($member in $members)
+				{
+					if ($member.MemberType -notlike "Method") { continue }
+					
+					if (($member.Definition -split "\(",2)[1] -match $ArgumentType) { $tempMembers += $member }
+				}
+				$members = $tempMembers
+			}
+			
+			if ($ReturnType)
+			{
+				$members = $members | Where-Object Definition -match "^$ReturnType"
+			}
+			
+			$members
+		}
+		catch
+		{
+			throw
+		}
+	}
+	
+	end
+	{
+		try
+		{
+			$steppablePipeline.End()
+		}
+		catch
+		{
+			throw
+		}
+	}
+}