Private/Invoke-PlumberBuild.ps1
|
function Invoke-PlumberBuild { <# .SYNOPSIS Runs Invoke-Build for Invoke-Plumber. .DESCRIPTION Invokes the requested task against a build file and returns the Invoke-Build result object. A unique result variable is used so nested or mocked build calls do not clobber each other. .PARAMETER Task The Invoke-Build task names to run. .PARAMETER BuildFile The build script file to execute. .PARAMETER RawOutput Streams Invoke-Build output before returning the result object. .EXAMPLE Invoke-PlumberBuild -Task Validate -BuildFile ./Plumber.build.ps1 Runs the Validate task and returns the Invoke-Build result object. #> [CmdletBinding()] [OutputType([pscustomobject])] param ( [Parameter(Mandatory)] [string[]] $Task, [Parameter(Mandatory)] [string] $BuildFile, [switch] $RawOutput ) $invokeBuild = Get-Command Invoke-Build $invokeBuildCommand = if ($invokeBuild.CommandType -eq 'Alias') { $invokeBuild.Definition } else { $invokeBuild } $resultVariable = "plumberBuildResult_$([guid]::NewGuid().ToString('N'))" $moduleRoot = if ($script:moduleRoot) { $script:moduleRoot } else { Split-Path $PSScriptRoot -Parent } $runnerPath = Join-Path $moduleRoot 'Resource/Invoke-PlumberBuildRunner.ps1' # Invoke-Build writes -Result into the caller's scope. Run it inside a # dedicated scriptblock so we can read and remove that variable reliably # without leaking result variables into Invoke-Plumber's module scope. $runner = [scriptblock]::Create((Get-Content -Path $runnerPath -Raw)) $streamVariableSplat = @{ Name = 'PlumberStreamPesterOutput' Scope = 'Global' ErrorAction = 'SilentlyContinue' } $streamVariableExists = Get-Variable @streamVariableSplat $previousStreamPesterOutput = if ($streamVariableExists) { Get-Variable -Name PlumberStreamPesterOutput -Scope Global -ValueOnly } try { Set-Variable -Name PlumberStreamPesterOutput -Scope Global -Value ([bool]$RawOutput) $buildResult = & $runner $invokeBuildCommand $Task $BuildFile $resultVariable ([bool]$RawOutput) } finally { if (-not $streamVariableExists) { Remove-Variable -Name PlumberStreamPesterOutput -Scope Global -ErrorAction SilentlyContinue } else { Set-Variable -Name PlumberStreamPesterOutput -Scope Global -Value $previousStreamPesterOutput } } if (-not $buildResult) { throw 'Invoke-Build did not return a result object.' } $buildResult } |