Build/PipeScript.ExamplesShouldWork.build.ps1
|
<# .SYNOPSIS Ensures Examples Work .DESCRIPTION Ensures Examples work by turning each example into a test. Including a comment followed by 'should' will turn specific lines of the test into Pester should statements. #> param( $ModuleName = 'PipeScript' ) $moduleInfo = Get-Module $ModuleName $commandsInModule = Get-Command -Module $moduleName $commandsWithExamples = $commandsInModule | Where-Object { $_.Examples } $examplePattern = [Regex]::new('(?<ws>[\s\r\n]{0,})\#\s(?<P>.+?(?=\z|Should))?Should\s(?<C>.+?)$', 'IgnoreCase,IgnorePatternWhitespace', '00:00:05') $testsDirectory = $moduleInfo | Split-Path | Join-Path -ChildPath Tests | Join-Path -ChildPath "Examples" if (-not (Test-Path $testsDirectory)) { $null = New-Item -ItemType Directory -Path $testsDirectory } foreach ($commandShouldWork in $commandsWithExamples) { $exampleCounter = 0 $exampleFileContent = @( '' "describe '$($commandShouldWork)' {" foreach ($commandExample in $commandShouldWork.Examples) { $exampleCounter++ try { " it '$commandShouldWork Example $($exampleCounter)' {" $examplePattern.Replace($commandExample, ' | ${P} Should ${C}') " }" } catch { $ex = $_ # If for whatever reason the regex threw an exception, don't make a test out of this example. } } "}" '') -join [Environment]::newLine $testFilePath = Join-Path $testsDirectory "$CommandShouldWork.examples.tests.ps1" $exampleFileContent | Set-Content $testFilePath Get-Item $testFilePath } |