Publish-PowerShellModule.ps1
|
Function Publish-PowerShellModule { Param ( [Parameter()] [string]$Name = (Split-Path $Pwd -Leaf), [Parameter()] [string]$Ref = (&{ $Tag = git describe --tags --exact-match --match "v*.*.*" HEAD 2> $null If ($LastExitCode -eq 0) { Return $Tag } Else { Return (git rev-parse --abbrev-ref HEAD 2> $null) } }), [Parameter()] [string]$Main = "main", [Parameter()] [int]$Build = ([int][Math]::Ceiling([double]::Parse((Get-Date -UFormat %s), [CultureInfo]::CurrentCulture))), [Parameter()] [string]$ArtifactsPath = (Join-Path $Pwd "artifacts"), [Parameter()] [string]$NuGetApiKey, [Parameter()] [string]$NuGetUrl ) $errors = @() # Clean artifacts directory If (-not (Test-Path $ArtifactsPath)) { New-Item $ArtifactsPath -Type Directory > $null } Get-ChildItem $ArtifactsPath -Recurse | Remove-Item -Force # Satisfy required modules constraints $manifestPath = Join-Path $Pwd "$Name.psd1" try { $manifest = Import-PowerShellDataFile $manifestPath foreach ($module in $manifest.RequiredModules) { $parameters = @{ Force = $true } if ($module -is [string]) { $parameters.Name = $module $packageFileName = "$module.0.0.1.nupkg" } else { $parameters.Name = $module.ModuleName $packageFileName = $module.ModuleName if ($module.RequiredVersion) { $parameters.RequiredVersion = $module.RequiredVersion $packageFileName = "$packageFileName.$($module.RequiredVersion).nupkg" } elseif ($module.ModuleVersion) { $parameters.MinimumVersion = $module.ModuleVersion $packageFileName = "$packageFileName.$($module.ModuleVersion).nupkg" if ($module.MaximumVersion) { $parameters.MaximumVersion = $module.MaximumVersion -replace "\*","99999999" } } else { $packageFileName = "$packageFileName.0.0.1.nupkg" } } # Required modules must be imported in current sessionn for Test--ModuleManifest Install-Module -AcceptLicense -AllowPrerelease @parameters Import-Module -DisableNameChecking @parameters # Required modules must be present in the staging repository New-Item "$ArtifactsPath/$packageFileName" -Force -ItemType File } } catch { $errors += $_.Exception.Message $Error.Clear() } # Validate manifest Try { $manifest = Test-ModuleManifest $manifestPath } Catch { $errors += $_.Exception.Message $Error.Clear() } # Run tests $hasTests = (Get-ChildItem -Path . -Filter "*.Tests.ps1" -Recurse).Count -gt 0 If ($hasTests) { $testResult = Invoke-Pester -Configuration @{ CodeCoverage = @{ Enabled = $true OutputPath = Join-Path (&{If ($null -eq $TestArtifactsPath) {Return $ArtifactsPath} Else {Return $TestArtifactsPath}}) "coverage.xml" } Output = @{ Verbosity = "Normal" } Run = @{ Exit = $false PassThru = $true Path = $Pwd } TestResult = @{ Enabled = $true OutputPath = Join-Path $ArtifactsPath "tests.xml" TestSuiteName = $Name } } If ($LastExitCode) { $errors += "$($testResult.FailedCount) test(s) failed" $testResult.Tests | Where-Object Result -eq "Failed" | ForEach-Object ` { $e = "$($_.Result): $($_.ExpandedPath)" foreach ($errorRecord in $_.ErrorRecord) { $category = $errorRecord.CategoryInfo.Category if ($category -eq ([System.Management.Automation.ErrorCategory]::InvalidResult)) { $exceptionMessage = $errorRecord.Exception.Message $e = "${e}: $exceptionMessage" } else { # Category will be NotSpecified $e = "${e}: An unexpected error occurred during execution of this test" } break } $errors += $e } } } # Code analysis Get-ChildItem -Exclude "*.Tests.ps1" -Recurse | Where-Object { $_.Extension -in ".ps1",".psd1",".psm1" } | ForEach-Object ` { $diagnosticRecords = Invoke-ScriptAnalyzer ` -IncludeDefaultRules ` -Path $_.FullName ` -Severity "Information","Warning","Error" If ($diagnosticRecords) { $diagnosticRecords | ForEach-Object ` { $errors += $_.ScriptPath + ` ":$($_.Extent.StartLineNumber)" + ` ":$($_.Extent.StartColumnNumber)" + ` ": " + $_.RuleName + ` ": " + $_.Message } } } # Steps for a valid manifest if ($null -ne $manifest) { # Copy files $tempModulePath = Join-Path ` -Path (Join-Path ` -Path ([IO.Path]::GetTempPath()) ` -ChildPath ([IO.Path]::GetRandomFileName())) ` -ChildPath $Name New-Item -ItemType Directory -Path $tempModulePath | Out-Null ForEach ($path in $manifest.FileList) { $relativePath = Resolve-Path -Path $path -Relative $absolutePath = Join-Path -Path $tempModulePath -ChildPath $relativePath New-Item (Split-Path $absolutePath -Parent) -ItemType Directory -Force | Out-Null Copy-Item -Path $path -Destination $absolutePath } # Adjust manifest path $resolvedManifestPath = Resolve-Path -Path $manifestPath -Relative $manifestPath = Join-Path -Path $tempModulePath -ChildPath $resolvedManifestPath -Resolve # Versioning [Version] $version = $manifest.Version If ($version) { If ($Ref -match "^v\d+\.\d+\.\d+$") { If ("v$($version.Major).$($version.Minor).$($version.Build)" -ne $Ref) { $errors += "Version in manifest ($version) does not match tag ($Ref)" } } ElseIf ((git rev-list --count HEAD) -gt 1) { If ($Ref -eq $Main) { $revision = "HEAD^1" } Else { $revision = $Main git fetch origin "${Main}:$Main" --depth=1 --quiet $topic = $Ref -replace "[^a-zA-Z0-9]","" $prerelease = $topic + ("{0:000000}" -f $Build) Update-ModuleManifest -Path $manifestPath -Prerelease $prerelease } $path = [IO.Path]::GetTempFileName() + ".psd1" git show "${Revision}:$(Resolve-Path $manifestPath -Relative)" > "$path" 2> $Null If (-Not $LastExitCode) { [Version] $current = (Test-ModuleManifest $path).Version If (-not ($version -gt $current)) { $errors += "Version in manifest does not increment $current" } } } ElseIf($version -ne [Version] "0.0.1" -and $version -ne [Version] "0.1.0" -and $version -ne [Version] "1.0.0") { $errors += "Version in manifest should be 0.0.1, 0.1.0, or 1.0.0 on initial commit, or fetch depth must be at least 2." } } } # Exit with errors If ($errors) { $errors | ForEach-Object ` { If ($Env:GITHUB_ACTIONS -eq "true") { Write-Information "::error::$_" } ElseIf ($Env:TF_BUILD -eq "True") { Write-Information "##vso[task.logIssue type=error]$_" } Else { $Host.UI.WriteErrorLine($_) } } $errors.Clear() Exit 1 } # Build package $repositories = @(Get-PSRepository | Where-Object { $location = $_.SourceLocation if ([uri]::IsWellFormedUriString($location, [System.UriKind]::Absolute)) { return $false } return (Get-CanonicalPath $location) -eq (Get-CanonicalPath $ArtifactsPath) }) if ($repositories.Length -eq 0) { $unregisterRepository = $true Register-PSRepository -Name $Name ` -SourceLocation $ArtifactsPath ` -PublishLocation $ArtifactsPath ` -ErrorAction Stop $repositoryName = $Name } else { $repositoryName = $repositories[0].Name } Publish-Module ` -Path (Split-Path -Path $manifestPath -Parent) ` -Repository $repositoryName $ignore = $Error | Where-Object { $_.CategoryInfo.Activity -eq "Find-Package" } | Where-Object { $_.CategoryInfo.Category -eq [System.Management.Automation.ErrorCategory]::ObjectNotFound } $ignore | ForEach-Object { $Error.Remove($_) } if ($unregisterRepository) { Unregister-PSRepository $repositoryName } # Push package If ($NuGetUrl -and $NuGetApiKey) { Get-ChildItem $ArtifactsPath "*.nupkg" | ForEach-Object { Invoke-DotnetNugetPush $_.FullName -ApiKey $NuGetApiKey -SkipDuplicate -Source $NuGetUrl } } } |