Installation

Method 1: Binaries

Grab a binary from the latest release. If you want an interactive REPL as in the above gif, grab the binaries with "repl" in their name.

If you want to run a few moonli files, grab the regular binaries.

However, the repl binaries depend on readline. This can be installed as follows:

• Ubuntu: sudo apt install libreadline-dev
• Mac OS: brew link readline --force
• Windows: pacman -S mingw-w64-x86_64-readline

In case of any installation issues, please create an issue on github or gitlab.

Method 2: From fresh compilers

Step 0. Install a package manager

Mac OS: brew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Windows:

• MSYS2: this will install the pacman package manager
• Or choco

Step 1. Install a compiler and some tools

• Ubuntu: sudo apt install git sbcl
• Mac OS: brew install git sbcl
• Windows:
  • pacman -S git mingw-w64-x86_64-sbcl
  • choco install git sbcl

Once this step is successful, you should be able to type sbcl --help and see something similar to the following:

Usage: sbcl [runtime-options] [toplevel-options] [user-options]
Common runtime options:
  --help                     Print this message and exit.
  --version                  Print version information and exit.
  --core <filename>          Use the specified core file instead of the default.
  --dynamic-space-size <MiB> Size of reserved dynamic space in megabytes.
  --control-stack-size <MiB> Size of reserved control stack in megabytes.
  --tls-limit                Maximum number of thread-local symbols.

Common toplevel options:
  --sysinit <filename>       System-wide init-file to use instead of default.
  --userinit <filename>      Per-user init-file to use instead of default.
  --no-sysinit               Inhibit processing of any system-wide init-file.
  --no-userinit              Inhibit processing of any per-user init-file.
  --disable-debugger         Invoke sb-ext:disable-debugger.
  --noprint                  Run a Read-Eval Loop without printing results.
  --script [<filename>]      Skip #! line, disable debugger, avoid verbosity.
  --quit                     Exit with code 0 after option processing.
  --non-interactive          Sets both --quit and --disable-debugger.
Common toplevel options that are processed in order:
  --eval <form>              Form to eval when processing this option.
  --load <filename>          File to load when processing this option.

User options are not processed by SBCL. All runtime options must
appear before toplevel options, and all toplevel options must
appear before user options.

For more information please refer to the SBCL User Manual, which
should be installed along with SBCL, and is also available from the
website <http://www.sbcl.org/>.

Step 2. Install ocicl

Follow the instructions at https://github.com/ocicl/ocicl.

Briefly:

• MacOS: brew install ocicl && ocicl setup
• Others:

git clone https://github.com/ocicl/ocicl
cd ocicl
sbcl --load setup.lisp
ocicl setup

Edit the compiler init file (eg. ~/.sbclrc) to include the current directory, or

#-ocicl
(when (probe-file #P"/Users/user/.local/share/ocicl/ocicl-runtime.lisp")
  (load #P"/Users/user/.local/share/ocicl/ocicl-runtime.lisp"))
(asdf:initialize-source-registry
 ;; (list :source-registry
 ;;       (list :tree (uiop:strcat (uiop:getenv "HOME") "/Common Lisp/"))
 ;;       :inherit-configuration)
 (list :source-registry
       (list :directory (uiop:getcwd))
       :inherit-configuration))

Step 3. Moonli

1. 3.1. Obtain the source

   git clone https://github.com/digikar99/moonli
   

2. 3.2. Start the REPL

   sbcl --eval '(asdf:load-system "moonli-repl")' --eval '(cl-repl:main)'
   

3. 3.3a. (Optional) Building basic binary

   The following should create a moonli binary in the root directory of moonli.

   (asdf:make :moonli)
   

   ./moonli --help
   A basic moonli transpiler over SBCL
   Available options:
     -h, --help                 Print this help text
     -l, --load-lisp ARG        Load lisp file
     -m, --load-moonli ARG      Load moonli file
     -t, --transpile-moonli ARG
                                Transpile moonli file to lisp file
   

4. 3.3b. (Optional) Build REPL

   The following should create a moonli.repl binary in the root directory of moonli.

   (asdf:make :moonli/repl)