.build.ps1

param (
    [Parameter()]
    [version] $ModuleVersion = '0.0.0',

    [Parameter()]
    [string] $ApiKey
)

[string] $Script:RootModule = 'PoshToolbox'


task CleanModule {
    Remove-Module $RootModule -Force -ErrorAction 'Ignore'
}


task CleanFiles {
    Remove-Item -Path "./${RootModule}/" -Recurse -Force -ErrorAction 'Ignore'
}


task CleanLibrary {
    assert (Test-Path -Path './src/Classes/Classes.csproj')

    exec { dotnet clean './src/Classes/Classes.csproj' }
}


task LoadChangeLog {
    assert (Test-Path -Path './CHANGELOG.md')

    [object[]] $Latest = Select-String -Path './CHANGELOG.md' -Pattern '^## \[(\d\.\d\.\d)\]' |
        Select-Object LineNumber -First 2

    [string[]] $ReleaseNotes = Get-Content -Path './CHANGELOG.md' -TotalCount ($Latest[1].LineNumber - 1) |
        Select-Object -Skip $Latest[0].LineNumber

    [string[]] $Script:ReleaseNotes = $ReleaseNotes -replace '\[.\d+\]\(.*$'
}


task LoadModuleManifest {
    assert (Test-Path -Path "./src/${RootModule}.psd1")

    [hashtable] $Script:ModuleManifest = Import-PowerShellDataFile -Path "./src/${RootModule}.psd1"

    $Script:ModuleManifest += $ModuleManifest.PrivateData.PSData
    $Script:ModuleManifest.Remove('PrivateData')
}


task BuildLibrary {
    assert (Test-Path -Path './src/Classes/Classes.csproj')

    exec { dotnet build './src/Classes/Classes.csproj' --output "./${RootModule}/${ModuleVersion}/" --property:Version="${ModuleVersion}" --property:Module="${RootModule}" --configuration 'Release' }
}


task BuildModule {
    [System.IO.FileInfo] $Script:ModuleFile = New-Item -ItemType 'File' -Path "./${RootModule}/${ModuleVersion}/${RootModule}.psm1" -Force

    [object[]] $Functions = Get-ChildItem -Path './src/*/*.ps1' | Group-Object { $_.Directory.BaseName }
    [string[]] $Script:FunctionsToExport = $Functions | Where-Object -Property 'Name' -EQ 'Public' | & { Process { $_.Group.BaseName } }

    foreach ($Function in $Functions) {
        Add-Content -Path $ModuleFile -Value "#region: $( $Group.Name )"

        foreach ($File in $Function.Group) {
            Add-Content -Path $ModuleFile -Value "#region: $( Resolve-Path -Path $File -Relative )"
            Add-Content -Path $ModuleFile -Value (Get-Content -Path $File)
            Add-Content -Path $ModuleFile -Value '#endregion'
        }

        Add-Content -Path $ModuleFile -Value '#endregion'
    }
}


task BuildHelp {
    assert (Test-Path -Path './docs/')

    New-ExternalHelp -Path './docs/' -OutputPath "./${RootModule}/${ModuleVersion}/en-US/" -Encoding ([System.Text.Encoding]::UTF8) -Force
}


task BuildModuleManifest {
    $Script:ModuleManifest.ModuleVersion = $ModuleVersion
    $Script:ModuleManifest.FunctionsToExport = $FunctionsToExport
    $Script:ModuleManifest.AliasesToExport = [string[]] (Import-Module $ModuleFile -PassThru).ExportedAliases.Keys
    $Script:ModuleManifest.ReleaseNotes = $ReleaseNotes | Out-String

    New-ModuleManifest @ModuleManifest -Path "./${RootModule}/${ModuleVersion}/${RootModule}.psd1"
}


task LoadModule {
    assert (Test-Path -Path "./${RootModule}/${ModuleVersion}/${RootModule}.psd1")

    Import-Module "./${RootModule}/${ModuleVersion}/${RootModule}.psd1" -Force
}


task AnalyzeModule {
    assert (Test-Path -Path "./${RootModule}/${ModuleVersion}")

    Invoke-ScriptAnalyzer -Path "./${RootModule}/${ModuleVersion}"
}


task UpdateHelp CleanModule, LoadModule, {
    New-MarkdownHelp -Module $RootModule -OutputFolder './docs' -AlphabeticParamsOrder -ExcludeDontShow -Encoding ([System.Text.Encoding]::UTF8) -ErrorAction SilentlyContinue
    Update-MarkdownHelp -Path './docs' -AlphabeticParamsOrder -ExcludeDontShow -Encoding ([System.Text.Encoding]::UTF8) -Force
}


task TestModule {
    assert (Test-Path -Path './tests/*.tests.ps1')

    [object] $Configuration = New-PesterConfiguration -Hashtable @{
        Run        = @{
            Path     = Get-ChildItem -Path './tests/*.tests.ps1' -Force
            PassThru = $true
        }
        TestResult = @{
            Enabled      = $true
            OutputFormat = 'JUnitXml'
        }
        Output     = @{
            StackTraceVerbosity = 'None'
        }
    }

    $null = Invoke-Pester -Configuration $Configuration

    # https://gitlab.com/gitlab-org/gitlab/-/issues/25098

    [System.IO.FileInfo] $Results = Get-Item -Path $Configuration.TestResult.OutputPath.Value
    [xml] $xml = [xml]::new()

    $xml.Load($Results.FullName)
    $xml.SelectNodes('//failure').ForEach{ $_.'#text' = $_.message }
    $xml.Save($Results.FullName)

    assert (Test-Path -Path './testResults.xml')
}


task PublishModule {
    assert (Test-Path -Path "./${RootModule}/${ModuleVersion}")

    Publish-PSResource -Path "./${RootModule}/${ModuleVersion}" -Repository 'PSGallery' -ApiKey $ApiKey
}


task Clean @(
    'CleanModule'
    'CleanFiles'
)

task Build @(
    'LoadChangeLog'
    'LoadModuleManifest'
    'BuildLibrary'
    'BuildModule'
    'BuildHelp'
    'BuildModuleManifest'
    'CleanLibrary'
)

task Test @(
    'LoadModule'
    'TestModule'
)

task Publish @(
    'Clean'
    'Build'
    'PublishModule'
)

task . {}