PowerShell helpers

PS-Helpers.ps1

<#
    PowerShell one-liner helpers
#>

# find non-existent paths in current $PATH
# From https://stackoverflow.com/a/65505792/43408
($env:path).Trim(";").Split(";") | ? {-not (test-path $_ -ErrorAction Ignore)}

# simple file test
function Test-If-File-Exists {
    param(
        [Parameter(Mandatory = $true, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true, Position = 1)]
        [String] $FileName
    )

    Write-Debug "Test existence of $FileName."
    if (!(Test-Path $FileName -PathType Leaf -ErrorAction Ignore)) {
        throw (New-Object System.IO.FileNotFoundException("File not found: $FileName", $FileName));
    }
}

# equivalent Write-Debug for Format-Table
function Format-Table-Debug {
    param(
        [Parameter(Mandatory = $false, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true, Position = 1)]
        $InputObject
    )

    Format-Table -InputObject $InputObject | Out-String -Stream | Write-Debug
}