Get-{{Prefix}}Example.tests.ps1

[Diagnostics.CodeAnalysis.SuppressMessageAttribute(
    'PSUseDeclaredVarsMoreThanAssignments',
    '',
    Justification = 'Pester BeforeAll/It scope'
)]
param()

BeforeDiscovery {
    # Build module if not running in psake build
    if ($null -eq $Env:BHBuildOutput) {
        $buildFilePath = Join-Path -Path $PSScriptRoot -ChildPath '..\..\..\build.psake.ps1'
        $invokePsakeParameters = @{
            TaskList  = 'Build'
            BuildFile = $buildFilePath
        }
        Invoke-psake @invokePsakeParameters
    }

    # PowerShellBuild outputs to Output/<ModuleName>/<Version>/
    $projectRoot = Split-Path -Path (Split-Path -Path (Split-Path -Path $PSScriptRoot -Parent) -Parent) -Parent
    $sourceManifest = Join-Path -Path $projectRoot -ChildPath "$Env:BHProjectName/$Env:BHProjectName.psd1"
    $moduleVersion = (Import-PowerShellDataFile $sourceManifest).ModuleVersion
    $Env:BHBuildOutput = Join-Path -Path $projectRoot -ChildPath "Output/$Env:BHProjectName/$moduleVersion"
}

BeforeAll {
    # Import the module from the build output
    $moduleManifestPath = Join-Path -Path $Env:BHBuildOutput -ChildPath "$Env:BHProjectName.psd1"
    Get-Module $Env:BHProjectName | Remove-Module -Force -ErrorAction 'Ignore'
    Import-Module $moduleManifestPath -Force -ErrorAction 'Stop'
}

Describe 'Get-{{Prefix}}Example' {

    Context 'Basic functionality' {

        It 'Returns a greeting with default name' {
            $result = Get-{{Prefix}}Example
            $result | Should -Be 'Hello, World!'
        }

        It 'Returns a greeting with specified name' {
            $result = Get-{{Prefix}}Example 'PowerShell'
            $result | Should -Be 'Hello, PowerShell!'
        }

        It 'Accepts pipeline input' {
            $result = 'Test' | Get-{{Prefix}}Example
            $result | Should -Be 'Hello, Test!'
        }
    }

    Context 'Parameter validation' {

        It 'Throws on empty name' {
            { Get-{{Prefix}}Example '' } | Should -Throw
        }

        It 'Throws on null name' {
            { Get-{{Prefix}}Example $null } | Should -Throw
        }
    }

    Context 'Verbose output' {

        It 'Writes verbose messages when -Verbose is specified' {
            $verboseOutput = Get-{{Prefix}}Example 'Test' -Verbose 4>&1
            $verboseOutput | Should -Not -BeNullOrEmpty
        }
    }
}