mirror of https://github.com/raandree/NTFSSecurity
Browse Source
ci: move CI from AppVeyor to GitHub Actions and publish the docs to the wikipull/97/head
Raimund Andrée
1 week ago
committed by
GitHub
GitHub
18 changed files with 965 additions and 192 deletions
@ -0,0 +1,279 @@ |
|||||
|
<# |
||||
|
.SYNOPSIS |
||||
|
Converts the documentation in the Docs folder into the pages of the GitHub wiki. |
||||
|
|
||||
|
.DESCRIPTION |
||||
|
Writes a wiki page for every page in Docs except the contributor guide (Contributing.md and the Contributing |
||||
|
folder). Docs/README.md becomes the page Home, and every other page keeps its file name, so a page in |
||||
|
Docs/Cmdlets becomes a page named after its cmdlet. The platyPS metadata at the top of the cmdlet pages is |
||||
|
removed. Relative links point to the wiki pages; links to other files of the repository point to the files on |
||||
|
GitHub. Links in code stay unchanged. |
||||
|
|
||||
|
The script also writes the sidebar, which lists the cmdlets in the groups of the cmdlet list in Docs/README.md; |
||||
|
the footer; and the page How-to-install, which keeps the address of the former wiki page working. |
||||
|
|
||||
|
The script removes everything in DestinationPath except the .git folder, so that pages that no longer exist in |
||||
|
Docs disappear from the wiki. |
||||
|
|
||||
|
.PARAMETER Path |
||||
|
Specifies the Docs folder of the repository. |
||||
|
|
||||
|
.PARAMETER DestinationPath |
||||
|
Specifies the folder to write the wiki pages to, usually a clone of the wiki repository. The script creates the |
||||
|
folder if it doesn't exist. |
||||
|
|
||||
|
.PARAMETER RepositoryUrl |
||||
|
Specifies the address of the repository on GitHub, for links to files that aren't wiki pages. |
||||
|
|
||||
|
.PARAMETER Branch |
||||
|
Specifies the branch for links to files that aren't wiki pages. |
||||
|
|
||||
|
.EXAMPLE |
||||
|
git clone https://github.com/raandree/NTFSSecurity.wiki.git $env:TEMP\wiki |
||||
|
.\.github\scripts\Export-WikiContent.ps1 -Path .\Docs -DestinationPath $env:TEMP\wiki |
||||
|
git -C $env:TEMP\wiki status |
||||
|
|
||||
|
Writes the wiki pages into a clone of the wiki and shows which pages change. |
||||
|
#> |
||||
|
[CmdletBinding(SupportsShouldProcess)] |
||||
|
param ( |
||||
|
[Parameter(Mandatory)] |
||||
|
[ValidateScript({ Test-Path -LiteralPath $_ -PathType Container })] |
||||
|
[string] |
||||
|
$Path, |
||||
|
|
||||
|
[Parameter(Mandatory)] |
||||
|
[ValidateNotNullOrEmpty()] |
||||
|
[string] |
||||
|
$DestinationPath, |
||||
|
|
||||
|
[Parameter()] |
||||
|
[ValidateNotNullOrEmpty()] |
||||
|
[string] |
||||
|
$RepositoryUrl = 'https://github.com/raandree/NTFSSecurity', |
||||
|
|
||||
|
[Parameter()] |
||||
|
[ValidateNotNullOrEmpty()] |
||||
|
[string] |
||||
|
$Branch = 'master' |
||||
|
) |
||||
|
|
||||
|
$ErrorActionPreference = 'Stop' |
||||
|
|
||||
|
function Resolve-RepositoryPath { |
||||
|
<# |
||||
|
Returns the path of a link target relative to the repository root, with / as separator, or nothing if the |
||||
|
link leaves the repository. |
||||
|
#> |
||||
|
param ( |
||||
|
[Parameter(Mandatory)] |
||||
|
[string] |
||||
|
$Directory, |
||||
|
|
||||
|
[Parameter(Mandatory)] |
||||
|
[string] |
||||
|
$Link |
||||
|
) |
||||
|
|
||||
|
$segments = New-Object -TypeName 'System.Collections.Generic.List[string]' |
||||
|
foreach ($segment in (('{0}/{1}' -f $Directory, $Link) -split '/')) { |
||||
|
if ($segment -eq '..') { |
||||
|
if ($segments.Count -eq 0) { |
||||
|
return |
||||
|
} |
||||
|
$segments.RemoveAt($segments.Count - 1) |
||||
|
} elseif ($segment -and $segment -ne '.') { |
||||
|
$segments.Add($segment) |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
$segments -join '/' |
||||
|
} |
||||
|
|
||||
|
function ConvertTo-WikiLink { |
||||
|
<# |
||||
|
Returns the wiki address of a link on a page in Directory: the name of a wiki page, the address of a file of |
||||
|
the repository on GitHub, or the link itself if it is absolute or points to the same page. |
||||
|
#> |
||||
|
param ( |
||||
|
[Parameter(Mandatory)] |
||||
|
[string] |
||||
|
$Url, |
||||
|
|
||||
|
[Parameter(Mandatory)] |
||||
|
[string] |
||||
|
$Directory |
||||
|
) |
||||
|
|
||||
|
if ($Url -match '^(?:[a-zA-Z][a-zA-Z0-9+.-]*:|//|#)') { |
||||
|
return $Url |
||||
|
} |
||||
|
|
||||
|
$linkPath, $anchor = $Url -split '#', 2 |
||||
|
$target = Resolve-RepositoryPath -Directory $Directory -Link ([uri]::UnescapeDataString($linkPath)) |
||||
|
if (-not $target) { |
||||
|
return $Url |
||||
|
} |
||||
|
|
||||
|
$fragment = if ($anchor) { '#' + $anchor } else { '' } |
||||
|
if ($pageNames.ContainsKey($target)) { |
||||
|
return $pageNames[$target] + $fragment |
||||
|
} |
||||
|
|
||||
|
$view = if (Test-Path -LiteralPath (Join-Path -Path $repositoryRoot -ChildPath $target) -PathType Container) { |
||||
|
'tree' |
||||
|
} else { |
||||
|
'blob' |
||||
|
} |
||||
|
'{0}/{1}/{2}/{3}{4}' -f $RepositoryUrl.TrimEnd('/'), $view, $Branch, $target, $fragment |
||||
|
} |
||||
|
|
||||
|
function Convert-MarkdownLink { |
||||
|
<# |
||||
|
Returns the Markdown text with the links of a page in Directory converted to wiki addresses. Links in code |
||||
|
spans and fenced code blocks stay unchanged. |
||||
|
#> |
||||
|
[Diagnostics.CodeAnalysis.SuppressMessageAttribute( |
||||
|
'PSReviewUnusedParameter', 'Directory', Justification = 'The match evaluator script block uses it.' |
||||
|
)] |
||||
|
param ( |
||||
|
[Parameter(Mandatory)] |
||||
|
[AllowEmptyString()] |
||||
|
[string] |
||||
|
$Markdown, |
||||
|
|
||||
|
[Parameter(Mandatory)] |
||||
|
[string] |
||||
|
$Directory |
||||
|
) |
||||
|
|
||||
|
$inlinePattern = '(?<code>(?<ticks>`+).+?\k<ticks>)|(?<prefix>!?\[(?:[^\[\]`]|`[^`]*`)*\]\()(?<url>[^)\s]+)(?<suffix>(?:\s+"[^"]*")?\))' |
||||
|
$definitionPattern = '^(?<prefix>\s{0,3}\[[^\]]+\]:\s*)(?<url>\S+)(?<suffix>.*)$' |
||||
|
$convertLink = { |
||||
|
param ($match) |
||||
|
|
||||
|
if ($match.Groups['code'].Success) { |
||||
|
return $match.Value |
||||
|
} |
||||
|
$match.Groups['prefix'].Value + (ConvertTo-WikiLink -Url $match.Groups['url'].Value -Directory $Directory) + |
||||
|
$match.Groups['suffix'].Value |
||||
|
} |
||||
|
|
||||
|
$fence = $null |
||||
|
$lines = foreach ($line in ($Markdown -split '\r?\n')) { |
||||
|
if ($line -match '^\s{0,3}(?<fence>`{3,}|~{3,})') { |
||||
|
if (-not $fence) { |
||||
|
$fence = $Matches['fence'] |
||||
|
} elseif ($Matches['fence'].StartsWith($fence)) { |
||||
|
$fence = $null |
||||
|
} |
||||
|
$line |
||||
|
continue |
||||
|
} |
||||
|
if ($fence) { |
||||
|
$line |
||||
|
continue |
||||
|
} |
||||
|
|
||||
|
$line = [regex]::Replace($line, $inlinePattern, $convertLink) |
||||
|
[regex]::Replace($line, $definitionPattern, $convertLink) |
||||
|
} |
||||
|
|
||||
|
$lines -join "`n" |
||||
|
} |
||||
|
|
||||
|
$docsRoot = (Resolve-Path -LiteralPath $Path).ProviderPath.TrimEnd('\', '/') |
||||
|
$repositoryRoot = Split-Path -Path $docsRoot -Parent |
||||
|
$docsName = Split-Path -Path $docsRoot -Leaf |
||||
|
$destinationRoot = $ExecutionContext.SessionState.Path.GetUnresolvedProviderPathFromPSPath($DestinationPath).TrimEnd('\', '/') |
||||
|
|
||||
|
# Refuse a destination that contains the documentation, such as the repository itself. |
||||
|
$separator = [IO.Path]::DirectorySeparatorChar |
||||
|
if (($docsRoot + $separator).StartsWith($destinationRoot + $separator, [StringComparison]::OrdinalIgnoreCase)) { |
||||
|
throw "The destination '$destinationRoot' contains the documentation in '$docsRoot'. Specify a clone of the wiki." |
||||
|
} |
||||
|
|
||||
|
# Collect the pages: Docs/README.md is the home page, and the contributor guide stays in the repository. |
||||
|
$pageNames = @{} |
||||
|
$pages = foreach ($file in Get-ChildItem -LiteralPath $docsRoot -Filter '*.md' -File -Recurse) { |
||||
|
$repositoryPath = $file.FullName.Substring($repositoryRoot.Length + 1) -replace '\\', '/' |
||||
|
if ($repositoryPath -match ('^{0}/Contributing(?:\.md$|/)' -f [regex]::Escape($docsName))) { |
||||
|
continue |
||||
|
} |
||||
|
|
||||
|
$name = if ($repositoryPath -eq "$docsName/README.md") { 'Home' } else { $file.BaseName } |
||||
|
if ($pageNames.Values -contains $name) { |
||||
|
throw "Two pages in '$docsRoot' would become the wiki page '$name'." |
||||
|
} |
||||
|
$pageNames[$repositoryPath] = $name |
||||
|
|
||||
|
$content = Get-Content -LiteralPath $file.FullName -Raw -Encoding UTF8 |
||||
|
$title = if ($content -match '(?m)^#\s+(?<title>.+?)\s*$') { $Matches['title'] } else { $name -replace '-', ' ' } |
||||
|
[pscustomobject]@{ |
||||
|
Name = $name |
||||
|
Title = $title |
||||
|
Directory = $repositoryPath.Substring(0, $repositoryPath.LastIndexOf('/')) |
||||
|
Content = $content |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
# Remove the old pages, but keep the history of the wiki. |
||||
|
if (Test-Path -LiteralPath $destinationRoot) { |
||||
|
foreach ($item in Get-ChildItem -LiteralPath $destinationRoot -Force | Where-Object -Property Name -NE -Value '.git') { |
||||
|
if ($PSCmdlet.ShouldProcess($item.FullName, 'Remove')) { |
||||
|
Remove-Item -LiteralPath $item.FullName -Recurse -Force |
||||
|
} |
||||
|
} |
||||
|
} elseif ($PSCmdlet.ShouldProcess($destinationRoot, 'Create folder')) { |
||||
|
New-Item -ItemType Directory -Path $destinationRoot | Out-Null |
||||
|
} |
||||
|
|
||||
|
$wikiPages = [ordered]@{} |
||||
|
foreach ($page in $pages) { |
||||
|
$content = [regex]::Replace($page.Content, '\A---\r?\n.*?\r?\n---[ \t]*(?:\r?\n|\z)\s*', '', 'Singleline') |
||||
|
$wikiPages[$page.Name] = Convert-MarkdownLink -Markdown $content -Directory $page.Directory |
||||
|
} |
||||
|
|
||||
|
# The sidebar links the other pages and the cmdlets, grouped like the cmdlet list of the home page. |
||||
|
$homePage = $pages | Where-Object -Property Name -EQ -Value 'Home' |
||||
|
$sidebar = New-Object -TypeName 'System.Collections.Generic.List[string]' |
||||
|
$sidebar.Add('### [Home](Home)') |
||||
|
$sidebar.Add('') |
||||
|
foreach ($page in $pages | Where-Object { $_.Directory -eq $docsName -and $_.Name -ne 'Home' } | Sort-Object -Property Name) { |
||||
|
$sidebar.Add(('- [{0}]({1})' -f $page.Title, $page.Name)) |
||||
|
} |
||||
|
if ($homePage) { |
||||
|
$section = $null |
||||
|
foreach ($line in ($homePage.Content -split '\r?\n')) { |
||||
|
if ($line -match '^##\s+(?<title>.+?)\s*$') { |
||||
|
$section = $Matches['title'] |
||||
|
if ($section -eq 'Cmdlets') { |
||||
|
$sidebar.Add('') |
||||
|
$sidebar.Add('### Cmdlets') |
||||
|
} |
||||
|
} elseif ($section -eq 'Cmdlets' -and $line -match '^###\s+(?<title>.+?)\s*$') { |
||||
|
$sidebar.Add('') |
||||
|
$sidebar.Add(('**{0}**' -f $Matches['title'])) |
||||
|
$sidebar.Add('') |
||||
|
} elseif ($section -eq 'Cmdlets' -and $line -match '^\|\s*\[(?<name>[^\]]+)\]\((?<url>[^)\s]+)\)') { |
||||
|
$sidebar.Add(('- [{0}]({1})' -f $Matches['name'], (ConvertTo-WikiLink -Url $Matches['url'] -Directory $docsName))) |
||||
|
} |
||||
|
} |
||||
|
} |
||||
|
$wikiPages['_Sidebar'] = $sidebar -join "`n" |
||||
|
|
||||
|
$wikiPages['_Footer'] = ('This wiki is generated from the [{0}]({1}/tree/{2}/{0}) folder of the repository. ' + |
||||
|
'To change a page, edit its file there; changes made in the wiki are overwritten.') -f $docsName, $RepositoryUrl.TrimEnd('/'), $Branch |
||||
|
|
||||
|
# The former wiki page How-to-install is linked from outside; it now points to the installation steps. |
||||
|
if ($homePage -and $homePage.Content -match '(?m)^##\s+Installation\s*$') { |
||||
|
$wikiPages['How-to-install'] = "# How to install`n`nThe installation steps are in the [Installation](Home#installation) section of the [Home](Home) page." |
||||
|
} |
||||
|
|
||||
|
$encoding = New-Object -TypeName 'System.Text.UTF8Encoding' -ArgumentList $false |
||||
|
foreach ($name in $wikiPages.Keys) { |
||||
|
$file = Join-Path -Path $destinationRoot -ChildPath "$name.md" |
||||
|
if ($PSCmdlet.ShouldProcess($file, 'Write wiki page')) { |
||||
|
[IO.File]::WriteAllText($file, $wikiPages[$name].TrimEnd() + "`n", $encoding) |
||||
|
} |
||||
|
} |
||||
@ -0,0 +1,79 @@ |
|||||
|
<# |
||||
|
.SYNOPSIS |
||||
|
Runs the Pester tests in the Tests folder and reports the result to GitHub Actions. |
||||
|
|
||||
|
.DESCRIPTION |
||||
|
Imports Pester 5.7.1, runs the tests against the module build in NTFSSecurity\bin\Release, writes the result |
||||
|
file in the NUnit format, and adds the counts and the failed tests to the job summary of GitHub Actions. Fails if |
||||
|
a test or a test file fails. |
||||
|
|
||||
|
.PARAMETER ResultPath |
||||
|
Specifies the path of the result file. |
||||
|
|
||||
|
.PARAMETER Title |
||||
|
Specifies the heading of the test results in the job summary, such as the PowerShell edition. |
||||
|
|
||||
|
.EXAMPLE |
||||
|
.\.github\scripts\Invoke-Tests.ps1 -ResultPath TestResults\WindowsPowerShell.xml -Title 'Windows PowerShell 5.1' |
||||
|
|
||||
|
Runs the tests and writes the result file. Outside GitHub Actions, the script writes no job summary. |
||||
|
#> |
||||
|
[CmdletBinding()] |
||||
|
param ( |
||||
|
[Parameter(Mandatory)] |
||||
|
[ValidateNotNullOrEmpty()] |
||||
|
[string] |
||||
|
$ResultPath, |
||||
|
|
||||
|
[Parameter(Mandatory)] |
||||
|
[ValidateNotNullOrEmpty()] |
||||
|
[string] |
||||
|
$Title |
||||
|
) |
||||
|
|
||||
|
$ErrorActionPreference = 'Stop' |
||||
|
Import-Module -Name Pester -RequiredVersion 5.7.1 |
||||
|
|
||||
|
$resultFolder = Split-Path -Path $ResultPath -Parent |
||||
|
if ($resultFolder -and -not (Test-Path -LiteralPath $resultFolder)) { |
||||
|
New-Item -ItemType Directory -Path $resultFolder | Out-Null |
||||
|
} |
||||
|
|
||||
|
$configuration = New-PesterConfiguration |
||||
|
$configuration.Run.Path = Join-Path -Path $PSScriptRoot -ChildPath '..\..\Tests' |
||||
|
$configuration.Run.PassThru = $true |
||||
|
$configuration.Output.Verbosity = 'Detailed' |
||||
|
$configuration.TestResult.Enabled = $true |
||||
|
$configuration.TestResult.OutputFormat = 'NUnitXml' |
||||
|
$configuration.TestResult.OutputPath = $ResultPath |
||||
|
$result = Invoke-Pester -Configuration $configuration |
||||
|
|
||||
|
if ($env:GITHUB_STEP_SUMMARY) { |
||||
|
$summary = New-Object -TypeName 'System.Collections.Generic.List[string]' |
||||
|
$summary.Add("### Tests in $Title") |
||||
|
$summary.Add('') |
||||
|
$summary.Add('| Result | Passed | Failed | Skipped | Total |') |
||||
|
$summary.Add('| --- | ---: | ---: | ---: | ---: |') |
||||
|
$summary.Add(('| {0} | {1} | {2} | {3} | {4} |' -f $result.Result, $result.PassedCount, $result.FailedCount, |
||||
|
$result.SkippedCount, $result.TotalCount)) |
||||
|
if ($result.Failed.Count -gt 0 -or $result.FailedContainersCount -gt 0) { |
||||
|
$summary.Add('') |
||||
|
$summary.Add('Failed:') |
||||
|
$summary.Add('') |
||||
|
foreach ($test in $result.Failed) { |
||||
|
$message = "$(@($test.ErrorRecord)[0])" -replace '\s+', ' ' |
||||
|
$summary.Add(('- {0}: {1}' -f $test.ExpandedPath, $message)) |
||||
|
} |
||||
|
foreach ($container in $result.Containers | Where-Object -Property Result -EQ -Value 'Failed') { |
||||
|
$summary.Add(('- {0}: {1}' -f $container.Item, ("$(@($container.ErrorRecord)[0])" -replace '\s+', ' '))) |
||||
|
} |
||||
|
} |
||||
|
$summary.Add('') |
||||
|
|
||||
|
$encoding = New-Object -TypeName 'System.Text.UTF8Encoding' -ArgumentList $false |
||||
|
[IO.File]::AppendAllText($env:GITHUB_STEP_SUMMARY, ($summary -join "`n") + "`n", $encoding) |
||||
|
} |
||||
|
|
||||
|
if ($result.Result -ne 'Passed') { |
||||
|
throw "The tests in $Title failed: $($result.FailedCount) failed tests, $($result.FailedContainersCount) failed test files." |
||||
|
} |
||||
@ -0,0 +1,181 @@ |
|||||
|
# Builds the NTFSSecurity module from source, checks that the cmdlet |
||||
|
# documentation in Docs/Cmdlets and the help file generated from it match the |
||||
|
# cmdlets of that build, runs the Pester tests in Windows PowerShell 5.1 and |
||||
|
# PowerShell 7, and publishes Docs to the GitHub wiki from master. |
||||
|
name: CI |
||||
|
|
||||
|
on: |
||||
|
pull_request: |
||||
|
push: |
||||
|
branches: |
||||
|
- master |
||||
|
workflow_dispatch: |
||||
|
|
||||
|
permissions: |
||||
|
contents: read |
||||
|
|
||||
|
concurrency: |
||||
|
group: ci-${{ github.ref }} |
||||
|
cancel-in-progress: ${{ github.event_name == 'pull_request' }} |
||||
|
|
||||
|
jobs: |
||||
|
build: |
||||
|
name: Build and test |
||||
|
runs-on: windows-2025 |
||||
|
timeout-minutes: 30 |
||||
|
steps: |
||||
|
- name: Keep Windows line endings in the working tree |
||||
|
run: git config --global core.autocrlf true |
||||
|
|
||||
|
- name: Check out the repository |
||||
|
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 |
||||
|
with: |
||||
|
persist-credentials: false |
||||
|
|
||||
|
- name: Install platyPS, MarkdownLinkCheck, and Pester |
||||
|
shell: powershell |
||||
|
run: | |
||||
|
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12 |
||||
|
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force | Out-Null |
||||
|
# Installed for all users, so that PowerShell 7 finds the modules, too |
||||
|
Install-Module -Name platyPS -RequiredVersion 0.14.2 -Scope AllUsers -Force |
||||
|
Install-Module -Name MarkdownLinkCheck -RequiredVersion 0.2.0 -Scope AllUsers -Force |
||||
|
# The image includes Pester 3.4.0, which is signed by a different publisher. |
||||
|
Install-Module -Name Pester -RequiredVersion 5.7.1 -Scope AllUsers -Force -SkipPublisherCheck |
||||
|
|
||||
|
- name: Restore the NuGet packages |
||||
|
shell: powershell |
||||
|
run: | |
||||
|
nuget restore NTFSSecurity\packages.config -PackagesDirectory packages -NonInteractive |
||||
|
if ($LASTEXITCODE -ne 0) { |
||||
|
throw "NuGet failed with exit code $LASTEXITCODE." |
||||
|
} |
||||
|
nuget restore Security2\packages.config -PackagesDirectory packages -NonInteractive |
||||
|
if ($LASTEXITCODE -ne 0) { |
||||
|
throw "NuGet failed with exit code $LASTEXITCODE." |
||||
|
} |
||||
|
# Provides the .NET Framework 4.5.2 reference assemblies, so the build does |
||||
|
# not depend on a targeting pack installed on the runner. |
||||
|
nuget install Microsoft.NETFramework.ReferenceAssemblies.net452 -Version 1.0.3 -OutputDirectory packages -NonInteractive |
||||
|
if ($LASTEXITCODE -ne 0) { |
||||
|
throw "NuGet failed with exit code $LASTEXITCODE." |
||||
|
} |
||||
|
|
||||
|
- name: Build the module |
||||
|
id: build |
||||
|
shell: powershell |
||||
|
run: | |
||||
|
# MSBuild isn't on the path of the runner; vswhere finds the one of Visual Studio. |
||||
|
$vswhere = Join-Path -Path ${env:ProgramFiles(x86)} -ChildPath 'Microsoft Visual Studio\Installer\vswhere.exe' |
||||
|
$msbuild = & $vswhere -latest -requires Microsoft.Component.MSBuild -find 'MSBuild\**\Bin\MSBuild.exe' | Select-Object -First 1 |
||||
|
if (-not $msbuild) { |
||||
|
throw 'MSBuild was not found.' |
||||
|
} |
||||
|
$referenceAssemblies = "$env:GITHUB_WORKSPACE\packages\Microsoft.NETFramework.ReferenceAssemblies.net452.1.0.3\build" |
||||
|
& $msbuild NTFSSecurity\NTFSSecurity.csproj /nologo /verbosity:minimal /p:Configuration=Release "/p:TargetFrameworkRootPath=$referenceAssemblies" "/p:FrameworkPathOverride=$referenceAssemblies\.NETFramework\v4.5.2" |
||||
|
if ($LASTEXITCODE -ne 0) { |
||||
|
throw "MSBuild failed with exit code $LASTEXITCODE." |
||||
|
} |
||||
|
|
||||
|
- name: Check the documentation against the build |
||||
|
shell: powershell |
||||
|
run: | |
||||
|
Import-Module -Name platyPS -RequiredVersion 0.14.2 |
||||
|
Import-Module -Name MarkdownLinkCheck -RequiredVersion 0.2.0 |
||||
|
Import-Module -Name .\NTFSSecurity\bin\Release\NTFSSecurity.psd1 -Force |
||||
|
|
||||
|
# 01. Test that the documentation matches the cmdlets built from source |
||||
|
Update-MarkdownHelp -Path ./Docs/Cmdlets | Out-Null |
||||
|
$diff = git diff -- Docs/Cmdlets |
||||
|
if ($diff) { |
||||
|
throw "Help is not up-to-date, run Update-MarkdownHelp: $diff" |
||||
|
} |
||||
|
|
||||
|
# 02. Verify hyperlinks |
||||
|
$brokenLinks = Get-MarkdownLink -Path .\Docs\ -BrokenOnly |
||||
|
if ($brokenLinks) { |
||||
|
throw "Found broken hyperlinks $brokenLinks" |
||||
|
} |
||||
|
|
||||
|
# 03. Test that the help file of the module matches the documentation |
||||
|
New-ExternalHelp -Path ./Docs/Cmdlets -OutputPath ./NTFSSecurity/en-US -Force | Out-Null |
||||
|
$helpChanges = git status --porcelain -- NTFSSecurity/en-US |
||||
|
if ($helpChanges) { |
||||
|
throw "The help file is not up-to-date, run New-ExternalHelp -Path .\Docs\Cmdlets -OutputPath .\NTFSSecurity\en-US -Force: $helpChanges" |
||||
|
} |
||||
|
|
||||
|
# 04. Run the Pester tests against the build, also when the documentation check failed |
||||
|
- name: Run the tests in Windows PowerShell 5.1 |
||||
|
if: ${{ !cancelled() && steps.build.outcome == 'success' }} |
||||
|
shell: powershell |
||||
|
run: .\.github\scripts\Invoke-Tests.ps1 -ResultPath TestResults\WindowsPowerShell.xml -Title 'Windows PowerShell 5.1' |
||||
|
|
||||
|
- name: Run the tests in PowerShell 7 |
||||
|
if: ${{ !cancelled() && steps.build.outcome == 'success' }} |
||||
|
shell: pwsh |
||||
|
run: ./.github/scripts/Invoke-Tests.ps1 -ResultPath TestResults/PowerShell7.xml -Title 'PowerShell 7' |
||||
|
|
||||
|
- name: Upload the test results |
||||
|
if: ${{ !cancelled() }} |
||||
|
uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1 |
||||
|
with: |
||||
|
name: test-results |
||||
|
path: TestResults/ |
||||
|
if-no-files-found: ignore |
||||
|
|
||||
|
wiki: |
||||
|
name: Wiki |
||||
|
needs: build |
||||
|
runs-on: ubuntu-latest |
||||
|
timeout-minutes: 10 |
||||
|
# Only this job can write: it publishes the wiki from master. On pull |
||||
|
# requests, it shows the pages that would change. |
||||
|
permissions: |
||||
|
contents: write |
||||
|
steps: |
||||
|
- name: Check out the repository |
||||
|
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 |
||||
|
with: |
||||
|
persist-credentials: false |
||||
|
|
||||
|
- name: Generate the wiki pages |
||||
|
shell: pwsh |
||||
|
env: |
||||
|
GH_TOKEN: ${{ github.token }} |
||||
|
run: | |
||||
|
gh auth setup-git |
||||
|
$wiki = Join-Path -Path $env:RUNNER_TEMP -ChildPath 'wiki' |
||||
|
git clone --quiet --depth 1 "$env:GITHUB_SERVER_URL/$env:GITHUB_REPOSITORY.wiki.git" $wiki |
||||
|
if ($LASTEXITCODE -ne 0) { |
||||
|
throw "Cloning the wiki failed with exit code $LASTEXITCODE." |
||||
|
} |
||||
|
./.github/scripts/Export-WikiContent.ps1 -Path ./Docs -DestinationPath $wiki -RepositoryUrl "$env:GITHUB_SERVER_URL/$env:GITHUB_REPOSITORY" |
||||
|
git -C $wiki add --all |
||||
|
$changes = @(git -C $wiki diff --cached --name-status) |
||||
|
$summary = if ($changes) { |
||||
|
@('### Wiki', '', 'Changed pages (A added, M modified, D deleted):', '', '```text') + $changes + @('```') |
||||
|
} else { |
||||
|
@('### Wiki', '', 'The wiki is up to date.') |
||||
|
} |
||||
|
Add-Content -LiteralPath $env:GITHUB_STEP_SUMMARY -Value $summary |
||||
|
Add-Content -LiteralPath $env:GITHUB_ENV -Value "WIKI_PATH=$wiki" |
||||
|
|
||||
|
- name: Publish the wiki |
||||
|
if: ${{ github.ref == 'refs/heads/master' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch') }} |
||||
|
shell: pwsh |
||||
|
env: |
||||
|
GH_TOKEN: ${{ github.token }} |
||||
|
run: | |
||||
|
git -C $env:WIKI_PATH diff --cached --quiet |
||||
|
if ($LASTEXITCODE -eq 0) { |
||||
|
'The wiki is up to date.' |
||||
|
exit 0 |
||||
|
} |
||||
|
git -C $env:WIKI_PATH -c user.name='github-actions[bot]' -c user.email='41898282+github-actions[bot]@users.noreply.github.com' commit --quiet --message "Update from $env:GITHUB_SHA" |
||||
|
if ($LASTEXITCODE -ne 0) { |
||||
|
throw "Committing the wiki failed with exit code $LASTEXITCODE." |
||||
|
} |
||||
|
git -C $env:WIKI_PATH push --quiet |
||||
|
if ($LASTEXITCODE -ne 0) { |
||||
|
throw "Publishing the wiki failed with exit code $LASTEXITCODE." |
||||
|
} |
||||
@ -0,0 +1,27 @@ |
|||||
|
--- |
||||
|
status: accepted |
||||
|
date: 2026-10-04 |
||||
|
last-verified: 2026-10-04 |
||||
|
owner: shared |
||||
|
source: maintainer decision after work package 4 |
||||
|
--- |
||||
|
|
||||
|
# Decision 11: CI and the wiki run on GitHub Actions |
||||
|
|
||||
|
- Choice: `.github/workflows/ci.yml` replaces AppVeyor. On pull requests and |
||||
|
pushes to `master`, the `build` job (`windows-2025`) builds the module in |
||||
|
Release, checks the docs against the build, and runs the Pester tests in |
||||
|
Windows PowerShell 5.1 and PowerShell 7. The `wiki` job converts `Docs` |
||||
|
with `.github/scripts/Export-WikiContent.ps1` and publishes the wiki from |
||||
|
`master` with the built-in token; on pull requests it lists the pages that |
||||
|
would change. `appveyor.yml` is removed. |
||||
|
- Rationale: The maintainer wants a browsable wiki without a second, hand- |
||||
|
written copy of the docs (the 2018 wiki went stale), and one CI platform |
||||
|
instead of two. Public repositories get Windows runners for free, and the |
||||
|
checks appear on the pull request without a third-party service. |
||||
|
- Consequences: `Docs` stays the only source (Decision 9); the wiki is a |
||||
|
generated mirror, and edits made in the wiki are overwritten. Only the |
||||
|
`wiki` job has `contents: write`; actions are pinned by commit SHA. Test |
||||
|
results appear in the job summary and as the `test-results` artifact. |
||||
|
- Rejected: a hand-maintained wiki next to `Docs`, publishing the wiki by |
||||
|
hand at release time, and keeping AppVeyor for build and tests. |
||||
@ -0,0 +1,228 @@ |
|||||
|
<# |
||||
|
Tests .github\scripts\Export-WikiContent.ps1, which converts the documentation in Docs into the pages of the |
||||
|
GitHub wiki: with a small sample of Docs for the conversion rules, and with the real Docs for complete pages and |
||||
|
working links. |
||||
|
#> |
||||
|
[Diagnostics.CodeAnalysis.SuppressMessageAttribute( |
||||
|
'PSUseDeclaredVarsMoreThanAssignments', '', Justification = 'Pester shares variables between blocks.' |
||||
|
)] |
||||
|
param () |
||||
|
|
||||
|
BeforeAll { |
||||
|
$exportScript = Join-Path -Path $PSScriptRoot -ChildPath '..\.github\scripts\Export-WikiContent.ps1' |
||||
|
|
||||
|
function Get-GitHubAnchor { |
||||
|
# Returns the anchors that GitHub generates for the headings of a Markdown text. |
||||
|
param ( |
||||
|
[Parameter(Mandatory)] |
||||
|
[string] |
||||
|
$Markdown |
||||
|
) |
||||
|
|
||||
|
$text = [regex]::Replace($Markdown, '(?ms)^```.*?^```', '') |
||||
|
$seen = @{} |
||||
|
foreach ($match in [regex]::Matches($text, '(?m)^#{1,6}\s+(.+?)\s*#*\s*$')) { |
||||
|
$heading = $match.Groups[1].Value -replace '\[([^\]]*)\]\([^)]*\)', '$1' -replace '[`*]', '' |
||||
|
$anchor = [regex]::Replace($heading.Trim().ToLowerInvariant(), '[^\p{L}\p{Nd}\s_-]', '') -replace ' ', '-' |
||||
|
if ($seen.ContainsKey($anchor)) { |
||||
|
$seen[$anchor]++ |
||||
|
'{0}-{1}' -f $anchor, $seen[$anchor] |
||||
|
} else { |
||||
|
$seen[$anchor] = 0 |
||||
|
$anchor |
||||
|
} |
||||
|
} |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
Describe 'Export-WikiContent.ps1' { |
||||
|
Context 'When it converts a sample of Docs' { |
||||
|
BeforeAll { |
||||
|
$repositoryPath = Join-Path -Path $TestDrive -ChildPath 'repository' |
||||
|
$docsPath = Join-Path -Path $repositoryPath -ChildPath 'Docs' |
||||
|
$wikiPath = Join-Path -Path $TestDrive -ChildPath 'wiki' |
||||
|
foreach ($folder in "$docsPath\Cmdlets", "$docsPath\Contributing", "$wikiPath\.git") { |
||||
|
New-Item -ItemType Directory -Path $folder -Force | Out-Null |
||||
|
} |
||||
|
|
||||
|
# A clone of the wiki with pages that Docs doesn't have |
||||
|
Set-Content -LiteralPath "$wikiPath\.git\config" -Value '[core]' |
||||
|
Set-Content -LiteralPath "$wikiPath\Version-History.textile" -Value '* 4.2.4' |
||||
|
Set-Content -LiteralPath "$wikiPath\Old-Page.md" -Value '# Old page' |
||||
|
|
||||
|
Set-Content -LiteralPath "$repositoryPath\CHANGELOG.md" -Value '# Changelog' |
||||
|
Set-Content -LiteralPath "$docsPath\Contributing.md" -Value '# Contributing' |
||||
|
Set-Content -LiteralPath "$docsPath\Contributing\01-Getting-Started.md" -Value '# Get started' |
||||
|
Set-Content -LiteralPath "$docsPath\Concepts.md" -Value "# Concepts`n`n## Rights`n`nSee [Home](README.md)." |
||||
|
Set-Content -LiteralPath "$docsPath\README.md" -Value @' |
||||
|
# Thing |
||||
|
|
||||
|
[Concepts](Concepts.md#rights), [Get-Thing](Cmdlets/Get-Thing.md), and [`Set-Thing`](Cmdlets/Set-Thing.md). |
||||
|
[Changelog](../CHANGELOG.md), [guide](Contributing.md), and [first steps](Contributing/01-Getting-Started.md). |
||||
|
[Example site](https://example.com/page.md) and [cmdlets](#cmdlets). |
||||
|
Code keeps its links: `[Concepts](Concepts.md)`. |
||||
|
|
||||
|
```powershell |
||||
|
# [Concepts](Concepts.md) |
||||
|
``` |
||||
|
|
||||
|
## Installation |
||||
|
|
||||
|
Install the module. |
||||
|
|
||||
|
## Cmdlets |
||||
|
|
||||
|
### Getting |
||||
|
|
||||
|
| Cmdlet | Description | |
||||
|
| --- | --- | |
||||
|
| [Get-Thing](Cmdlets/Get-Thing.md) | Gets a thing. | |
||||
|
|
||||
|
### Setting |
||||
|
|
||||
|
| Cmdlet | Description | |
||||
|
| --- | --- | |
||||
|
| [Set-Thing](Cmdlets/Set-Thing.md) | Sets a thing. | |
||||
|
'@ |
||||
|
$metadata = "---`nexternal help file: Thing.dll-Help.xml`nonline version: https://example.com`nschema: 2.0.0`n---`n`n" |
||||
|
Set-Content -LiteralPath "$docsPath\Cmdlets\Get-Thing.md" -Value ($metadata + |
||||
|
"# Get-Thing`n`nSee [rights](../Concepts.md#rights), [Set-Thing](Set-Thing.md), and [home](../README.md).") |
||||
|
Set-Content -LiteralPath "$docsPath\Cmdlets\Set-Thing.md" -Value ($metadata + |
||||
|
"# Set-Thing`n`nSee [Get-Thing](Get-Thing.md).") |
||||
|
|
||||
|
& $exportScript -Path $docsPath -DestinationPath $wikiPath -RepositoryUrl 'https://github.com/contoso/Thing' -Branch 'main' |
||||
|
|
||||
|
$homePage = Get-Content -LiteralPath "$wikiPath\Home.md" -Raw |
||||
|
$sidebar = Get-Content -LiteralPath "$wikiPath\_Sidebar.md" -Raw |
||||
|
} |
||||
|
|
||||
|
It 'Should write Home, Concepts, the cmdlet pages, How-to-install, the sidebar, and the footer' { |
||||
|
$expected = 'Home.md', 'Concepts.md', 'Get-Thing.md', 'Set-Thing.md', 'How-to-install.md', '_Sidebar.md', '_Footer.md' |
||||
|
|
||||
|
((Get-ChildItem -LiteralPath $wikiPath -File).Name | Sort-Object) -join ', ' | |
||||
|
Should -BeExactly (($expected | Sort-Object) -join ', ') |
||||
|
} |
||||
|
|
||||
|
It 'Should keep the .git folder and remove the pages that Docs does not have' { |
||||
|
"$wikiPath\.git\config" | Should -Exist |
||||
|
"$wikiPath\Version-History.textile" | Should -Not -Exist |
||||
|
"$wikiPath\Old-Page.md" | Should -Not -Exist |
||||
|
} |
||||
|
|
||||
|
It 'Should not publish the contributor guide' { |
||||
|
Get-ChildItem -LiteralPath $wikiPath -Recurse -File -Filter '*Get*Started*' | Should -BeNullOrEmpty |
||||
|
"$wikiPath\Contributing.md" | Should -Not -Exist |
||||
|
} |
||||
|
|
||||
|
It 'Should convert <Link> on <Page> into <Expected>' -ForEach @( |
||||
|
@{ Page = 'Home'; Link = '[Concepts](Concepts.md#rights)'; Expected = '[Concepts](Concepts#rights)' } |
||||
|
@{ Page = 'Home'; Link = '[Get-Thing](Cmdlets/Get-Thing.md)'; Expected = '[Get-Thing](Get-Thing)' } |
||||
|
@{ Page = 'Home'; Link = '[`Set-Thing`](Cmdlets/Set-Thing.md)'; Expected = '[`Set-Thing`](Set-Thing)' } |
||||
|
@{ Page = 'Home'; Link = '[Changelog](../CHANGELOG.md)'; Expected = '[Changelog](https://github.com/contoso/Thing/blob/main/CHANGELOG.md)' } |
||||
|
@{ Page = 'Home'; Link = '[guide](Contributing.md)'; Expected = '[guide](https://github.com/contoso/Thing/blob/main/Docs/Contributing.md)' } |
||||
|
@{ Page = 'Home'; Link = '[first steps](Contributing/01-Getting-Started.md)'; Expected = '[first steps](https://github.com/contoso/Thing/blob/main/Docs/Contributing/01-Getting-Started.md)' } |
||||
|
@{ Page = 'Home'; Link = '[Example site](https://example.com/page.md)'; Expected = '[Example site](https://example.com/page.md)' } |
||||
|
@{ Page = 'Home'; Link = '[cmdlets](#cmdlets)'; Expected = '[cmdlets](#cmdlets)' } |
||||
|
@{ Page = 'Concepts'; Link = '[Home](README.md)'; Expected = '[Home](Home)' } |
||||
|
@{ Page = 'Get-Thing'; Link = '[rights](../Concepts.md#rights)'; Expected = '[rights](Concepts#rights)' } |
||||
|
@{ Page = 'Get-Thing'; Link = '[Set-Thing](Set-Thing.md)'; Expected = '[Set-Thing](Set-Thing)' } |
||||
|
@{ Page = 'Get-Thing'; Link = '[home](../README.md)'; Expected = '[home](Home)' } |
||||
|
) { |
||||
|
$content = Get-Content -LiteralPath "$wikiPath\$Page.md" -Raw |
||||
|
|
||||
|
$content | Should -Match ([regex]::Escape($Expected)) |
||||
|
if ($Link -ne $Expected) { |
||||
|
$content | Should -Not -Match ([regex]::Escape($Link)) |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
It 'Should keep links in code unchanged' { |
||||
|
$homePage | Should -Match ([regex]::Escape('`[Concepts](Concepts.md)`')) |
||||
|
$homePage | Should -Match ([regex]::Escape('# [Concepts](Concepts.md)')) |
||||
|
} |
||||
|
|
||||
|
It 'Should remove the platyPS metadata from the cmdlet pages' { |
||||
|
Get-Content -LiteralPath "$wikiPath\Get-Thing.md" -TotalCount 1 | Should -BeExactly '# Get-Thing' |
||||
|
} |
||||
|
|
||||
|
It 'Should link Home and the other pages in the sidebar' { |
||||
|
$sidebar | Should -Match ([regex]::Escape('[Home](Home)')) |
||||
|
$sidebar | Should -Match ([regex]::Escape('[Concepts](Concepts)')) |
||||
|
} |
||||
|
|
||||
|
It 'Should list the cmdlets in the sidebar under the groups of Docs/README.md' { |
||||
|
$sidebar | Should -Match '(?s)Getting.*\[Get-Thing\]\(Get-Thing\).*Setting.*\[Set-Thing\]\(Set-Thing\)' |
||||
|
} |
||||
|
|
||||
|
It 'Should say in the footer that the wiki is generated from Docs' { |
||||
|
Get-Content -LiteralPath "$wikiPath\_Footer.md" -Raw | |
||||
|
Should -Match ([regex]::Escape('(https://github.com/contoso/Thing/tree/main/Docs)')) |
||||
|
} |
||||
|
|
||||
|
It 'Should keep the address of the former page How-to-install' { |
||||
|
Get-Content -LiteralPath "$wikiPath\How-to-install.md" -Raw | Should -Match ([regex]::Escape('(Home#installation)')) |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
Context 'When it converts the documentation of the repository' { |
||||
|
BeforeAll { |
||||
|
$repositoryPath = Join-Path -Path $PSScriptRoot -ChildPath '..' |
||||
|
$docsPath = Join-Path -Path $repositoryPath -ChildPath 'Docs' |
||||
|
$wikiPath = Join-Path -Path $TestDrive -ChildPath 'wiki-of-the-repository' |
||||
|
|
||||
|
& $exportScript -Path $docsPath -DestinationPath $wikiPath |
||||
|
|
||||
|
$pages = Get-ChildItem -LiteralPath $wikiPath -Filter '*.md' |
||||
|
$cmdletNames = (Get-ChildItem -LiteralPath (Join-Path -Path $docsPath -ChildPath 'Cmdlets') -Filter '*.md').BaseName |
||||
|
} |
||||
|
|
||||
|
It 'Should write a page for every page in Docs except the contributor guide, and one for every cmdlet' { |
||||
|
$topPages = (Get-ChildItem -LiteralPath $docsPath -Filter '*.md' | |
||||
|
Where-Object -Property Name -NotIn -Value 'README.md', 'Contributing.md').BaseName |
||||
|
$expected = @('Home', 'How-to-install', '_Sidebar', '_Footer') + $topPages + $cmdletNames |
||||
|
|
||||
|
($pages.BaseName | Sort-Object) -join ', ' | Should -BeExactly (($expected | Sort-Object) -join ', ') |
||||
|
} |
||||
|
|
||||
|
It 'Should keep the page name Version-History, which the release notes of 4.2.4 and 4.2.6 link to' { |
||||
|
Join-Path -Path $wikiPath -ChildPath 'Version-History.md' | Should -Exist |
||||
|
} |
||||
|
|
||||
|
It 'Should list every cmdlet in the sidebar' { |
||||
|
$sidebar = Get-Content -LiteralPath (Join-Path -Path $wikiPath -ChildPath '_Sidebar.md') -Raw |
||||
|
|
||||
|
$cmdletNames | Where-Object -FilterScript { $sidebar -notmatch ('\]\({0}\)' -f [regex]::Escape($_)) } | |
||||
|
Should -BeNullOrEmpty |
||||
|
} |
||||
|
|
||||
|
It 'Should link only to existing wiki pages, their anchors, and existing files of the repository' { |
||||
|
$anchors = @{} |
||||
|
foreach ($page in $pages) { |
||||
|
$anchors[$page.BaseName] = @(Get-GitHubAnchor -Markdown (Get-Content -LiteralPath $page.FullName -Raw)) |
||||
|
} |
||||
|
|
||||
|
$brokenLinks = foreach ($page in $pages) { |
||||
|
$text = [regex]::Replace((Get-Content -LiteralPath $page.FullName -Raw), '(?ms)^```.*?^```', '') |
||||
|
$text = [regex]::Replace($text, '`[^`\n]+`', '') |
||||
|
foreach ($match in [regex]::Matches($text, '\]\((?<url>[^)\s]+)\)')) { |
||||
|
$url = $match.Groups['url'].Value |
||||
|
if ($url -match '^https://github\.com/raandree/NTFSSecurity/(?:blob|tree)/master/(?<path>[^#]+)') { |
||||
|
if (-not (Test-Path -LiteralPath (Join-Path -Path $repositoryPath -ChildPath $Matches['path']))) { |
||||
|
'{0}: {1}' -f $page.BaseName, $url |
||||
|
} |
||||
|
} elseif ($url -notmatch '^[a-z]+:') { |
||||
|
$target, $anchor = $url -split '#', 2 |
||||
|
if (-not $target) { |
||||
|
$target = $page.BaseName |
||||
|
} |
||||
|
if (-not $anchors.ContainsKey($target) -or ($anchor -and $anchors[$target] -notcontains $anchor)) { |
||||
|
'{0}: {1}' -f $page.BaseName, $url |
||||
|
} |
||||
|
} |
||||
|
} |
||||
|
} |
||||
|
|
||||
|
$brokenLinks | Should -BeNullOrEmpty |
||||
|
} |
||||
|
} |
||||
|
} |
||||
@ -1,86 +0,0 @@ |
|||||
# Builds the NTFSSecurity module from source, checks that the cmdlet |
|
||||
# documentation in Docs/Cmdlets and the help file generated from it match the |
|
||||
# cmdlets of that build, and runs the Pester tests against the build. |
|
||||
image: Visual Studio 2022 |
|
||||
|
|
||||
init: |
|
||||
- ps: git config --global core.autocrlf true |
|
||||
|
|
||||
install: |
|
||||
- ps: | |
|
||||
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12 |
|
||||
Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force | Out-Null |
|
||||
Install-Module -Name platyPS -RequiredVersion 0.14.2 -Force |
|
||||
Install-Module -Name MarkdownLinkCheck -RequiredVersion 0.2.0 -Force |
|
||||
# The image includes Pester 3.4.0, which is signed by a different publisher. |
|
||||
Install-Module -Name Pester -RequiredVersion 5.7.1 -Force -SkipPublisherCheck |
|
||||
|
|
||||
before_build: |
|
||||
- nuget restore NTFSSecurity\packages.config -PackagesDirectory packages -NonInteractive |
|
||||
- nuget restore Security2\packages.config -PackagesDirectory packages -NonInteractive |
|
||||
# Provides the .NET Framework 4.5.2 reference assemblies, so the build does |
|
||||
# not depend on a targeting pack installed on the build image. |
|
||||
- nuget install Microsoft.NETFramework.ReferenceAssemblies.net452 -Version 1.0.3 -OutputDirectory packages -NonInteractive |
|
||||
|
|
||||
build_script: |
|
||||
- ps: | |
|
||||
$referenceAssemblies = "$env:APPVEYOR_BUILD_FOLDER\packages\Microsoft.NETFramework.ReferenceAssemblies.net452.1.0.3\build" |
|
||||
msbuild NTFSSecurity\NTFSSecurity.csproj /nologo /verbosity:minimal /p:Configuration=Release "/p:TargetFrameworkRootPath=$referenceAssemblies" "/p:FrameworkPathOverride=$referenceAssemblies\.NETFramework\v4.5.2" |
|
||||
if ($LASTEXITCODE -ne 0) { |
|
||||
throw "MSBuild failed with exit code $LASTEXITCODE." |
|
||||
} |
|
||||
|
|
||||
test_script: |
|
||||
- ps: | |
|
||||
$ErrorActionPreference = 'Stop' |
|
||||
Import-Module -Name platyPS |
|
||||
Import-Module -Name MarkdownLinkCheck |
|
||||
Import-Module -Name .\NTFSSecurity\bin\Release\NTFSSecurity.psd1 -Force |
|
||||
|
|
||||
# 01. Test that the documentation matches the cmdlets built from source |
|
||||
Update-MarkdownHelp -Path ./Docs/Cmdlets | Out-Null |
|
||||
$diff = git diff -- Docs/Cmdlets |
|
||||
if ($diff) { |
|
||||
throw "Help is not up-to-date, run Update-MarkdownHelp: $diff" |
|
||||
} |
|
||||
|
|
||||
# 02. Verify hyperlinks |
|
||||
$brokenLinks = Get-MarkdownLink -Path .\Docs\ -BrokenOnly |
|
||||
if ($brokenLinks) { |
|
||||
throw "Found broken hyperlinks $brokenLinks" |
|
||||
} |
|
||||
|
|
||||
# 03. Test that the help file of the module matches the documentation |
|
||||
New-ExternalHelp -Path ./Docs/Cmdlets -OutputPath ./NTFSSecurity/en-US -Force | Out-Null |
|
||||
$helpChanges = git status --porcelain -- NTFSSecurity/en-US |
|
||||
if ($helpChanges) { |
|
||||
throw "The help file is not up-to-date, run New-ExternalHelp -Path .\Docs\Cmdlets -OutputPath .\NTFSSecurity\en-US -Force: $helpChanges" |
|
||||
} |
|
||||
|
|
||||
# 04. Run the Pester tests against the module build |
|
||||
Import-Module -Name Pester -RequiredVersion 5.7.1 |
|
||||
$configuration = New-PesterConfiguration |
|
||||
$configuration.Run.Path = '.\Tests' |
|
||||
$configuration.Run.PassThru = $true |
|
||||
$configuration.Output.Verbosity = 'Detailed' |
|
||||
$result = Invoke-Pester -Configuration $configuration |
|
||||
|
|
||||
# Report every test once on the Tests tab. An uploaded NUnit file lists a |
|
||||
# Pester 5 test once for each block that contains it. |
|
||||
if ($env:APPVEYOR_API_URL -and $result.Tests) { |
|
||||
$tests = @(foreach ($test in $result.Tests) { |
|
||||
@{ |
|
||||
testName = $test.ExpandedPath |
|
||||
testFramework = 'Pester' |
|
||||
fileName = Split-Path -Path $test.ScriptBlock.File -Leaf |
|
||||
outcome = if ($test.Result -eq 'NotRun') { 'NotRunnable' } else { "$($test.Result)" } |
|
||||
durationMilliseconds = [long] $test.Duration.TotalMilliseconds |
|
||||
ErrorMessage = @($test.ErrorRecord | ForEach-Object -Process { "$_" }) -join [Environment]::NewLine |
|
||||
} |
|
||||
}) |
|
||||
$body = [Text.Encoding]::UTF8.GetBytes((ConvertTo-Json -InputObject $tests -Compress)) |
|
||||
Invoke-RestMethod -Method Post -Uri ($env:APPVEYOR_API_URL.TrimEnd('/') + '/api/tests/batch') -Body $body -ContentType 'application/json; charset=utf-8' | Out-Null |
|
||||
} |
|
||||
if ($result.FailedCount -gt 0) { |
|
||||
throw "$($result.FailedCount) Pester tests failed." |
|
||||
} |
|
||||
Loading…
Reference in new issue