Merge pull request #670 from KxSystems/v1.14.0-dev-to-main

V1.14.0 dev to main

Author: Philip-Carneiro-KX

.vscode/launch.json

@@ -9,8 +9,16 @@
       "name": "Run Extension",
       "type": "extensionHost",
       "request": "launch",
+      "args": ["--extensionDevelopmentPath=${workspaceFolder}"],
+      "outFiles": ["${workspaceFolder}/out/extension.js*"],
+      "preLaunchTask": "npm: watch"
+    },
+    {
+      "name": "Run Extension Plain",
+      "type": "extensionHost",
+      "request": "launch",
       "args": [
-        "--disable-extensions",
+        "--profile-temp",
         "--extensionDevelopmentPath=${workspaceFolder}"
       ],
       "outFiles": ["${workspaceFolder}/out/extension.js*"],
@@ -29,11 +37,24 @@
       "type": "extensionHost",
       "request": "launch",
       "args": [
-        "--profile=Extension Tests",
+        "--profile-temp",
+        "--extensionDevelopmentPath=${workspaceFolder}",
+        "--extensionTestsPath=${workspaceFolder}/out-test/test/suite/index"
+      ],
+      "outFiles": ["${workspaceFolder}/out-test/**/*.js"],
+      "preLaunchTask": "npm: pretest"
+    },
+    {
+      "name": "Test Selected File",
+      "type": "extensionHost",
+      "request": "launch",
+      "args": [
+        "--profile-temp",
         "--extensionDevelopmentPath=${workspaceFolder}",
-        "--extensionTestsPath=${workspaceFolder}/out/test/suite/index"
+        "--extensionTestsPath=${workspaceFolder}/out-test/test/suite/index"
       ],
-      "outFiles": ["${workspaceFolder}/out/**/*.js"],
+      "env": { "TEST_FILE": "${fileBasenameNoExtension}" },
+      "outFiles": ["${workspaceFolder}/out-test/**/*.js"],
       "preLaunchTask": "npm: pretest"
     },
     {
@@ -54,8 +75,7 @@
       ],
       "runtimeExecutable": "npm",
       "skipFiles": ["<node_internals>/**"],
-      "type": "node",
-      "presentation": { "hidden": true }
+      "type": "node"
     }
   ],
   "compounds": [

.vscode/settings.json

@@ -7,5 +7,6 @@
   },
   "[xml]": {
     "editor.defaultFormatter": "redhat.vscode-xml"
-  }
+  },
+  "terminal.integrated.scrollback": 4000
 }

CHANGELOG.md

@@ -2,6 +2,37 @@
 
 All notable changes to the **kdb VS Code extension** are documented in this file.
 
+# v1.14.0
+
+### Enhancements
+
+- Added a new setting to hide detailed console query output that, when disabled, shows the query that generated the output, the connection the query was run on, and the time when it was run
+- The `QHOME` environment variable and the `kdb.qHomeDirectory` setting are now treated as identical when locating the q executable for REPL and bundled q connections.
+- Added REPL execution support for Python files
+- Added REPL execution support in KX Notebooks
+- Added `.venv` support to REPL
+- Added `.env` support to REPL
+- Added workspace picker for REPL for multi-root workspaces
+- Implemented stop execution support on Windows
+- Enhanced the language server with:
+  - Pattern matching syntax support
+  - Filter function support
+  - Folding comments
+  - Support for language server features on notebook q code cells
+
+### Fixes
+
+- Fixed issues with bundled q connections failing on remote setups
+- Fixed error messages during clean install
+- Support editing connections without the need to re-enter authentication details when just changing port and host
+- QSQL endpoint queries now preserve new lines
+- Fixed issues where adding BundledQ or MyQ connections did not update connection list
+
+### Internal Improvements
+
+- Split large test files into smaller, category-specific files for better readability and maintainability
+- Test files can now be run one by one instead of all at once
+
 # v1.13.1
 
 ### Fixes

README.md

@@ -96,6 +96,8 @@ If you want to use q outside of VS Code, set a [`QHOME` environment variable](ht
 
 If q is installed at `C:\q`, then `QHOME` is `C:\q`.
 
+**Note!** The kdb VS Code Extension treats the `QHOME` environment variable and the `kdb.qHomeDirectory` setting as identical when locating the q executable for REPL and bundled q connections. For more details, refer to the [QHomeDirectory](https://github.com/KxSystems/kx-vscode/wiki/qHomeDirectory) wiki page. 
+
 ### Versions available
 
 There are commercial and non-commercial editions available. We recommend you start with the kdb+ Personal Edition or kdb Insights Personal Edition. The following table lists the editions with links to downloads and the functionality they support.
@@ -863,6 +865,26 @@ The results are shown in the terminal and you can continue to work either in you
 
 Refer to the [REPL shortcuts table](https://github.com/KxSystems/kx-vscode/wiki/REPL) for information on the keyboard shortcuts you can use.
 
+### Benefits of using REPL
+
+A REPL gives you a tight feedback loop, stateful context, and guardrails. You learn faster, debug quicker, and ship with fewer mistakes.
+
+Key benefits include:
+
+- **Rapid iteration with stateful sessions**. Execute commands and receive immediate feedback while maintaining session state across operations. This enables faster development cycles with reduced boilerplate.
+
+- **Safe and efficient troubleshooting**. Experiment within transactions and roll back changes as needed. Quickly isolate and resolve issues by modifying and re-running queries in real time.
+
+- **In-context exploration and optimization**. Access schema details, autocomplete, and performance insights directly within the REPL, supporting informed tuning and discovery.
+
+- **Streamlined workflow and reusability**. Minimize context switching by staying within a single interface. Use command history as a living notebook to document, replay, or convert workflows into scripts.
+
+- **Smooth transition to production and built-in safeguards**. Validate logic in the REPL before promoting queries to production. Features like autocommit off, role switching, and environment prompts help prevent unintended changes.
+
+### Use PyKX within REPL
+
+Refer to the [PyKX within REPL](https://github.com/KxSystems/kx-vscode/wiki/Use-PyKX-Within-REPL) instructions for details on how to get started and use PyKX within REPL.
+
 ## Logs
 
 Any error or info is posted at **OUTPUT** in **kdb** tab

package-lock.json

@@ -3,7 +3,7 @@
   "displayName": "kdb",
   "description": "IDE support for kdb product suite including the q programming language",
   "publisher": "KX",
-  "version": "1.13.1",
+  "version": "1.14.0",
   "engines": {
     "vscode": "^1.96.0"
   },
@@ -143,51 +143,54 @@
         "kdb.servers": {
           "type": "object",
           "description": "kdb servers for explorer",
-          "scope": "application"
+          "scope": "machine"
         },
         "kdb.insights": {
           "deprecationMessage": "This setting is deprecated, use kdb.insightsEnterpriseConnections instead",
           "type": "object",
           "description": "kdb insights for explorer",
-          "scope": "application"
+          "scope": "machine"
         },
         "kdb.insightsEnterpriseConnections": {
           "type": "object",
           "description": "kdb insights enterprise connections for explorer",
-          "scope": "application"
+          "scope": "machine"
         },
         "kdb.hideInstallationNotification": {
           "type": "boolean",
           "description": "Hide notification for installation path, after first install",
-          "scope": "application"
+          "scope": "machine",
+          "deprecationMessage": "This setting is deprecated, use kdb.neverShowQInstallAgain instead"
         },
         "kdb.hideDetailedConsoleQueryOutput": {
           "type": "boolean",
           "description": "Hide detailed console query output",
           "default": true,
-          "scope": "application"
+          "scope": "machine"
         },
         "kdb.autoFocusOutputOnEntry": {
           "type": "boolean",
           "description": "Automatically focus the output console when running a query without an active results tab or receive log entry",
           "default": true,
-          "scope": "application"
+          "scope": "machine"
         },
         "kdb.qHomeDirectory": {
           "type": "string",
           "description": "QHOME directory for q runtime",
-          "scope": "application"
+          "default": "",
+          "scope": "machine-overridable"
         },
         "kdb.neverShowQInstallAgain": {
           "type": "boolean",
           "description": "Never show q install walkthrough again",
-          "scope": "application"
+          "default": false,
+          "scope": "machine"
         },
         "kdb.hideSubscribeRegistrationNotification": {
           "type": "boolean",
           "description": "Hide subscribe for registration notification",
           "default": false,
-          "scope": "application"
+          "scope": "machine"
         },
         "kdb.linting": {
           "type": "boolean",
@@ -221,19 +224,19 @@
           "type": "array",
           "description": "List of label names and colorset",
           "default": [],
-          "scope": "application"
+          "scope": "machine"
         },
         "kdb.labelsConnectionMap": {
           "type": "array",
           "description": "Labels connection map",
           "default": [],
-          "scope": "application"
+          "scope": "machine"
         },
         "kdb.hideSurvey": {
           "type": "boolean",
           "default": false,
           "description": "Hide the extension survey dialog box",
-          "scope": "application"
+          "scope": "machine"
         }
       }
     },
@@ -462,7 +465,7 @@
       },
       {
         "category": "KX",
-        "command": "kdb.start.repl",
+        "command": "kdb.repl.start",
         "title": "Start REPL"
       },
       {
@@ -513,7 +516,7 @@
       {
         "category": "KX",
         "command": "kdb.toggleParameterCache",
-        "title": "KX: Toggle parameter cache"
+        "title": "Toggle Parameter Cache"
       },
       {
         "category": "KX",
@@ -1137,8 +1140,10 @@
     "preui-test": "rimraf out-test .test-extensions",
     "preui-test-cmd": "tsc --outdir out-test -p ./test",
     "publish": "npx vsce publish",
-    "pretest": "rimraf out-test && tsc --outdir out-test -p ./test",
+    "pretest": "rimraf out out-test && tsc --outdir out-test -p ./test",
     "test": "node ./out-test/test/runTest.js",
+    "test:file": "cross-env TEST_FILE=$1 npm run test",
+    "test:folder": "cross-env TEST_FOLDER=$1 npm run test",
     "ui-test": "npm run ui-test-cmd -- ./out-test/test/ui/**/*.test.js",
     "ui-test-cmd": "extest setup-and-run --code_version $npm_package_config_ui_test_vscode_version --code_settings ./test/ui/fixtures/settings.json --extensions_dir ./.test-extensions --storage ./.test-folder -m ./test/ui/fixtures/mocha.json",
     "vscode:prepublish": "npm run -S esbuild-base -- --minify --keep-names",
@@ -1169,6 +1174,7 @@
     "@types/vscode-webview": "^1.57.5",
     "@typescript-eslint/eslint-plugin": "^8.34.1",
     "@typescript-eslint/parser": "^8.34.1",
+    "@vscode/python-extension": "^1.0.5",
     "@vscode/test-electron": "^2.5.2",
     "c8": "^10.1.3",
     "esbuild": "^0.25.5",
@@ -1192,6 +1198,7 @@
     "prettier": "^3.6.0",
     "rimraf": "^6.0.1",
     "sinon": "^21.0.0",
+    "tree-kill": "^1.2.2",
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.34.1",
     "vscode-extension-tester": "^8.16.2",

package.json

@@ -11,8 +11,8 @@
  * specific language governing permissions and limitations under the License.
  */
 
+import { DateTimeLiteral } from "../parser";
 import {
-  DateTimeLiteral,
   SyntaxError,
   Token,
   amended,
@@ -23,7 +23,7 @@ import {
   inParam,
   ordered,
   qualified,
-} from "../parser";
+} from "../parser/utils";
 
 export function deprecatedDatetime(tokens: Token[]): Token[] {
   return tokens.filter((token) => token.tokenType === DateTimeLiteral);

resources/teste.q

@@ -11,8 +11,8 @@
  * specific language governing permissions and limitations under the License.
  */
 
-import { Token } from "../parser";
 import { Rules } from "./rules";
+import { Token } from "../parser/utils";
 
 const enabled = [
   "DEPRECATED_DATETIME",