syrup: warduino debug crate, DAP server, and debug console

[tolauwae]

Crate: wdebug

A Rust crate to interact directly with the WARDuino debugger. Code is based on the debug.proto file. This crate is used to implement the DAP crate.

WARDuino DAP crate

A Rust DAP library, and DAP server implementation. Run with just:

just dap-server 127.0.0.1:4711

WARDuino debug console

A tiny console mostly for internal use to test and debug the debugger API since sending messages over telnet is not practically feasible anymore.

Currently it uses the DAP crate. So messages are sent through that intermediate layer. The console logs all DAP and VM messages.

VS Code debugging

VS Code debugging plugin fully based on the WARDuino DAP server. The whole plugin is one package.json.

To run it start a WARDuino instance, and a DAP server that connects to it.

wdcli fac.wasm --paused --socket 8192 &
cd tools/syrup; just dap-server 127.0.0.1:4711

Then in VS Code you can connect to the DAP server and debug your application.

[MaartenS11]

I feel like syrup and the surrounding infrastructure should probably be in its own repository.

[tolauwae]

I am actually not sure. I know we usually do, but increasingly I feel like one monolith repo for WARDuino makes a lot of sense. Because the whole project is incredibly split now.