(#669) Add version completion for install and upgrade commands

Add chocoRemotePackageVersions function to fetch package versions from
remote source and integrate it into tab completion for install and upgrade
commands with --version option. This enables listing of available versions
for a specified package, improving user experience when specifying versions.

Add Pester tests to verify version completions appear correctly for various
--version input scenarios and cursor positions, ensuring reliable behavior.

Author: AdmiringWorm

src/chocolatey.resources/helpers/ChocolateyTabExpansion.ps1

@@ -160,6 +160,17 @@ function script:chocoRemotePackages($filter) {
         ForEach-Object { $_.Split('|')[0] }
 }
 
+function script:chocoRemotePackageVersions($Name, $Version) {
+        $packageVersions = & $script:choco search $Name --exact --all-versions --limit-output --include-headers --order-by='LastPublished' |
+            ConvertFrom-Csv -Delimiter '|'
+
+        if ($Version -and $packageVersions) {
+            $packageVersions | Where-Object Version -Like "$Version*" | Select-Object -ExpandProperty Version -First 30
+        } else {
+            $packageVersions | Select-Object -ExpandProperty Version -First 30
+        }
+}
+
 function Get-AliasPattern($exe) {
     $aliases = @($exe) + @(Get-Alias | Where-Object { $_.Definition -eq $exe } | Select-Object -Exp Name)
 
@@ -205,6 +216,11 @@ function ChocolateyTabExpansion($lastBlock) {
             @('disable', 'enable', 'get', 'list', '--help') | Where-Object { $_ -like "$($matches['subcommand'])*" }
         }
 
+        # Handles install/upgrade package versions for a specific package
+        "^(install|upgrade)\s+(?<package>[^\.\-][^\s]+).*--version='?(?<version>[^\s']*)'?$" {
+            chocoRemotePackageVersions -Name $matches['package'] -Version $matches['version'] | ForEach-Object { "--version='$_'" }
+        }
+
         # Handles install package names
         "^(install)\s+(?<package>[^\.][^-\s]+)$" {
             chocoRemotePackages $matches['package']

tests/pester-tests/chocolateyProfile.Tests.ps1

@@ -432,5 +432,70 @@ Describe "Chocolatey Profile" -Tag Chocolatey, Profile, Environment {
             $Completions | Should -Contain "--user=''" -Because $becauseCompletions
             $Completions | Should -Contain "--version=''" -Because $becauseCompletions
         }
+
+        It "Should list versions for <_> isdependency --version=" -ForEach @('install', 'upgrade') {
+            $Command = "choco $_ isdependency --version="
+            $Completions = (TabExpansion2 -inputScript $Command -cursorColumn $Command.Length).CompletionMatches.CompletionText
+
+            $becauseCompletions = ($Completions -Join ", ")
+
+            $Completions | Should -Contain "--version='2.1.0'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='2.0.0'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='1.1.0'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='1.0.1'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='1.0.0'" -Because $becauseCompletions
+        }
+
+        It "Should list versions for <_> isdependency --version='" -ForEach @('install', 'upgrade') {
+            $Command = "choco $_ isdependency --version='"
+            $Completions = (TabExpansion2 -inputScript $Command -cursorColumn $Command.Length).CompletionMatches.CompletionText
+
+            $becauseCompletions = ($Completions -Join ", ")
+
+            $Completions | Should -Contain "--version='2.1.0'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='2.0.0'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='1.1.0'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='1.0.1'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='1.0.0'" -Because $becauseCompletions
+        }
+
+        It "Should list versions for <_> isdependency --version=''" -ForEach @('install', 'upgrade') {
+            $Command = "choco $_ isdependency --version=''"
+            $Completions = (TabExpansion2 -inputScript $Command -cursorColumn ($Command.Length - 1)).CompletionMatches.CompletionText
+
+            $becauseCompletions = ($Completions -Join ", ")
+
+            $Completions | Should -Contain "--version='2.1.0'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='2.0.0'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='1.1.0'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='1.0.1'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='1.0.0'" -Because $becauseCompletions
+        }
+
+        It "Should list versions for <_> isdependency --version='' without moving cursor" -ForEach @('install', 'upgrade') {
+            $Command = "choco $_ isdependency --version=''"
+            $Completions = (TabExpansion2 -inputScript $Command -cursorColumn ($Command.Length)).CompletionMatches.CompletionText
+
+            $becauseCompletions = ($Completions -Join ", ")
+
+            $Completions | Should -Contain "--version='2.1.0'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='2.0.0'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='1.1.0'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='1.0.1'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='1.0.0'" -Because $becauseCompletions
+        }
+
+        It "Should list 2.x versions for <_> isdependency --version='2" -ForEach @('install', 'upgrade') {
+            $Command = "choco $_ isdependency --version='2"
+            $Completions = (TabExpansion2 -inputScript $Command -cursorColumn ($Command.Length)).CompletionMatches.CompletionText
+
+            $becauseCompletions = ($Completions -Join ", ")
+
+            $Completions | Should -Contain "--version='2.1.0'" -Because $becauseCompletions
+            $Completions | Should -Contain "--version='2.0.0'" -Because $becauseCompletions
+            $Completions | Should -Not -Contain "--version='1.1.0'" -Because $becauseCompletions
+            $Completions | Should -Not -Contain "--version='1.0.1'" -Because $becauseCompletions
+            $Completions | Should -Not -Contain "--version='1.0.0'" -Because $becauseCompletions
+        }
     }
 }