feat(pygls-playground): change pythonPath to pythonCommand

This allows the user to specify an arbitrary command to use when
launching the python interpreter. When combined with tools like `uv`,
this makes it trivial to switch between different versions of pygls!

For example

```json
{
  "pygls.server.pythonCommand": ["uv", "run", "--no-project", "--prerelease=allow", "--with", "pygls==2.0a2", "python"]
}
```

Author: alcarney

.vscode/extensions/pygls-playground/package.json

@@ -4,7 +4,7 @@
   "author": "Open Law Library",
   "repository": "https://github.com/openlawlibrary/pygls",
   "license": "Apache-2.0",
-  "version": "1.3.1",
+  "version": "2.0.0",
   "publisher": "openlawlibrary",
   "engines": {
     "node": ">=16.17.1",
@@ -79,11 +79,14 @@
             "description": "The python script to run when launching the server.",
             "markdownDescription": "The python script to run when launching the server.\n Relative to #pygls.server.cwd#"
           },
-          "pygls.server.pythonPath": {
+          "pygls.server.pythonCommand": {
             "scope": "resource",
-            "type": "string",
-            "default": "",
-            "description": "The python interpreter to use to run the server.\nBy default, this extension will attempt to use the Python interpreter configured via the Python extension, setting this setting will override this behavior."
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "default": null,
+            "description": "The command to use when launching the python interpreter used to run the server.\nBy default, this extension will attempt to use the Python interpreter configured via the Python extension, setting this setting will override this behavior."
           },
           "pygls.trace.server": {
             "scope": "resource",

.vscode/extensions/pygls-playground/src/extension.ts

@@ -26,7 +26,7 @@ import * as semver from "semver";
 import { PythonExtension } from "@vscode/python-extension";
 import { LanguageClient, LanguageClientOptions, ServerOptions, State, integer } from "vscode-languageclient/node";
 
-const MIN_PYTHON = semver.parse("3.7.9")
+const MIN_PYTHON = semver.parse("3.9.0")
 
 // Some other nice to haves.
 // TODO: Check selected env satisfies pygls' requirements - if not offer to run the select env command.
@@ -317,45 +317,44 @@ function getServerPath(): string {
  */
 async function getPythonCommand(resource?: vscode.Uri): Promise<string[] | undefined> {
     const config = vscode.workspace.getConfiguration("pygls.server", resource)
-    const pythonPath = await getPythonInterpreter(resource)
-    if (!pythonPath) {
+    const pythonCommand = await getPythonInterpreterCmd(resource)
+    if (!pythonCommand) {
         return
     }
-    const command = [pythonPath]
     const enableDebugger = config.get<boolean>('debug')
 
     if (!enableDebugger) {
-        return command
+        return pythonCommand
     }
 
     const debugHost = config.get<string>('debugHost')
     const debugPort = config.get<integer>('debugPort')
     try {
         const debugArgs = await python.debug.getRemoteLauncherCommand(debugHost, debugPort, true)
         // Debugpy recommends we disable frozen modules
-        command.push("-Xfrozen_modules=off", ...debugArgs)
+        pythonCommand.push("-Xfrozen_modules=off", ...debugArgs)
     } catch (err) {
         logger.error(`Unable to get debugger command: ${err}`)
         logger.error("Debugger will not be available.")
     }
 
-    return command
+    return pythonCommand
 }
 
 /**
- * Return the python interpreter to use when starting the server.
+ * Return the command to use to start the python interpreter
  *
- * This uses the official python extension to grab the user's currently
- * configured environment.
+ * If no command is configured, this uses the official python extension to
+ * grab the user's currently configured environment.
  *
- * @returns The python interpreter to use to launch the server
+ * @returns The command needed to invoke the python interpreter
  */
-async function getPythonInterpreter(resource?: vscode.Uri): Promise<string | undefined> {
+async function getPythonInterpreterCmd(resource?: vscode.Uri): Promise<string[] | undefined> {
     const config = vscode.workspace.getConfiguration("pygls.server", resource)
-    const pythonPath = config.get<string>('pythonPath')
-    if (pythonPath) {
-        logger.info(`Using user configured python environment: '${pythonPath}'`)
-        return pythonPath
+    const pythonCommand = config.get<string[]>('pythonCommand')
+    if (pythonCommand) {
+        logger.info(`Using user configured python command: '${pythonCommand}'`)
+        return pythonCommand
     }
 
     if (!python) {
@@ -400,7 +399,7 @@ async function getPythonInterpreter(resource?: vscode.Uri): Promise<string | und
         return
     }
 
-    return pythonUri.fsPath
+    return [pythonUri.fsPath]
 }
 
 async function getPythonExtension() {

.vscode/settings.json

@@ -3,24 +3,35 @@
         // Uncomment to enable `textDocument/onTypeFormatting` requests
         // "editor.formatOnType": true
     },
-    // Uncomment to override Python interpreter used.
-    // "pygls.server.pythonPath": "/path/to/python",
-    "pygls.server.debug": false,
+    // Uncomment to override Python environment used.
+    // "pygls.server.pythonCommand": ["uv", "run", "--no-project", "--prerelease=allow", "--with", "pygls==2.0a2", "python"],
+    //
+    // Uncomment to debug the server process in VSCode
+    // "pygls.server.debug": true,
+    //
+    // Uncomment to change where the debugger should be hosted
     // "pygls.server.debugHost": "localhost",
     // "pygls.server.debugPort": 5678,
+    //
+    // Controls which LSP server is launched
     "pygls.server.launchScript": "code_actions.py", // This is relative to `pygls.server.cwd`
     "pygls.server.cwd": "${workspaceFolder}/examples/servers",
-    "pygls.trace.server": "off",
+    //
+    // Uncomment to view all LSP messages between the client and server
+    // "pygls.trace.server": "verbose",
+    //
+    // Controls which documents VSCode will ask your LSP server about
     "pygls.client.documentSelector": [
         {
-            "scheme": "file",
             "language": "plaintext"
         }
     ],
+    // "pygls.jsonServer.exampleConfiguration": "some value here",
+    //
+    // Below are standard VSCode project settings.
     "python.testing.pytestArgs": [
         "."
     ],
     "python.testing.unittestEnabled": false,
     "python.testing.pytestEnabled": true,
-    // "pygls.jsonServer.exampleConfiguration": "some value here",
 }