[scripts/posh-vcpkg] Change TabExpansion to Register-ArgumentCompleter

[WangWeiLin-MV]

Fixes for microsoft/vcpkg#38184

The function TabExpansion is not supported by PowerShell 7.4.0, which breaks the posh-vcpkg.psm1 for vcpkg integrate powershell.

Use Register-ArgumentCompleter instead of TabExpansion to fix it.

Change

• vcpkg-init
  • Move posh-vcpkg module to non-version directory
• posh-vcpkg
  • Update posh-vcpkg.psd1 minimum version from 5.0 to 5.1
  • Replace intercepting TabExpansion with Register-ArgumentCompleter
• pipeline
  • Import module Pester for e2e tests
• e2e
  • Add end-to-end-tests-dir/autocomplete-posh-vcpkg.ps1
  • Add e2e-specs/autocomplete-posh-vcpkg.Tests.ps1

Test

Test passes locally on

• PowerShell 7.4.2 with Pester 5.6.1 on Linux
• PowerShell 7.4.3 with Pester 5.6.1 on macOS
• PowerShell 7.4.6 with Pester 5.6.1 on Windows
• Windows PowerShell 5.1 with Pester 5.6.1 on Windows
  • PowerShell ignore minus(-) string before Core PowerShell/issues/2912

[WangWeiLin-MV]

Waiting Test

• Azure pipeline for vcpkg

Waiting PR

• [pipeline/e2e] end-to-end-tests.ps1 should fail with failure test #1518

Test case passed

• autocomplete-posh-vcpkg.ps1
• autocomplete-posh-vcpkg.Tests.ps1

The symbol ^ represents the cursor.

• vcpkg ver^ got version
• vcpkg version^ got version
• vcpkg ^version got command list
• vcpkg ^ got command list
• ./vcpkg ^ got command list
• vcpkg.exe ^ got command list only on Windows
• .\vcpkg ^ got command list only on Windows
• vcpkg install vcpkg-cmake:^ got triplet list
• vcpkg install vcpkg-cmake -^ got command list
• echo powershell | % { vcpkg int^egr $_ }; echo $? got integrate
• vcpkg zzzzzzzz^ got empty completion
• vcpkg ---^ got empty completion
• vcpkg --triplet^ won't get error

[WangWeiLin-MV]

No comments fund about the version-directory.

If the original intention is to load the latest version:

• For users, the higher version overwrites the lower version
• For developers, the command Get-Module -ListAvailable -Refresh is required when refreshing the module cache.

So, removing it to avoid changing this script again.

[WangWeiLin-MV]

Requires test for Azure pipeline of vcpkg.

[WangWeiLin-MV]

Prevent vcpkg errors passing to user shell

vcpkg autocomplete install --triplet

error: the option 'triplet' requires a value

[WangWeiLin-MV]

e.g. & ^ vcpkg ver

Return no output to fall back to default file name completion.

[WangWeiLin-MV]

e.g. vcpkg install versions^ (No port named versions but directory .\versions\)

Unable to prevent fallback to default completion.

(Unless get an error, like return empty string.)

It will fallback default with:

• return
• return $null
• return @()
• return [System.Collections.Generic.List[System.Management.Automation.CompletionResult]]::new()

See PowerShell/PowerShell#19628

[BillyONeal]

Thanks for the improvement!