Release v2.15

Author: lipkau

.github/workflows/release.yml

@@ -24,13 +24,13 @@ jobs:
           path: ./Release/
           if_no_artifact_found: fail
 
-      - run: ./tools/setup.ps1
+      - run: ./Tools/setup.ps1
         shell: pwsh
 
       - run: Invoke-Build -Task ShowDebugInfo -VersionToPublish ${{ github.ref_name }}
         shell: pwsh
 
-      - run: Invoke-Build -Task Publish -VersionToPublish ${{ github.ref_name }} -PSGalleryAPIKey ${{ secrets.PSGalleryAPIKey }}
+      - run: Invoke-Build -Task Publish -VersionToPublish ${{ github.ref_name }} -PSGalleryAPIKey ${{ secrets.PSGALLERY_API_KEY }}
         shell: pwsh
 
       - name: Cherry pick CHANGELOG.md

CHANGELOG.md

@@ -1,8 +1,6 @@
 # Change Log
 
-## [NEXT VERSION] - YYYY-MM-DD
-
-## [2.15-alpha1] - 2024-06-13
+## [2.15] - 2025-12-30
 
 ### Added
 
@@ -13,6 +11,7 @@
 ### Changed
 
 - Improved `-Transition` behavior in `Invoke-JiraIssueTransition` (#416, [@Rufus125])
+- Updated Pester to v5 (#543, [@SrBlackVoid])
 
 ### Fixed
 
@@ -71,7 +70,7 @@
 ### Added
 
 - Parameter for retrieving information about a specific user with `Get-JiraUser` (#328, [@michalporeba])
-    - this implementations will be changed with the next major update in favor of #306
+  - this implementations will be changed with the next major update in favor of #306
 
 ### Changed
 
@@ -407,6 +406,7 @@ which is in turn inspired by the [Vagrant](https://github.com/mitchellh/vagrant/
 [@Rufus125]: https://github.com/Rufus125
 [@sgtwilko]: https://github.com/sgtwilko
 [@spascoe]: https://github.com/spascoe
+[@SrBlackVoid]: https://github.com/SrBlackVoid
 [@thepsadmin]: https://github.com/ThePSAdmin
 [@tuxgoose]: https://github.com/tuxgoose
 [@vercellone]: https://github.com/vercellone

JiraPS.build.ps1

@@ -35,9 +35,8 @@ switch ($true) {
 #endregion HarmonizeVariables
 
 if ($VersionToPublish) {
-    $VersionToPublish = $VersionToPublish.TrimStart('v') -as [Version]
+    $VersionToPublish = $VersionToPublish.TrimStart('v')
 }
-$currentVersion = (Get-Metadata -Path $env:BHPSModuleManifest) -as [Version]
 $builtManifestPath = "$env:BHBuildOutput/$env:BHProjectName/$env:BHProjectName.psd1"
 
 Task ShowDebugInfo {
@@ -55,7 +54,6 @@ Task ShowDebugInfo {
     Write-Build Gray ('BHCommitHash:               {0}' -f $env:BHCommitHash)
     Write-Build Gray ('BHCommitMessage:            {0}' -f $env:BHCommitMessage)
     Write-Build Gray ('BHBuildNumber               {0}' -f $env:BHBuildNumber)
-    Write-Build Gray ('CurrentVersion              {0}' -f $currentVersion)
     Write-Build Gray ('VersionToPublish            {0}' -f $VersionToPublish)
     Write-Build Gray '-------------------------------------------------------'
     Write-Build Gray ('PowerShell version:         {0}' -f $PSVersionTable.PSVersion.ToString())
@@ -151,10 +149,24 @@ Task UpdateManifest {
 }
 
 Task SetVersion {
-    Assert-True { $VersionToPublish -as [Version] } "Invalid version format: $VersionToPublish"
-    Assert-True { $VersionToPublish -gt $currentVersion } "Version must be greater than the current version: $currentVersion"
+    [System.Management.Automation.SemanticVersion]$versionToPublish = $VersionToPublish
 
-    Metadata\Update-Metadata -Path $builtManifestPath -PropertyName "ModuleVersion" -Value $VersionToPublish.ToString()
+    $latestPublished = Get-LatestPublishedVersion -Name $env:BHProjectName
+
+    Write-Build Gray "Latest published version: $latestPublished"
+    Assert-True { $versionToPublish -gt $latestPublished } "Version must be greater than latest published version: $latestPublished"
+
+    $versionString = "{0}.{1}.{2}" -f $versionToPublish.Major, $versionToPublish.Minor, $versionToPublish.Patch
+    Metadata\Update-Metadata -Path $builtManifestPath -PropertyName "ModuleVersion" -Value $versionString
+
+    if ($versionToPublish.PreReleaseLabel) {
+        Write-Build Gray "Setting Prerelease label: $($versionToPublish.PreReleaseLabel)"
+        Metadata\Update-Metadata -Path $builtManifestPath -PropertyName "Prerelease" -Value $versionToPublish.PreReleaseLabel
+    }
+    else {
+        Write-Build Gray "Removing Prerelease label (stable release)"
+        Metadata\Update-Metadata -Path $builtManifestPath -PropertyName "Prerelease" -Value ''
+    }
 }
 
 Task Test {

JiraPS/JiraPS.psd1

@@ -113,7 +113,7 @@
             # External dependent modules of this module
             # ExternalModuleDependencies = ''
 
-            Prerelease = 'alpha1'
+            Prerelease = ''
 
         } # End of PSData hashtable
 

Tools/BuildTools.psm1

@@ -256,6 +256,50 @@ function Remove-Utf8Bom {
     }
 }
 
+function Get-LatestPublishedVersion {
+    <#
+    .SYNOPSIS
+        Gets the latest published version of a module from PowerShell Gallery.
+    .DESCRIPTION
+        Queries the PowerShell Gallery for all published versions of a module and returns the latest version as a SemanticVersion.
+        Handles both 4-part versions (e.g., "2.2.0.154") and semantic versions with pre-release labels (e.g., "2.15.0-alpha1").
+    .PARAMETER Name
+        The name of the module to query.
+    .EXAMPLE
+        Get-LatestPublishedVersion -Name JiraPS
+        Returns the latest published version of JiraPS as a SemanticVersion object.
+    #>
+    [CmdletBinding()]
+    [OutputType([System.Management.Automation.SemanticVersion])]
+    param(
+        [Parameter(Mandatory)]
+        [String]$Name
+    )
+
+    $publishedPackages = Find-NugetPackage -Name $Name -ErrorAction Stop
+    $latestPublished = $publishedPackages |
+        Select-Object -ExpandProperty Version |
+        ForEach-Object {
+            # Try SemanticVersion first (handles pre-release like "2.15.0-alpha1")
+            $semVer = $_ -as [System.Management.Automation.SemanticVersion]
+            if ($semVer) {
+                # Return the full semantic version string (preserves pre-release label)
+                $_.ToString()
+            }
+            else {
+                # Fall back to Version for 4-part versions (like "2.2.0.154")
+                # Convert to 3-part semantic version
+                $ver = [Version]$_
+                "{0}.{1}.{2}" -f $ver.Major, $ver.Minor, $ver.Build
+            }
+        } |
+        ForEach-Object { $_ -as [System.Management.Automation.SemanticVersion] } |
+        Sort-Object -Unique |
+        Select-Object -Last 1
+
+    $latestPublished
+}
+
 function Set-GitUser {
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute("PSUseShouldProcessForStateChangingFunctions", "")]
     param()