8000 GitHub - mattwparas/steel: An embedded scheme interpreter in Rust
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

mattwparas/steel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Steel

An embeddable and extensible scheme dialect built in Rust.

Actions Status Actions Status Coverage Status Discord Chat Matrix Chat

Try it on the Playground · Read the Steel book (WIP)

About

Steel is an embeddable scheme interpreter, with a standalone interpreter/repl included as well. The language is implemented as a bytecode virtual machine. At the moment, it is mostly compliant with R5RS, only missing let-syntax support. Support for R7Rs is underway.

Warning The API is relatively stable, however it may change at any time while pre 1.0. Care will be taken to keep things backwards compatible where possible.

Features

  • R5RS support
  • Modules, using require and provide much like Racket.
  • syntax-rules and syntax-case macros.
  • Easy integration with native Rust functions and structs, either through embedding or via FFI.
  • Higher order Contracts
  • Built in immutable data structures, including:
    • lists
    • vectors
    • hashmaps
    • hashsets

For more details, see the book

Getting Started

This github repository contains a cli interpreter. To try it out on the online playground, go to the Steel playground. To get started using a repl with the crates, make sure you first have rust installed.

Then, clone the repo and run the following command:

cargo run

This will launch a REPL instance that looks something like this:

Full install

If you'd like to install everything, just run the following command:

cargo xtask install

This will install:

  • The steel interpreter, steel
  • The package manager, forge
  • The dylib installer, cargo-steel-lib (also available via the interpreter)
  • The steel language server
  • The standard library, found under the cogs directory

Packages

If you would like to customize the location of installed packages, please set the STEEL_HOME environment variable. Steel currently follows XDG if present, and otherwise assumes the default of $HOME/.steel if the STEEL_HOME environment variable is not already set.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

See CONTRIBUTING.md.

About

An embedded scheme interpreter in Rust

Topics

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

No packages published
0