PSFunctionTools

1.0.0

functions/public/Get-PSRequirements.ps1

Function Get-PSRequirements {
    [cmdletbinding()]
    [OutputType("PSScriptRequirements")]
    Param(
        [Parameter(
            Position = 0,
            Mandatory,
            ValueFromPipeline,
            ValueFromPipelineByPropertyName
        )]
        [ValidateScript({
            If (Test-Path $_ ) {
                $True
                If ($_ -match "\.ps(m)?1$") {
                    $True
                }
                Else {
                    Throw "The path must be to a .ps1 or .psm1 file."
                    $False
                }
            }
            Else {
                Throw "Can't validate that $_ exists. Please verify and try again."
                $False
            }
        })]
        [string]$Path
    )
    Begin {
        Write-Verbose "Starting $($MyInvocation.MyCommand)"
    }
    Process {
        $Path = Convert-Path $path
        Write-Verbose "Processing $path"

        $AST = _getAST $path

        #add the Path as a property
        if ($ast.ScriptRequirements) {
            $out = $ast.ScriptRequirements |
            Add-Member -MemberType NoteProperty -Name "Path" -Value $Path -Force -PassThru
            #insert a custom type name for formatting purposes
            $out.psobject.typenames.insert(0,'PSScriptRequirements')
            #write the object to the pipeline
            $out
        }
        else {
            Write-Verbose "No requirements detected in $Path."
        }
    }
    End {
        Write-Verbose "Ending $($MyInvocation.MyCommand)"
    }
}