{"id":19880,"date":"2023-03-13T07:47:28","date_gmt":"2023-03-13T15:47:28","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/powershell\/?p=19880"},"modified":"2023-03-13T07:50:05","modified_gmt":"2023-03-13T15:50:05","slug":"psreadline-2-3-0-beta0-release","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/powershell\/psreadline-2-3-0-beta0-release\/","title":{"rendered":"PSReadLine 2.3.0-beta0 Release"},"content":{"rendered":"

We’re pleased to announce the new preview release of PSReadLine 2.3.0-beta0<\/strong>. This release\ncontains several bug fixes and improvements to the ListView<\/code> Predictive IntelliSense.<\/p>\n

Installing PSReadLine 2.3.0-beta0<\/h2>\n

The release is available from the PowerShell Gallery<\/a>.<\/p>\n

Use the following command to install PSReadLine<\/strong> using PowerShellGet<\/strong> v2.x:<\/p>\n

Install-Module -Name PSReadLine -AllowPrerelease -Force<\/code><\/pre>\n
If you are using PowerShellGet<\/strong> v3, you can use the following command:<\/p>\n
Install-PSResource -Name PSReadLine -AllowPrerelease -Force<\/code><\/pre>\n
You must include the Force<\/strong> parameter to install this version side by side with the default\nstable version.<\/p>\n
<\/i>Note<\/strong><\/p>You must restart your PowerShell session to use the new version of\nPSReadLine<\/strong>.<\/div><\/p>\n
Scrollable List View<\/h2>\n
A big feature of this prerelease is the scrollable list view. Previously, the ListView<\/code> mode is\nlimited to show up to just 10 results. With this release, PSReadLine<\/strong> can show up to 50<\/strong>\nresults. The view shows the first 10 results, but now you can use the UpArrow<\/kbd> and\nDownArrow<\/kbd> keys to scroll the list beyond the first 10 results.<\/p>\n
\"Screenshot<\/p>\n
When you have multiple providers loaded the ordering of predictors is still based on the order that\nyou imported the PowerShell modules. The previous screenshot shows that the\nAz.Tools.Predictor<\/code><\/a> module was imported before the CompletionPredictor<\/code><\/a>.<\/p>\n
If the providers return more than 50 results combined, the prediction results are distributed as\nevenly as possible based on the amount each provider returned.<\/p>\n
New key bindings<\/h3>\n
Scrolling one line at a time can be slow for large lists. For a faster scrolling, we added new key\nbindings to help navigate the ListView<\/code>.<\/p>\n\n\n\n\n\n\n\n\n
Key Binding<\/th>\nDescription<\/th>\nFunction<\/th>\n<\/tr>\n<\/thead>\n
PageUp<\/code><\/td>\nMove up a page<\/td>\nScrollDisplayUp<\/code><\/td>\n<\/tr>\n
PageDown<\/code><\/td>\nMove down a page<\/td>\nScrollDisplayDown<\/code><\/td>\n<\/tr>\n
Ctrl+PageUp<\/code><\/td>\nMove up to next predictor’s first result<\/td>\nScrollDisplayUpLine<\/code><\/td>\n<\/tr>\n
Ctrl+PageDown<\/code><\/td>\nMove down to the next predictor’s first result<\/td>\nScrollDisplayDownLine<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
These key bindings only apply in ListView<\/code>. If ListView<\/code> isn’t enabled, these key bindings do what\nthey normally do. As with any key binding, you can reconfigure the binding for these functions using\nSet-PSReadLineKeyHandler<\/code>.<\/p>\n
<\/i>Note<\/strong><\/p>These functions are bound by default in Windows and Emacs\nEditModes<\/code> but not in VI Mode.<\/div><\/p>\n
Autoadjusting size<\/h3>\n
Since we now have the ability to scroll through different results, we can adjust the height of the\nListView<\/code> results with the shell’s window height. The maximum size is 10 lines, but it shrinks to 5\nlines if the Console.BufferHeight<\/code> is less than or equal 20 and to 3 lines when the height is less\nthan or equal to 10. If the terminal width or height is too small, ListView<\/code> displays a warning\nmessage that the size is too small.<\/p>\n
\"Animated<\/a><\/p>\n
This is particularly helpful when using Azure Cloud Shell, because the default terminal height is\ntoo small to show 10 results.<\/p>\n
Metadata line<\/h3>\n
We’ve also included a new metadata line<\/em> that show the line number of your selection the number of\nresults available from each prediction source. The metadata line changes as you are scroll through\nthe list.<\/p>\n
\"Screenshot<\/a><\/p>\n
Additional features<\/h2>\n
Deduplication of prediction results<\/h3>\n
As more and more predictors are created, we’ve noticed a few cases where the same prediction can\ncome from multiple sources. To reduce the repetition of predictions, we’ve made a fix to remove\nresults returned by the history predictor. This means that if history has a prediction that another\npredictor has, the result is only displayed from the history. This allows for more and different\nresults to be displayed and reduces confusion between two predictions with the same exact syntax.<\/p>\n
Change default color for inline prediction<\/h3>\n
We made a minor change to the inline prediction color to make it more easily readable on terminals\nthat don’t use a pure black background, such as the VS Code terminal. The previous setting of\ndark black<\/code> has been changed to dim white italic<\/code>.<\/p>\n
\"Screenshot<\/a><\/p>\n
Bug fixes and new features<\/h2>\n
This release includes the bug fixes and community contributions detailed below. We really appreciate\nand value community contributions!<\/p>\n