Skip to content

Latest commit

 

History

History
30 lines (21 loc) · 1.11 KB

README.md

File metadata and controls

30 lines (21 loc) · 1.11 KB
Raw

ForSM

A standalone Forth interpreter/compiler for WebAssembly. Bootstrapped from a Rust program, but the ultimate goal for it is to be self-hosting.

Architecture

./src/rust-bootstrapper is a Rust program which compiles a (very minimal) Forth interpreter.

This minimal interpreter is just powerful enough to import every file in ./src/prelude, which define the rest of its functionality.

Features include:

  • WASI-compliant, no extra imports needed.
  • Many standard Forth words. Most, even!
  • An interactive interpreter, supports stdin or included files.
  • Runtime colon definitions (including custom runtime behavior with does>).
  • Heap allocation with allocate, resize, and free.

Running it

# Compile the minimal interpreter
cargo run

# Run it with any WASI implementation; e.g. with wasmmer
wasmer --dir=. ./bin/forsm.wasm

# Pass filenames and it'll run them
wasmer --dir=. ./bin/forsm.wasm src/scripts/test_allocation.fth

# The first preopened directory must be this directory; the interpreter needs to load its own source code from ./src/prelude.