ci: exercise the built module in tests

Prefer the workflow-imported artifact so Pester coverage measures real module execution, exclude pinned YAML fixtures from repository config linting, and skip PlatyPS docs generation because it preloads a conflicting YamlDotNet assembly.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Author: MariusStorhaug

.github/PSModule.yml

@@ -16,12 +16,14 @@ Test:
 #       Skip: true
 #     MacOS:
 #       Skip: true
-# Build:
-#   Docs:
-#     Skip: true
+Build:
+  Docs:
+    # PlatyPS loads a conflicting YamlDotNet assembly before importing this module.
+    Skip: true
 
 Linter:
   env:
+    FILTER_REGEX_EXCLUDE: '.*tests/fixtures/.*'
     VALIDATE_BIOME_FORMAT: false
     VALIDATE_BIOME_LINT: false
     VALIDATE_GITHUB_ACTIONS_ZIZMOR: false

tests/Test-Yaml.Tests.ps1

@@ -59,25 +59,23 @@ Describe 'Test-Yaml' {
         $result = Test-Yaml -Yaml $yaml -MaxNodes 100 -MaxAliases 100
         $stopwatch.Stop()
 
-        $document = @(Read-YamlStreamCore -Yaml $yaml -Depth 100 -MaxNodes 100 -MaxAliases 100 `
-                -MaxScalarLength 1048576)[0]
-        $cache = [System.Collections.Generic.Dictionary[int, string]]::new()
-        $hasher = [System.Security.Cryptography.SHA256]::Create()
-        try {
-            Test-YamlNodeGraph -Node $document -Visited ([System.Collections.Generic.HashSet[int]]::new()) `
-                -FingerprintCache $cache -FingerprintHasher $hasher
-        } finally {
-            $hasher.Dispose()
-        }
+        $fingerprintLengths = @(Get-TestYamlFingerprintLength -Yaml $yaml)
 
         $result | Should -BeTrue
         $stopwatch.Elapsed.TotalSeconds | Should -BeLessThan 5
-        @($cache.Values | Where-Object Length -NE 44).Count | Should -Be 0
+        @($fingerprintLengths | Where-Object { $_ -ne 44 }).Count | Should -Be 0
     }
 
     It 'does not swallow an unexpected runtime failure' {
-        Mock Read-YamlStream {
-            throw [System.InvalidOperationException]::new('unexpected runtime failure')
+        $loadedModule = Get-Module -Name Yaml | Select-Object -First 1
+        if ($null -eq $loadedModule) {
+            Mock Read-YamlStream {
+                throw [System.InvalidOperationException]::new('unexpected runtime failure')
+            }
+        } else {
+            Mock Read-YamlStream -ModuleName $loadedModule.Name {
+                throw [System.InvalidOperationException]::new('unexpected runtime failure')
+            }
         }
 
         { 'name: Ada' | Test-Yaml } |

tests/TestBootstrap.ps1

@@ -1,10 +1,42 @@
-$assemblyPath = Join-Path $PSScriptRoot '..\src\assemblies\YamlDotNet.dll'
-[void][System.Reflection.Assembly]::LoadFrom((Resolve-Path $assemblyPath))
+$yamlModule = Get-Module -Name Yaml | Select-Object -First 1
+if ($null -eq $yamlModule) {
+    $assemblyPath = Join-Path $PSScriptRoot '..\src\assemblies\YamlDotNet.dll'
+    [void][System.Reflection.Assembly]::LoadFrom((Resolve-Path $assemblyPath))
 
-Get-ChildItem -Path (Join-Path $PSScriptRoot '..\src\functions\private') -Filter '*.ps1' |
-    Sort-Object Name |
-    ForEach-Object { . $_.FullName }
+    Get-ChildItem -Path (Join-Path $PSScriptRoot '..\src\functions\private') -Filter '*.ps1' |
+        Sort-Object Name |
+        ForEach-Object { . $_.FullName }
 
-Get-ChildItem -Path (Join-Path $PSScriptRoot '..\src\functions\public') -Filter '*.ps1' |
-    Sort-Object Name |
-    ForEach-Object { . $_.FullName }
+    Get-ChildItem -Path (Join-Path $PSScriptRoot '..\src\functions\public') -Filter '*.ps1' |
+        Sort-Object Name |
+        ForEach-Object { . $_.FullName }
+}
+
+function Get-TestYamlFingerprintLength {
+    param (
+        [Parameter(Mandatory)]
+        [string] $Yaml
+    )
+
+    $implementation = {
+        param ([string] $YamlText)
+
+        $document = @(Read-YamlStreamCore -Yaml $YamlText -Depth 100 -MaxNodes 100 -MaxAliases 100 `
+                -MaxScalarLength 1048576)[0]
+        $cache = [System.Collections.Generic.Dictionary[int, string]]::new()
+        $hasher = [System.Security.Cryptography.SHA256]::Create()
+        try {
+            Test-YamlNodeGraph -Node $document -Visited ([System.Collections.Generic.HashSet[int]]::new()) `
+                -FingerprintCache $cache -FingerprintHasher $hasher
+        } finally {
+            $hasher.Dispose()
+        }
+        @($cache.Values | ForEach-Object Length)
+    }
+
+    $loadedModule = Get-Module -Name Yaml | Select-Object -First 1
+    if ($null -eq $loadedModule) {
+        return @(& $implementation $Yaml)
+    }
+    return @(& $loadedModule $implementation $Yaml)
+}