blueprint

A tiny R7RS Scheme interpreter.

Blueprint intends to be mostly R7RS-small compliant and implement a few SRFIs. It is and always will be a single-threaded interpreter, but hopefully I will find the time to make proper GC and a stack-based bytecode VM.

Installation

With Cargo

Install the Rust toolchain. Run cargo install --git https://github.com/Stonks3141/blueprint blueprint to download, build, and install the program.

Building from Source

Install the Rust toolchain and clone the repository. Run cargo install --path . in the base directory to build and install the program.

Usage

The CLI takes one positional argument: a path to the Scheme file to run. If you want to use the REPL, run with no arguments. A full list of command-line arguments can be obtained by running with the --help flag.

Example

; main.scm

(define (fib n)
  (if (or (= n 1) (= n 2))
    1
    (+ (fib (- n 1)) (fib (- n 2)))))

(display (fib 10))

$ blueprint ./main.scm
55

Features

• Parser
• Lexical scoping and closures
• Recursion
• Proper tail-call optimization
• Reference-counted garbage collection
• REPL
• Descriptive syntax errors
• Error locations
• Proper number type with ints, rationals, and complex numbers
• All basic expressions
• All standard procedures
• Quasiquotation
• Promises
• Exceptions
• Libraries
• Macros

Contributing

Clone the repository and install the Rust toolchain. Run cargo run in the root directory to build and run the program, or cargo test to run tests. Check out the above list of features that need implementing. Write tests for any new functionality.