functions/Get-PSScriptTools.ps1
|
#display a summary of tools in this module #I am deviating slightly from the singular noun naming convention because I am thinking of #PSScriptTools as a singular thing, like a toolbox. Function Get-PSScriptTools { [cmdletbinding()] [OutputType("PSScriptTool")] Param( [Parameter(HelpMessage = "Filter commands based on a standard verb.")] [string]$Verb ) Write-Verbose "Starting $($MyInvocation.MyCommand)" $thisCmd = Get-Command $MyInvocation.MyCommand $ThisModule = $thisCmd.Source $thisVersion = $thisCmd.version.ToString() Write-Verbose "Using version $thisVersion" $PSBoundParameters.Module = $ThisModule Write-Verbose "Using these bound parameters" $PSBoundParameters | Out-String | Write-Verbose $h = @" ___ ___ ___ _ _ _____ _ | _ \ __/ __|__ _ _(_)_ __| |__ _|__ ___| |___ | _\__ \__ \ _| '_| | '_ \ _|| |/ _ \ _ \ (_-< |_| |___/___\__|_| |_| .__/\__||_|\___\___/_/__/ |_| v$ThisVersion "@ #ConvertTo-ASCIIArt has been removed from the module 4/4/2022 #ignore and suppress errors to create the ASCII art since this is optional and decorative only #$h = ConvertTo-ASCIIArt $ThisModule -font small -ErrorAction SilentlyContinue # $h+= "`n" #$h += ConvertTo-ASCIIArt $thisVersion -Font small -ErrorAction SilentlyContinue if ($host.name -match "console") { "$([char]0x1b)[1;38;5;177m$h$([char]0x1b)[0m" | Write-Host } else { Write-Host $h } #Write-Host $h -ForegroundColor Yellow Write-Verbose "Getting exported functions from $ThisModule" #Using Get-Module instead of Get-Command -module which wants to include private functions $funs = ((Get-Module $ThisModule).ExportedFunctions).values if ($Verb) { $funs = $funs.where{$_.verb -match $Verb} } Write-Verbose "Found $($funs.count) functions matching your criteria" #get all aliases once $allAliases = Get-Alias foreach ($fun in $funs) { Write-Verbose "Processing $fun" #find a matching alias $alias = $allAliases.where({$_.ReferencedCommand.name -eq $fun}).name Write-Verbose "Detected alias $alias" [PSCustomObject]@{ PSTypeName = "PSScriptTool" Name = $fun Alias = $alias Verb = $fun.verb #$fun.split("-")[0] Synopsis = (Get-Help $fun.name).synopsis Version = $fun.version } } Write-Verbose "Ending $($MyInvocation.MyCommand)" } #define an argumentcompleter for the Verb parameter Register-ArgumentCompleter -CommandName Get-PSScriptTools -ParameterName Verb -ScriptBlock { param($commandName, $parameterName, $wordToComplete, $commandAst, $fakeBoundParameter) #PowerShell code to populate $wordtoComplete Get-Verb | Where-object {$_.verb -like "$wordtocomplete*"} | ForEach-Object { # completion text,listitem text,result type,Tooltip [System.Management.Automation.CompletionResult]::new($_.verb, $_.verb, 'ParameterValue', $_.group) } } |