The miniature, embeddable R7RS Scheme implementation in Rust
The full documentation is here.
To install Stak Scheme as a library in your Rust project, run:
cargo add stakTo install the Scheme interpreter and alike as command line tools, run:
# Install the Scheme interpreter.
cargo install stak
# Install the minimal Scheme interpreter (6 times smaller!)
cargo install mstak
# Install the Scheme-to-bytecode compiler and bytecode interpreter.
cargo install stak-compile
cargo install stak-interpretFirst, prepare a Scheme script at src/hello.scm.
(import (scheme base))
(write-string "Hello, world!\n")Then, add a build script at build.rs to build the Scheme source file into bytecodes.
use stak_build::{build_r7rs, BuildError};
fn main() -> Result<(), BuildError> {
build_r7rs()
}Now, you can include the Scheme script into a program in Rust using the stak::include_bytecode macro.
use core::error::Error;
use stak::{
device::StdioDevice,
file::VoidFileSystem,
include_bytecode,
process_context::VoidProcessContext,
r7rs::{SmallError, SmallPrimitiveSet},
time::VoidClock,
vm::Vm,
};
const HEAP_SIZE: usize = 1 << 16;
const BYTECODES: &[u8] = include_bytecode!("hello.scm");
fn main() -> Result<(), Box<dyn Error>> {
run(BYTECODES)?;
Ok(())
}
fn run(bytecodes: &[u8]) -> Result<(), SmallError> {
let mut heap = [Default::default(); HEAP_SIZE];
let mut vm = Vm::new(
&mut heap,
SmallPrimitiveSet::new(
StdioDevice::new(),
VoidFileSystem::new(),
VoidProcessContext::new(),
VoidClock::new(),
),
)?;
vm.initialize(bytecodes.iter().copied())?;
vm.run()
}
![dependabot[bot]](https://avatars.githubusercontent.com/u/49699333?size=120)