Merge pull request #373 from itowlson/debugger-test

Debugger test app

Author: karthik2804

test/debugger-testing/README.md

@@ -0,0 +1,11 @@
+## Debugger test apps
+
+Apps in this directory can be used for testing the StarlingMonkey debugger against the Spin runtime.
+They are not intended for testing the SDK itself, or as example applications.
+
+- Load the extension (https://github.com/bytecodealliance/StarlingMonkey/tree/main/debugger/vscode-dap-extension) into VS Code and run `npm run esbuild-all`.
+- Update the `launch.json` (https://github.com/bytecodealliance/StarlingMonkey/blob/main/debugger/vscode-dap-extension/.vscode/launch.json) to point to the test Spin app you want to exercise.
+- Hit F5. This loads the Spin app the extension development host with the debugger extension loaded.
+- Set any desired breakpoints or whatever on the Spin app - whatever debugger functionality you want to test.
+- Run `spin build` and hit F5.
+- Make a request to the Spin app (e.g. `curl localhost:3000`) and verify the debugger does whatever you need it to do!

test/debugger-testing/spin-ts/.gitignore

@@ -0,0 +1,5 @@
+node_modules
+dist
+target
+.spin/
+build/

test/debugger-testing/spin-ts/.vscode/launch.json

@@ -0,0 +1,17 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "starlingmonkey",
+      "request": "launch",
+      "name": "Debug StarlingMonkey component",
+      "component": "${workspaceFolder}/out/spin-ts.wasm",
+      "program": "${workspaceFolder}/src/index.ts",
+      "stopOnEntry": false,
+      "trace": true
+    }
+  ]
+}

test/debugger-testing/spin-ts/.vscode/settings.json

@@ -0,0 +1,13 @@
+{
+    "starlingmonkey": {
+        "componentRuntime": {
+            "executable": "spin",
+            "options": [
+                "up",
+                "-f",
+                "${workspaceFolder}",
+                "${debuggerEnvs}"
+            ],
+        }
+    }
+}

test/debugger-testing/spin-ts/README.md

@@ -0,0 +1,32 @@
+# `http-ts` Template
+
+A starter template for building TypeScript HTTP applications with Spin.
+
+## Getting Started
+
+Build the App
+
+```bash
+spin build
+```
+
+## Run the App 
+
+```bash
+spin up
+```
+
+## Using Spin Interfaces
+
+To use additional Spin interfaces, install the corresponding packages:
+
+| Interface     | Package                         |
+|---------------|---------------------------------|
+| Key-Value     | `@spinframework/spin-kv`        |
+| LLM           | `@spinframework/spin-llm`       |
+| MQTT          | `@spinframework/spin-mqtt`      |
+| MySQL         | `@spinframework/spin-mysql`     |
+| PostgreSQL    | `@spinframework/spin-postgres`  |
+| Redis         | `@spinframework/spin-redis`     |
+| SQLite        | `@spinframework/spin-sqlite`    |
+| Variables     | `@spinframework/spin-variables` |