Skip to content

Latest commit

 

History

History
57 lines (53 loc) · 2.18 KB

DEVELOPING.md

File metadata and controls

57 lines (53 loc) · 2.18 KB
Raw

Developing

Local Development

This project will live and die by cargo.

cargo build
cargo test
cargo run examples/test.py

REPL

The REPL is useful for interactive mode.

cargo run --features repl

Feature Flags

Feature flags are needed to enable C stdlib or REPL support (or the experimental LLVM backend).

# if examples/test.py depends on stdlib features
cargo run --features stdlib examples/api.py
# if examples/test.py depends on stdlib features implemented in C
cargo run --features c_stdlib examples/api.py
# it's common to use these together to get as much of the stdlib support as we currently offer
cargo run --features stdlib,c_stdlib examples/api.py

# script to run all combinations of feature flags
./test_features.sh

Benchmarking

To compare runtime, we can build in release mode and use the different engines.

cargo install --path . --all-features
hyperfine "memphis examples/loop_perf.py" "MEMPHIS_ENGINE=vm memphis examples/loop_perf.py" "MEMPHIS_ENGINE=llvm_backend memphis examples/loop_perf.py" --warmup 5

Flamegraph

This is a cool way to visualize why a bytecode VM is more performant than a treewalk interpreter.

cargo install flamegraph
cargo build --all-features
# we require debug symbols to produce a flamegraph, hence invoking the binary from `target/debug`.
sudo flamegraph -v -o tw.svg -- target/debug/memphis examples/loop_perf.py
sudo flamegraph -v -o vm.svg -- MEMPHIS_ENGINE=vm target/debug/memphis examples/loop_perf.py
sudo flamegraph -v -o llvm.svg -- MEMPHIS_ENGINE=llvm_backend target/debug/memphis examples/loop_perf.py

WebAssembly

# wasm-pack helps compile our Rust code to WebAssembly and bundle it with JavaScript bindings we
# can call from our HTML/JavaScript page.
cargo install wasm-pack

# wasm-pack also downloads the wasm32-unknown-unknown target via rustup for us.
# We must specify a feature flag because our wasm_bindgen interface is behind the wasm feature flag.
wasm-pack build --target web --out-dir wasm_ui/pkg -- --features wasm

# Then load wasm_ui/index.html in a browser. One way is to launch a Python server and then open
# http://localhost:8000/wasm_ui/.
python -m http.server