Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stonks3141/blueprint
A tiny R7RS Scheme interpreter.
https://github.com/stonks3141/blueprint
cli interpreter r7rs-small repl rust scheme scheme-interpreter
Last synced: 2 months ago
JSON representation
A tiny R7RS Scheme interpreter.
- Host: GitHub
- URL: https://github.com/stonks3141/blueprint
- Owner: Stonks3141
- License: mpl-2.0
- Created: 2023-01-03T01:32:02.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-06-19T00:24:53.000Z (7 months ago)
- Last Synced: 2024-10-10T13:43:47.341Z (3 months ago)
- Topics: cli, interpreter, r7rs-small, repl, rust, scheme, scheme-interpreter
- Language: Rust
- Homepage:
- Size: 113 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# blueprint
[](https://github.com/Stonks3141/blueprint/actions/workflows/ci.yml)
[](https://www.mozilla.org/en-US/MPL/2.0/)
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](https://www.rust-lang.org/tools/install).
Run `cargo install --git https://github.com/Stonks3141/blueprint blueprint` to
download, build, and install the program.
### Building from Source
Install the [Rust toolchain](https://www.rust-lang.org/tools/install) 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
```scheme
; main.scm
(define (fib n)
(if (or (= n 1) (= n 2))
1
(+ (fib (- n 1)) (fib (- n 2)))))
(display (fib 10))
```
```sh
$ blueprint ./main.scm
55
```
## Features
- [x] Parser
- [x] Lexical scoping and closures
- [x] Recursion
- [x] Proper tail-call optimization
- [x] Reference-counted garbage collection
- [x] REPL
- [ ] Descriptive syntax errors
- [ ] Error locations
- [x] 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](https://www.rust-lang.org/tools/install).
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.