Merge the 0.10.0 payload into 'main'

.github/workflows/ci.yaml

@@ -14,40 +14,31 @@ on:
 jobs:
   build:
     runs-on: windows-latest
+    environment:
+      name: General
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
       - name: Invoke-Pester
         shell: pwsh
         run: |
-          Import-Module Pester
-          $Configuration = [PesterConfiguration]@{
-            Run = @{
-              Path = '*'
-              Passthru = $true
-            }
-            CodeCoverage = @{
-              Enabled = $true
-              OutputFormat = 'JaCoCo'
-              OutputPath = '${{ env.GITHUB_WORKSPACE }}/Pester-Coverage.xml'
-            }
-          }
-          Invoke-Pester -Configuration $Configuration
-      - uses: codecov/codecov-action@v3
+          ${{ github.workspace }}/Build/RunTests.ps1
+      - uses: codecov/codecov-action@v5
         with:
-          files: '${{ env.GITHUB_WORKSPACE }}/Pester-Coverage.xml'
+          files: '${{ github.workspace }}/__output/coverage.xml'
           flags: unittests
           name: codecov-umbrella
+          token: '${{ secrets.CODECOV_TOKEN }}'
           fail_ci_if_error: true
           verbose: true
       - name: Build
         shell: pwsh
         run: |
           & .\Build\Publish.ps1 -Verbose
       - name: Upload __packages
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: __packages
           path: __packages
@@ -59,7 +50,7 @@ jobs:
     steps:
       - name: Download __packages
         id: download
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v5
         with:
           name: __packages
           path: __packages

.github/workflows/pull-request.yaml

@@ -5,33 +5,23 @@ on:
 jobs:
   build:
     runs-on: windows-latest
+    environment:
+      name: General
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0
       - name: Invoke-Pester
         shell: pwsh
         run: |
-          Import-Module Pester
-          $Configuration = [PesterConfiguration]@{
-            Run = @{
-              Path = '*'
-              Passthru = $true
-            }
-            CodeCoverage = @{
-              Enabled = $true
-              OutputFormat = 'JaCoCo'
-              OutputPath = '${{ env.GITHUB_WORKSPACE }}/Pester-Coverage.xml'
-            }
-          }
-          Invoke-Pester -Configuration $Configuration
+          ${{ github.workspace }}/Build/RunTests.ps1
       - name: Build
         shell: pwsh
         run: |
           & .\Build\Publish.ps1 -Verbose
       - name: Upload __packages
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: __packages
           path: __packages

.vscode/PSScriptAnalyzerSettings.psd1

@@ -0,0 +1,13 @@
+@{
+    Rules = @{
+        PSReviewUnusedParameter = @{
+            CommandsToTraverse = @(
+                'SearchAncestors'
+                'Using-Location'
+            )
+        }
+    }
+    IncludeRules = @('*')
+    ExcludeRules = @('PSUseApprovedVerbs')
+}
+

.vscode/settings.json

@@ -0,0 +1,8 @@
+{
+  "coverage-gutters.coverageBaseDir": "__output",
+  "editor.renderWhitespace": "all",
+  "powershell.codeFormatting.newLineAfterCloseBrace": false,
+  "powershell.codeFormatting.pipelineIndentationStyle": "IncreaseIndentationForFirstPipeline",
+  "powershell.scriptAnalysis.enable": true,
+  "powershell.scriptAnalysis.settingsPath": ".vscode/PSScriptAnalyzerSettings.psd1"
+}

Build/RunScriptAnalyzer.ps1

@@ -0,0 +1,18 @@
+#Requires -PSEdition Core
+
+[CmdletBinding()]
+param(
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+$WorkingDirectory = $PSScriptRoot
+$RepositoryRoot = Resolve-Path -Path (& git -C $WorkingDirectory rev-parse '--show-toplevel')
+$SettingsFile = Join-Path -Path $RepositoryRoot -ChildPath '.vscode\PSScriptAnalyzerSettings.psd1'
+& git -C $RepositoryRoot ls-files *.ps1 *.psm1 *.psd1 |
+    ForEach-Object { Get-Item -Path (Join-Path -Path $RepositoryRoot -ChildPath $_) } |
+    ForEach-Object { Invoke-ScriptAnalyzer -Path $_ -Settings $SettingsFile } |
+    ForEach-Object {
+        "$($_.ScriptPath):$($_.Line):$($_.Column) [$($_.RuleName)] $($_.Message)"
+    }

Build/RunTests.ps1

@@ -0,0 +1,27 @@
+#Requires -PSEdition Core
+
+[CmdletBinding()]
+param(
+)
+
+Set-StrictMode -Version Latest
+$ErrorActionPreference = 'Stop'
+
+Import-Module Pester
+
+$WorkingDirectory = $PSScriptRoot
+$RepositoryRoot = Resolve-Path -Path (& git -C $WorkingDirectory rev-parse '--show-toplevel')
+$Configuration = [PesterConfiguration]@{
+    Run          = @{
+        Path     = $RepositoryRoot
+        Passthru = $true
+    }
+    CodeCoverage = @{
+        Enabled      = $true
+        Path         = "$RepositoryRoot/PSCMake"
+        OutputFormat = 'JaCoCo'
+        OutputPath   = "$RepositoryRoot/__output/coverage.xml"
+    }
+}
+
+Invoke-Pester -Configuration $Configuration

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 Mark Schofield
+Copyright (c) 2025 Mark Schofield
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal