Send Pester describe line and info whether Pester 4.6.0 is installed to PowerShell.RunPesterTests command

src/PowerShellEditorServices.Host/CodeLens/PesterCodeLensProvider.cs

@@ -8,6 +8,7 @@
 using System;
 using System.Collections.Generic;
 using System.Linq;
+using System.Management.Automation;
 using System.Threading;
 using System.Threading.Tasks;
 
@@ -25,6 +26,12 @@ internal class PesterCodeLensProvider : FeatureProviderBase, ICodeLensProvider
         /// </summary>
         private IDocumentSymbolProvider _symbolProvider;
 
+        /// <summary>
+        /// Pester 4.6.0 introduced a new ScriptblockFilter parameter to be able to run a test based on a line,
+        /// therefore knowing this information is important.
+        /// </summary>
+        private Lazy<bool> _pesterV4_6_0_OrHigherAvailable;
+
         /// <summary>
         /// Create a new Pester CodeLens provider for a given editor session.
         /// </summary>
@@ -33,6 +40,7 @@ public PesterCodeLensProvider(EditorSession editorSession)
         {
             _editorSession = editorSession;
             _symbolProvider = new PesterDocumentSymbolProvider();
+            _pesterV4_6_0_OrHigherAvailable = new Lazy<bool>(() => DeterminePesterVersion());
         }
 
         /// <summary>
@@ -45,6 +53,9 @@ private CodeLens[] GetPesterLens(
             PesterSymbolReference pesterSymbol,
             ScriptFile scriptFile)
         {
+            // A value of null is a signal to PSES that the available Pester version does not support
+            // running Describe blocks by name (the test name will used instead then).
+            int? describeBlockLineNumber = _pesterV4_6_0_OrHigherAvailable.Value ? (int?)pesterSymbol.ScriptRegion.StartLineNumber : null;
             var codeLensResults = new CodeLens[]
             {
                 new CodeLens(
@@ -54,7 +65,7 @@ private CodeLens[] GetPesterLens(
                     new ClientCommand(
                         "PowerShell.RunPesterTests",
                         "Run tests",
-                        new object[] { scriptFile.ClientFilePath, false /* No debug */, pesterSymbol.TestName })),
+                        new object[] { scriptFile.ClientFilePath, false /* No debug */, pesterSymbol.TestName, describeBlockLineNumber })),
 
                 new CodeLens(
                     this,
@@ -63,12 +74,43 @@ private CodeLens[] GetPesterLens(
                     new ClientCommand(
                         "PowerShell.RunPesterTests",
                         "Debug tests",
-                        new object[] { scriptFile.ClientFilePath, true /* Run in debugger */, pesterSymbol.TestName })),
+                        new object[] { scriptFile.ClientFilePath, true /* Run in debugger */, pesterSymbol.TestName, describeBlockLineNumber })),
             };
 
             return codeLensResults;
         }
 
+        /// <summary>
+        /// Used to determine the value of <see cref="_pesterV4_6_0_OrHigherAvailable"/> as a background task.
+        /// </summary>
+        private bool DeterminePesterVersion()
+        {
+            var powerShell = new PSCommand();
+            powerShell.AddCommand("Get-Module")
+                      .AddParameter("ListAvailable")
+                      .AddParameter("Name", "Pester");
+
+            IEnumerable<PSObject> result = Task.Run(() =>
+            {
+                return _editorSession.PowerShellContext.ExecuteCommandAsync<PSObject>(powerShell);
+            }).Result;
+
+            if (result != null && result.Any())
+            {
+                foreach (PSObject module in result)
+                {
+                    if (module.BaseObject is PSModuleInfo psModuleInfo)
+                    {
+                        if (psModuleInfo.Version >= new Version(4, 6))
+                        {
+                            return true;
+                        }
+                    }
+                }
+            }
+            return false;
+        }
+
         /// <summary>
         /// Get all Pester CodeLenses for a given script file.
         /// </summary>