Add MaximumVersion to prevent loading latest installed Pester

PSKoans/PSKoans.psd1

@@ -55,6 +55,7 @@
         @{
             ModuleName      = 'Pester'
             ModuleVersion   = '5.0.2'
+            MaximumVersion  = '5.999.999'
         }
     )
 

build.ps1

@@ -24,7 +24,7 @@
     [ArgumentCompleter( {
             param($Command, $Parameter, $WordToComplete, $CommandAst, $FakeBoundParams)
             try {
                 Get-PSakeScriptTasks -BuildFile (Join-Path $PSScriptRoot 'psakeFile.ps1') -ErrorAction 'Stop' |
                     Where-Object { $_.Name -like "$WordToComplete*" } |
                     Select-Object -ExpandProperty 'Name'
             }
@@ -40,8 +40,12 @@
 
 $ErrorActionPreference = 'Stop'
 $requirementsFile = Join-Path $PSScriptRoot 'requirements.psd1'
 $psakeFile = Join-Path $PSScriptRoot 'psakeFile.ps1'
 
+$requirements = Import-PowerShellDataFile -Path $requirementsFile
+$pesterRequirement = $requirements.Pester
+$requirements.Remove('Pester')
+
 if ($Bootstrap) {
     if (-not (Get-PackageProvider -Name NuGet -ErrorAction SilentlyContinue)) {
         Install-PackageProvider -Name NuGet -Force -Scope CurrentUser | Out-Null
@@ -50,19 +54,24 @@
     if (-not (Get-Module -Name PSDepend -ListAvailable)) {
         Install-Module -Name PSDepend -Repository PSGallery -Scope CurrentUser -Force -RequiredVersion '0.3.8'
     }
-    Import-Module -Name PSDepend -Verbose:$false
-    Invoke-PSDepend -Path $requirementsFile -Install -Import -Force -WarningAction SilentlyContinue
 }
-else {
-    Invoke-PSDepend -Path $requirementsFile -Import -Force -WarningAction SilentlyContinue
+
+Import-Module -Name PSDepend -Verbose:$false
+if ($Bootstrap) {
+    Invoke-PSDepend -Path $requirementsFile -Install -Force -WarningAction SilentlyContinue
 }
 
+# PowerShellBuild requires Pester without an upper bound. Load the pinned version
+# first, then import the remaining dependencies without re-importing Pester.
+Import-Module -Name Pester -RequiredVersion $pesterRequirement.Version
+Invoke-PSDepend -InputObject $requirements -Import -Force -WarningAction SilentlyContinue
+
 if ($PSCmdlet.ParameterSetName -eq 'Help') {
     Get-PSakeScriptTasks -BuildFile $psakeFile |
         Format-Table -Property Name, Description, Alias, DependsOn
 }
 else {
     Set-BuildEnvironment -Force
     Invoke-Psake -BuildFile $psakeFile -TaskList $Task -NoLogo
     exit ([int](-not $psake.build_success))
 }

psakeFile.ps1

@@ -15,18 +15,44 @@
     $PSBPreference.Test.ScriptAnalysis.FailBuildOnSeverityLevel = 'Error'
     $PSBPreference.Test.CodeCoverage.Enabled = $false
 
     $PSBPreference.Publish.PSRepositoryApiKey = $env:PSGALLERY_API_KEY
 }
 
 # The module manifest's FormatsToProcess entry (PSKoans.format.ps1xml) is generated
 # from ./formatting via EZOut and is gitignored -- it must exist before the module
 # can be imported at all, so generate it ahead of staging.
 Task GenerateFormatData -Depends Clean {
     & (Join-Path $PSBPreference.General.ProjectRoot 'PSKoans.ezformat.ps1')
 } -Description 'Generates PSKoans.format.ps1xml from ./formatting'
 
 $PSBStageFilesDependency = @('Clean', 'GenerateFormatData')
 $PSBBuildDependency = @('StageFiles')
+$PSBTestDependency = @('Pester5', 'Analyze')
+
+Task Pester5 -Depends $PSBBuildDependency {
+    $moduleManifest = Join-Path $PSBPreference.Build.ModuleOutDir "$($PSBPreference.General.ModuleName).psd1"
+
+    Import-Module -Name $moduleManifest -Force
+    Push-Location -LiteralPath $PSBPreference.Test.RootDir
+    try {
+        $configuration = [PesterConfiguration]::Default
+        $configuration.Output.Verbosity = 'Detailed'
+        $configuration.Run.PassThru = $true
+        $configuration.TestResult.Enabled = $true
+        $configuration.TestResult.OutputPath = $PSBPreference.Test.OutputFile
+        $configuration.TestResult.OutputFormat = $PSBPreference.Test.OutputFormat
+
+        $testResult = Invoke-Pester -Configuration $configuration
+        if ($testResult.Result -eq 'Failed') {
+            throw 'One or more Pester tests failed.'
+        }
+    }
+    finally {
+        Pop-Location
+        Remove-Module -Name $PSBPreference.General.ModuleName -ErrorAction SilentlyContinue
+    }
+} -Description 'Executes Pester 5 tests'
+
 
 Task Default -Depends Test
 
@@ -40,7 +66,7 @@
 # - Test
 # - BuildHelp
 # - GenerateMarkdown
 # - GenerateMAML
 # - GenerateUpdatableHelp
 # - Publish
 Task Test -FromModule PowerShellBuild -MinimumVersion '0.7.3'

requirements.psd1

@@ -2,17 +2,18 @@
     PSDependOptions = @{
         Target = 'CurrentUser'
     }
     'psake' = @{
         Version = '4.9.1'
     }
-    'PowerShellBuild' = @{
-        Version = '0.7.3'
-    }
     'Pester' = @{
+        Version = '5.9.0'
         Parameters = @{
             SkipPublisherCheck = $true
         }
     }
+    'PowerShellBuild' = @{
+        Version = '0.8.2'
+    }
     'PSScriptAnalyzer' = @{
         Version = '1.19.1'
     }