laspa 0.3.0

A simple Lisp-like language built with Rust
docs.rs failed to build laspa-0.3.0
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.
Visit the last successful build: laspa-0.2.0

läspa

Build Status codecov Downloads Version License

A toy language I designed to be as easy as possible to implement. Reminiscent of lisp, läspa uses Reverse Polish Notation for basic arithmetic and for function calls. With a basic interpreter implemented, I plan to implement a compiler with the help of LLVM and plain machine-code generation.

Installation

cargo install laspa

You will need the llvm toolchain to build the executable. Clang is also used for linking.

brew install llvm && export LLVM_SYS_160_PREFIX='/usr/local/opt/llvm@16'

Usage

See this test file for example syntax.

A simple Lisp-like language built with Rust

Usage: laspa [OPTIONS] <FILE>

Arguments:
  <FILE>  The file to build

Options:
  -O, --optimization-level <OPTIMIZATION_LEVEL>  Optimization level for the compiler [default: 1]
  -i, --interpret                                Interpret the file
  -v, --verbose...                               Verbose output
  -o, --executable-name <EXECUTABLE_NAME>        Executable name [default: main]
      --jit                                      Execute IR with JIT
  -h, --help                                     Print help (see more with '--help')
  -V, --version                                  Print version

Why

I was reading an article on the fastest implementation of a binary search algorithm. I saw llvm and thought to myself: "Hmm, wouldn't it be interesting to make a language." The rest is history.

Important Code

The lex, parse, and eval functions are the meat of the execution of the language. Those familiar with language development will recognize those names. llvm.rs is crucial to generating and compiling the IR for LLVM executations.