Powerful Scheme lisp in JavaScript

LIPS is poweful Scheme based lisp language written in JavaScript. The name is recursive acronym which stands for LIPS is Pretty Simple. The interpreter have very good integration with JavaScript.

Key features of the interpreter:

• Implementation of Lisp Macros, backquote and macroexpand,
• Runs in Browser and NodeJS,
• Familiar Scheme like Syntax,
• Functions in LIPS are normal javascript functions,
• Builtin documentation for macros and functions (use help in REPL),
• Library agnostic with almost no dependencies,
• You can invoke native JavaScript functions and methods from LIPS,
• Promises are treated as values they resolve to (so async code look like sync - like auto async/await),
• Easy extension using JavaScript using Macros or functions,
• Regexes are first class objects same as macros that are resolved at runtime,
• BigInt support (for browsers that don't have native support you will need bn.js),
• Optional dynamic scope (like in Emacs Lisp),
• Node.js and Web based Interpreter (REPL).

Check Getting Started Guide and try the interpreter while you will read the document.

To test latest beta implementation of the interpreter, check LIPS Beta Demo. Documentation (WIP) for version 1.0.0 can be found on Wiki.

When you're learning Scheme language, you can run the REPL directly on any page that have Scheme tutorial you're learning from. It even work with PDF files and new empty tab (at least in Chrome). Drag this link LIPS REPL to your bookmarks. When you click on the bookmark it will run the interpreter.

The bookmark can also be used to add REPL to your LIPS Web application.

NOTE: it will not work on this page, because it already have terminal on it and because it have not compatible LIPS version included.

It may also not work no sites that are protected with Content Security Policy

When using LIPS interpreter in browser you need to include the main script file.

If you want to use Webpack see wiki page for details.

<script src="https://unpkg.com/@jcubic/lips"></script>
    

You can put LIPS code directly in script tag:

<script type="text/x-lips">
  (print "hello")
  ;; this will load and evaluate external file
  (load "example.lips")
<script>
    

You can also use src attribute to link to source file.

<script type="text/x-lips" src="example.lips"><script>
    

npm install -g @jcubic/lips
    

To install 1.0.0 beta version use:

npm install -g @jcubic/lips@beta
    

## if installed as global just use
lips
lips foo.lips
## you can also run code as string
lips -c '(print "hello world")'
    

You can also write scripts using LIPS with shebang

Crete file foo.lips

#!/usr/bin/env lips
(let ((what "World"))
  (print (concat "Hello " what)))
    

Then run

chmod a+x foo.lips
./foo.lips # or just foo.lips depend on your $PATH
    

You can also run execute LIPS programaticaly (in Node.js/Webpack).

var lips = require('@jcubic/lips');
// or
import lips from '@jcubic/lips';
    

Then use it like this:

lips.exec("(let ((a 10) (b 20)) (* a b))").then(result => {
   // result is always array
   const [value] = result;
   console.log(value);
});