whamm-live

Live programming with the Whamm DSL!

Whamm Live is a VSCode extension that provides live, bidirectional visibility between Whamm scripts and their instrumentation effects for the Wizard engine target as well as other selected Wasm targets.

Install

Note

This extension is not yet available on the VS Code Marketplace. You will need to manually install the .vsix file.

1. To get started, first download the .vsix file from the releases page.

2. Open your terminal

code --install-extension path/to/live-whamm-x.y.z.vsix

Related Resource(s): Install from a vsix

Guide

GUIDE.md

Development Setup

Want to contribute or test locally? Here's how to set it up:

1. Clone the repo:

git clone https://github.com/ejrgilbert/whamm-live.git
cd whamm-live

2. Configure wit2s

   1. Clone vscode-wasm
   2. Build

   cd vscode-wasm
   npm install
   cd wasm-component-model
   npm run clean
   npm run compile
   chmod +x ./bin/wit2s
   # Test running the binary
   ./bin/wit2ts
   
   # Add `wit2s` to `PATH`
   export PATH="$PWD/bin:$PATH"

3. Setup svelte

    cd whamm-live/svelte
    npm install
    npm run build

For specific svelte stuff, look at svelte/README.md.

4. Setup Whamm
   1. Clone Whamm.
   2. Add Whamm to Live-Whamm's Cargo.toml file

whamm={path="path/to/whamm/repo"}

5. Finally, to start the extension:

npm install
cargo build

Run extension using F5 key

Improvements

• Execute Wasm code in a worker (make it async): tutorial
• Reduce duplicated effort for re-creating an Orca module on every run invocationß