MarkdownToHtml.tests.ps1
|
# # This is a PowerShell Unit Test file. # You need a unit test framework such as Pester to run PowerShell Unit tests. # You can download Pester from http://go.microsoft.com/fwlink/?LinkID=534084 # [System.IO.DirectoryInfo]$SCRIPT:moduleDir = Split-Path -Parent $MyInvocation.MyCommand.Path [System.IO.DirectoryInfo]$SCRIPT:testdata = Join-Path $SCRIPT:moduleDir -ChildPath 'TestData' [System.IO.DirectoryInfo]$SCRIPT:refdata = Join-Path $SCRIPT:moduleDir -ChildPath 'ReferenceData' [System.IO.DirectoryInfo]$SCRIPT:template Describe 'Convert-MarkdownToHTML' { It 'Converts markdown file(s) from ''<Path>'' to HTML' ` -TestCases @( @{Path='markdown/mermaid.md'; ReferencePath='html/mermaid.html'; ResultPath='TestDrive:/mermaid.html'; Extensions = 'diagrams'} @{Path='markdown/KaTex.md'; ReferencePath='html/KaTex.html'; ResultPath='TestDrive:/KaTex.html' ; Extensions = 'mathematics'} @{Path='markdown/KaMaid.md'; ReferencePath='html/KaMaid.html'; ResultPath='TestDrive:/KaMaid.html' ; Extensions = 'diagrams','mathematics'} @{Path='markdown/Code.md'; ReferencePath='html/Code.html'; ResultPath='TestDrive:/Code.html' ; Extensions = 'advanced'} ) ` { param($Path,$ReferencePath,$ResultPath,$Extensions) $testPath = Join-Path $SCRIPT:testdata -ChildPath $Path $refPath = Join-Path $SCRIPT:refdata -ChildPath $ReferencePath $destination = 'TestDrive:/' #$destination = 'e:/temp/ttt/' #$ResultPath = $ResultPath -replace 'TestDrive:/',$destination Convert-MarkdownToHTML -Path $testPath ` -Template $SCRIPT:template ` -Destination $destination ` -IncludeExtension $Extensions ` -Verbose $refPath | Should -Exist $ResultPath | Should -Exist $refFileContents = Get-Content -LiteralPath $refPath -Encoding UTF8 | Out-String Get-Content -LiteralPath $ResultPath -Encoding UTF8 | Out-String | Should -BeExactly $refFileContents } BeforeAll { $template = Join-Path ([System.IO.Path]::GetTempPath()) ([System.IO.Path]::GetRandomFileName()) New-HTMLTemplate -Destination $template } AfterAll { Remove-Item $template -Recurse } } Describe 'Convert-MarkdownToHTMLFragment' { It 'Converts markdown file(s) from ''<Path>'' to HTMLFragments' ` -TestCases @( @{Path='markdown/mermaid.md'; ReferencePath='mermaid.html'; Extensions = 'diagrams' ; Title = 'Mermaid Diagramming Tool'} @{Path='markdown/KaTex.md'; ReferencePath='KaTex.html'; Extensions = 'mathematics'; Title = 'KaTEx Typesetting'} @{Path='markdown/KaMaid.md'; ReferencePath='KaMaid.html'; Extensions = 'diagrams','mathematics'; Title = 'KaTEx Typesetting'} @{Path='markdown/Code.md'; ReferencePath='Code.html'; Extensions = 'advanced'; Title = 'Testing Code Symtax Highlighting '} ) ` { param($Path,$ReferencePath,$Extensions, $Title) [System.IO.FileInfo]$testPath = Join-Path $SCRIPT:testdata -ChildPath $Path $refPath = Join-Path $SCRIPT:refdata -ChildPath $ReferencePath $ResultPath = Join-Path 'TestDrive:/' $ReferencePath #$ResultPath = Join-Path 'e:\temp\ttt' $ReferencePath $fragment = Get-Item -LiteralPath $testPath ` | Convert-MarkdownToHTMLFragment -IncludeExtension $Extensions $fragment.RelativePath | Should -BeExactly $testPath.Name # Should be Markdown Filename $fragment.Title | Should -BeExactly $Title Out-File -InputObject $fragment.HtmlFragment -LiteralPath $ResultPath -Encoding utf8 $refPath | Should -Exist $ResultPath | Should -Exist $refFileContents = Get-Content -LiteralPath $refPath -Encoding UTF8 | Out-String Get-Content -LiteralPath $ResultPath -Encoding UTF8 | Out-String | Should -BeExactly $refFileContents } } Describe 'ConversionProjects' { It 'Converts markdown file(s) from ''<Path>'' to HTML with a custom converter pipeline' ` -TestCases @( @{Path='markdown'; Config='ProjectConfigs/Build1.json';ReferencePath='html_cust'; ResultPath='TestDrive:/P1' ; Extensions = 'diagrams','mathematics' } @{Path='markdown'; Config='ProjectConfigs/Build2.json';ReferencePath='html_cust'; ResultPath='TestDrive:/P2' ; Extensions = 'diagrams','mathematics' } ) ` { param($Path,$Config, $ReferencePath,$ResultPath, $Extensions, $Title) [string]$markdown = Join-Path $testdata -ChildPath $Path $configPath = (Join-Path $testdata -ChildPath $Config) $config = Get-Content $configPath -Encoding UTF8 | ConvertFrom-Json #$ResultPath = $ResultPath -replace 'TestDrive:/','e:/temp/ttt/' # Create a new Project New-StaticHTMLSiteProject -ProjectDirectory $ResultPath # copy the build config Copy-Item -Path $configPath -Destination (Join-Path $ResultPath 'Build.json') # cleanup the readme $readme = (Join-Path $ResultPath 'markdown/README.md') Remove-Item -LiteralPath $readme $readme | Should -Not -Exist $ResultPath | Should -Exist # populate the project with markdown content Copy-Item "$markdown/*" -Destination (Join-Path $ResultPath $config.markdown_dir) -Recurse # Build the project &(Join-Path $ResultPath 'Build.ps1') # Verify the results $excluded = $config.Exclude | ForEach-Object { [System.IO.Path]::ChangeExtension($_,'html') } $html = Join-Path $ResultPath $config.site_dir if ($config.Exclude.Count -gt 0) { # Check that excluded files do not exist $found = (Get-ChildItem $html -Recurse -Include $excluded | Measure-Object).Count $found | Should -BeExactly 0 } # check that all files exists and are equal $ref = Join-Path $refdata $ReferencePath Get-ChildItem $ref -Include '*.html' -Exclude $excluded -Recurse | ForEach-Object { $relpath = $_.Fullname.Substring($ref.Length) $target = Join-Path $html $relpath $target | Should -Exist # conpare contents $refFileContents = Get-Content -LiteralPath $_ -Encoding UTF8 | Out-String Get-Content -LiteralPath $target -Encoding UTF8 | Out-String | Should -BeExactly $refFileContents } } } |