Verse Debugger for Visual Studio Code

A VSCode extension that provides debugging support for the Verse programming language, allowing you to attach to running Verse processes for debugging.

Features

Attach to running Verse debugging servers
Support for breakpoints
Step through Verse code
Inspect variables and call stack
Debug console integration

Requirements

To use this extension, you will need:

A Verse development environment
A running Verse debug server that implements the Debug Adapter Protocol
The port number that the debug server is listening on

Getting Started

Install the Verse Debugger extension
Start your Verse project with debugging enabled
Open the Debug view in VSCode (Ctrl+Shift+D or Cmd+Shift+D on macOS)
Create a launch.json configuration (if not already present):

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Verse Attach",
            "type": "verse",
            "request": "attach",
            "debugServer": 1961
        }
    ]
}

Adjust the debugServer port to match your Verse debug server
Start debugging by clicking the green play button or pressing F5

Extension Settings

This extension contributes the following settings:

verse.debug.getAttachProcess: Command to select a Verse process to attach to

Debug Configuration

Attach Configuration

debugServer: The port number of the Verse debug server to connect to (required)

Troubleshooting

Common Issues

Connection refused: Ensure that your Verse debug server is running and the port is correctly specified in your launch configuration
Port not specified: Make sure your launch.json configuration includes the debugServer port number
Debug adapter not found: Verify that the extension is properly installed and activated

Development

Building the Extension

Clone the repository
Run npm install to install dependencies
Run npm run compile to compile TypeScript
Press F5 to launch the extension in debug mode

Packaging the Extension

Run vsce package to create a VSIX file that can be installed in VSCode.

Release Notes

0.0.1

Initial release of the Verse Debugger extension
Basic attach functionality to connect to Verse debug servers
Support for breakpoints, stepping, and variable inspection

License

Enjoy debugging your Verse code!

doomerhunter/verse-debugger