Skip to main content

Crate fusevm

Crate fusevm 

Source
Expand description

fusevm — Language-agnostic bytecode VM with fused superinstructions.

Any language frontend can compile to fusevm opcodes and get:

  • Fused superinstructions for hot loops (AccumSumLoop, etc.)
  • Extension opcode dispatch for language-specific ops
  • Stack-based execution with slot-indexed fast paths
  • Cranelift JIT compilation for eligible chunks

§Architecture

stryke source ──→ stryke compiler ──┐
awkrs source ──→ awkrs compiler     ├──→ fusevm::Op ──→ VM::run()
zshrs source  ──→ shell compiler  ──┘

§Usage

use fusevm::{Op, ChunkBuilder, VM, VMResult, Value};

let mut b = ChunkBuilder::new();
b.emit(Op::LoadInt(40), 1);
b.emit(Op::LoadInt(2), 1);
b.emit(Op::Add, 1);

let mut vm = VM::new(b.build());
match vm.run() {
    VMResult::Ok(val) => println!("result: {}", val.to_str()),
    VMResult::Error(e) => eprintln!("error: {}", e),
    VMResult::Halted => {}
}

Re-exports§

pub use chunk::Chunk;
pub use chunk::ChunkBuilder;
pub use jit::JitCompiler;
pub use jit::JitExtension;
pub use jit::NativeCode;
pub use op::Op;
pub use value::Value;
pub use vm::Frame;
pub use vm::VMResult;
pub use vm::VM;

Modules§

chunk
Bytecode container — a compiled unit of execution.
jit
fusevm JIT — Cranelift codegen for universal bytecodes.
op
Bytecode instruction set for fusevm.
shell_builtins
Shell builtin IDs for CallBuiltin(id, argc) dispatch.
value
Language-agnostic value system for fusevm.
vm
The fusevm execution engine — stack-based bytecode dispatch loop.