Plumber

0.0.62

Private/Test-PlumberTaskShouldRun.ps1

function Test-PlumberTaskShouldRun {
    <#
        .SYNOPSIS
        Tests whether a Plumber task should run for the current run context.

        .DESCRIPTION
        Evaluates a task's RunWhen policy. Always runs in every context,
        OnRelease runs only when PLUMBER_RELEASE_INTENT is true, and Never skips
        in every context.
    #>
    [CmdletBinding()]
    [OutputType([bool])]
    param (
        [Parameter(Mandatory)]
        [string]
        $Name,

        [ValidateSet('Always', 'OnRelease', 'Never')]
        [string]
        $RunWhen = 'Always'
    )

    switch ($RunWhen) {
        'Always' {
            $true
        }
        'OnRelease' {
            $env:PLUMBER_RELEASE_INTENT -in @('true', 'True', 'TRUE', '1', 'yes')
        }
        'Never' {
            $false
        }
        default {
            throw "Unsupported RunWhen value for task '$Name': $RunWhen"
        }
    }
}