d3psi / spacey

a tiny, wasm-ready virtual machine - stupidly fast

spacey

a tiny, performant, wasm-ready virtual machine in rust

supported and planned frontends:

• whitespace
• malbolge
• brainfuck
• whatever other language we want to create a frontend for

crates.io and npmjs.org

the library crate is available both as a standard crate spacey as well as a bundled wasm package on npm under node-spacey.

building and running

make sure you have rust and the rust package manager cargo installed on your system. if not, the easiest way to do so is to install rust via rustup.rs.

then, clone the repository and build natively as follows:

git clone https://github.com/D3PSI/spacey.git
cd spacey
cargo build --release

to build for wasm, simply install wasm-pack and execute:

wasm-pack build

to run the provided executable run:

cargo run --release -q -- -h

to show the help screen.

execute whitespace-files like:

cargo run --release -q -- -f ws/hello_world.ws -t whitespace

spacey's Issues

write tests with `wasm-bindgen-test` to test crate in browser contexts

Is your feature request related to a problem? Please describe.
title

Describe the solution you'd like
we need to implement some tests that run in the browser

Describe alternatives you've considered

Additional context

fix input instructions for wasm

    TODO: re-export error types, finish `wasm-bindgen` bindings, fix IO instructions and maybe update some docs

UPDATE: mostly done, only need to implement a callback to get input in wasm

Originally posted by @D3PSI in #10 (comment)

annotate constructors with the appropriate `wasm-bindgen` macros

create an intermediate representation of mnemonics for the vm

this serves to decouple the stack machine from the whitespace instruction mnemonics