Add ConvertTo-DotNetVersionClass #717

Evergreen/Evergreen.psd1

@@ -69,10 +69,10 @@ PowerShellVersion = '3.0'
 # NestedModules = @()
 
 # Functions to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no functions to export.
-FunctionsToExport = @('Export-EvergreenApp', 'Export-EvergreenManifest', 
-               'Find-EvergreenApp', 'Get-EvergreenApp', 'Get-EvergreenAppFromApi', 
-               'Get-EvergreenAppFromLibrary', 'Get-EvergreenEndpointFromApi', 
-               'Get-EvergreenLibrary', 'New-EvergreenLibrary', 'Save-EvergreenApp', 
+FunctionsToExport = @('Export-EvergreenApp', 'Export-EvergreenManifest',
+               'Find-EvergreenApp', 'Get-EvergreenApp', 'Get-EvergreenAppFromApi', 'ConvertTo-DotNetVersionClass',
+               'Get-EvergreenAppFromLibrary', 'Get-EvergreenEndpointFromApi',
+               'Get-EvergreenLibrary', 'New-EvergreenLibrary', 'Save-EvergreenApp',
                'Start-EvergreenLibraryUpdate', 'Test-EvergreenApp')
 
 # Cmdlets to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no cmdlets to export.
@@ -82,8 +82,8 @@ CmdletsToExport = @()
 # VariablesToExport = @()
 
 # Aliases to export from this module, for best performance, do not use wildcards and do not delete the entry, use an empty array if there are no aliases to export.
-AliasesToExport = 'sea', 'gea', 'fea', 'tea', 'iea', 'Invoke-EvergreenLibraryUpdate', 
-               'Get-EvergreenLibraryApp', 'Invoke-EvergreenApp', 
+AliasesToExport = 'sea', 'gea', 'fea', 'tea', 'iea', 'Invoke-EvergreenLibraryUpdate',
+               'Get-EvergreenLibraryApp', 'Invoke-EvergreenApp',
                'Get-EvergreenEndpoint'
 
 # DSC resources to export from this module

Evergreen/Private/Convert-Segment.ps1

@@ -0,0 +1,16 @@
+function Convert-Segment {
+    param (
+        [System.String] $Segment
+    )
+
+    if ($Segment -match '^\d+$') {
+        return [System.Int32]$Segment
+    }
+    else {
+        $Normalized = 0
+        foreach ($Char in $Segment.ToCharArray()) {
+            $Normalized = $Normalized * 100 + [System.Int32][System.Char]$Char
+        }
+        return $Normalized
+    }
+}

Evergreen/Public/ConvertTo-DotNetVersionClass.ps1

@@ -0,0 +1,67 @@
+function ConvertTo-DotNetVersionClass {
+    <#
+        .SYNOPSIS
+        Converts a version string to a standard .NET compliant Version class.
+
+        .DESCRIPTION
+        The ConvertTo-DotNetVersionClass function takes a version string as input and converts it into a .NET Version class. 
+        It normalizes the segments of the version string, ensuring it has exactly four segments by either summing excess segments 
+        or padding with zeros if there are fewer than four segments.
+
+        .PARAMETER Version
+        A version string to convert to a standard .NET compliant version class.
+
+        .EXAMPLE
+        PS> ConvertTo-DotNetVersionClass -Version "1.2.3.4"
+        1.2.3.4
+
+        .EXAMPLE
+        PS> ConvertTo-DotNetVersionClass -Version "1.2.3"
+        1.2.3.0
+
+        .EXAMPLE
+        PS> ConvertTo-DotNetVersionClass -Version "1.2.3.4.5"
+        1.2.3.9
+
+        .NOTES
+        If the conversion to a .NET Version class fails, the function will return the normalized version string as a string.
+    #>
+    param (
+        [Parameter(
+            Mandatory = $true,
+            Position = 0,
+            ValueFromPipeline,
+            HelpMessage = "A version string to convert to a standard .NET compliant version class.")]
+        [System.String] $Version
+    )
+
+    process {
+        # Split the version string into segments and initialise an array
+        $Segments = $Version -split '[.\-_+]'
+        $NormalizedSegments = @()
+
+        # Normalize each segment
+        foreach ($Segment in $Segments) {
+            $NormalizedSegments += @(Convert-Segment -Segment $Segment)
+        }
+
+        # If the number of segments is greater than 4, sum the last segments
+        if ($NormalizedSegments.Count -gt 4) {
+            $NormalizedSegments = $NormalizedSegments[0..2] + ($NormalizedSegments[3..($NormalizedSegments.Count - 1)] | Measure-Object -Sum).Sum
+        }
+
+        # If the number of segments is less than 4, pad with zeros
+        while ($NormalizedSegments.Count -lt 4) {
+            $NormalizedSegments += 0
+        }
+
+        # Return the version as a .NET Version class
+        try {
+            return [System.Version]($NormalizedSegments -join ".")
+        }
+        catch {
+            Write-Warning -Message "Failed to convert version string '$Version' to a .NET Version class."
+            return ($NormalizedSegments -join ".")
+        }
+    }
+}