LFE, Lisp Flavoured Erlang, is a lisp syntax front-end to the Erlang compiler. Code produced with it is compatible with "normal" Erlang code. An LFE evaluator and shell is also included.
To compile LFE, simple clone it and compile:
$ git clone https://github.com/rvirding/lfe.git $ cd lfe $ make compile
LFE requires Erlang be installed on the system and that the
erl binary is
Should you wish to have LFE available system-wide, you can run
$ make install
By default this will create the programs
/usr/local/bin. This can be changed by defining the
PREFIX to point to the desired parent directory.
Note that the
install target will also install the LFE man pages in the
$(PREFIX)/share/man/man* directories. This can be changed by
MANINSTDIR to point to the desired top
$ make install PREFIX=/Users/rv/ MANINSTDIR=/Users/rv/man
will put the programs in
/Users/rv/bin and the man pages in the
If you're running LFE from a git clone working dir, you can start the REPL like so after compiling:
$ ./bin/lfe Erlang 17 (erts-6.0) [source] [64-bit] [smp:8:8] ... LFE Shell V6.0 (abort with ^G) >
If you have installed LFE, then you may start the REPL from any location:
$ lfe Erlang 17 (erts-6.0) [source] [64-bit] [smp:8:8] ... LFE Shell V6.0 (abort with ^G) >
Likewise, you may run an LFE shell script in the same style as shell scripts with:
$ ./bin/lfe script-name script-arg-1 ...
$ lfe script-name script-arg-1 ...
The docs site has several places to explore that will show you how to start using LFE. However, here's a quick taste:
- start up an LFE REPL as demonstrated above
- then, do something like this:
> (* 2 (+ 1 2 3 4 5 6)) 42 > (* 2 (lists:foldl #'+/2 0 (lists:seq 1 6))) 42
LFE now supports Docker. To get started, simply do the following, once you have Docker set up on your machine:
$ docker pull lfex/lfe
Alternatively, you could build the image yourself:
$ cd lfe $ docker build .
Here are a couple of simple usage examples:
$ docker run lfex/lfe 42
$ docker run -i -t lfex/lfe lfe Erlang/OTP 18 [erts-7.0] [source-4d83b58] [64-bit] [smp:8:8] ... LFE Shell V7.0 (abort with ^G) >
That last command will dump you into the LFE REPL on a running container
lfex/lfe Docker image. For more information on using Docker
with LFE, be sure to read the
Files with more technical details:
If you would like to make changes to the LFE documentation and then regenerate the docs, you'll want to read the instructions here: