Tulisp

Tulisp is a Lisp interpreter that can be embedded into Rust programs. The syntax tries to closely match that of Emacs Lisp. It was primarily designed to be a configuration language, but it also works well as a general purpose embedded scripting language.

One of the many benefits of using the Emacs Lisp syntax is that we can reuse its documentation for the builtin functions and macros. And for people who are already familiar with Emacs Lisp, there's no need to learn an extra language.

Getting started

It is very easy to get started with using Tulisp.

Add it as a dependency in your Cargo.toml:

toml [dependencies] tulisp = "0.2.0"

And in your main.rs:

```rust use tulisp::{TulispContext, tulisp_fn, Error};

fn main() -> Result<(), Error> { // Create a new Tulisp execution context. let mut ctx = TulispContext::new();

  // Add a function called `add_nums` to `ctx`.
  #[tulisp_fn(add_func = "ctx")]
  fn add_nums(num1: i64, num2: i64) -> i64 {
      num1 + num2
  }

  // Write a lisp program that calls `add_nums`
  let program = "(add_nums 10 20)";

  // Evaluate the program, and save the result.
  let sum: i64 = ctx.eval_string(program)?.try_into()?;

  assert_eq!(sum, 30);
  Ok(())

} ```