public/Expand-Path.ps1
|
<#
.SYNOPSIS Attempts to expand a given candidate path by appending a wildcard character (*) to the end of each path segment. .PARAMETER Candidate Candidate search string .PARAMETER SearchPaths Set of paths to search in addition to the current directory. Defaults to $cde.CD_PATH .PARAMETER File Limits search results to leaf items .PARAMETER Directory Limits search results to container items .EXAMPLE PS> Expand-Path /win/sys/dr/et -Directory Directory: C:\Windows\System32\drivers Mode LastWriteTime Length Name ---- ------------- ------ ---- d----- 21/12/2017 11:50 PM etc #> function Expand-Path { [CmdletBinding()] param ( $Candidate, [array] $SearchPaths = $cde.CD_PATH, [switch] $File, [switch] $Directory) [string]$wildcardedPath = $Candidate -replace '(\w/|\w\\|\w$)', '$0*' ` -replace '(/\*|\\\*)', ('*' + ${/}) ` -replace '(/$|\\$)', '$0*' ` -replace '(\.\w|\.$)', '*$0' if ($SearchPaths -and -not (IsRootedOrRelative $Candidate)) { # always include the local path, regardeless of whether it was passed # in the searchPaths parameter (this differs from the behaviour in bash) $wildcardedPaths = @($wildcardedPath) + ( $SearchPaths | % { Join-Path $_ $wildcardedPath }) } else { $wildcardedPaths = $wildcardedPath } $type = @{File = $File; Directory = $Directory} Write-Verbose "Expanding $Candidate to: $wildcardedPaths" return Get-ChildItem $wildcardedPaths @type -Force -ErrorAction Ignore } |