Getting started with Eclair
In this guide, we will explain how to install the Eclair compiler so you can start using eclair in your projects.
Let’s get started!
First, the following list are the minimal requirements and tools to start using Eclair:
The steps below will assume Ubuntu Linux when Linux is mentioned, but with some slight modifications the commands can also be ran on other Linux distributions.
Eclair makes use of git for version control. The steps below show how to install git:
$ sudo apt install git
$ brew install git
The Eclair compiler uses LLVM for code-generation. LLVM 14 is the latest supported / recommended version. Install it via your package manager of choice, or build it from source. This can be done with entering the following commands in your terminal:
# If these packages are not available on your system, # try installing using this link: https://apt.llvm.org/. $ sudo apt install llvm-14 $ sudo apt install lld-14 # Optional, if you want to use clang instead of llc # to compile the LLVM IR $ sudo apt install clang-14
$ brew install llvm@14
After LLVM finishes installing, make sure the following commands are in your
$PATH (these might have a version suffix):
- clang (optional, but handy)
Finally, make sure that
libLLVM.so (potentially with a suffix) is in a
directory listed in your
$LD_LIBRARY_PATH. If you installed LLVM via a
package manager, this should automatically be the case.
Using Eclair from within Docker
The easiest way to get up and running with a working Eclair compiler is via the
Docker image in the eclair repository. Before you
can build the image, make sure
docker is installed on your system.
docker is installed and available on your
$PATH, you can build the
Eclair Docker image
by running the following commands in your terminal:
$ git clone firstname.lastname@example.org:luc-tielen/eclair-lang.git $ cd eclair-lang $ docker build -f Dockerfile . -t eclair:latest
After the Docker image finishes building, you can use Eclair from within Docker
by making use of a docker volume. For example, the following command assumes
hello.eclair file is located in the current directory, uses a volume to
mount the current working directory inside the Docker image, and compiles the
program to a file containing LLVM IR in textual format:
$ docker run --rm eclair:latest -v $(pwd):/code eclair compile hello.eclair > hello.ll
hello.ll file will be saved on your own machine. The file can
then be further compiled with LLVM using
clang, … like any other
Building from source
Building from source is more difficult than using Eclair from the docker image (mostly because you will need more tooling installed on your system), but it allows you to directly use Eclair on your system.
Besides the minimal pre-requisites mentioned previously, Eclair requires both a Haskell and Soufflé compiler to be installed on your system. If you notice that the installation instructions below are incomplete or outdated, please open a Github issue.
Part of the Eclair compiler is written in Soufflé Datalog, so the Soufflé compiler (version 2.3) needs to be available on your system. You can find binaries for your operating system on the release page for Soufflé, or install it via your package manager.
The other part of the Eclair compiler is written in Haskell, so we will need a Haskell
compiler for compiling the source code.
GHC 9.4 is the current recommended
Haskell compiler. The easiest way to install GHC is with
ghcup. Run the following commands in a
terminal to install the Haskell toolchain:
$ curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh $ ghcup tui # In the UI, select GHC 9.4 and recommended Cabal version # Important: both install + set them!
Building the compiler
Now that all pre-requisites are installed, you can build the compiler itself. Run the following commands to clone the Eclair repository from Github and build the code.
$ git clone email@example.com:luc-tielen/eclair-lang.git $ cd eclair-lang $ cabal build $ cabal list-bin eclair-lang
And wait for the code to finish compiling. If the compilation succeeds, it should print out the path to the compiler.
Configuring your environment
The final step is to update your environment variables (located in
.zshrc, …) in so the eclair compiler can be found. Do this by applying the
- Add the path returned by
cabal list-binto your
- Add the following line to your config:
export DATALOG_DIR=ECLAIR_REPO_DIR/cbits. (“ECLAIR_REPO_DIR” should be replaced with the path where you cloned the Eclair compiler).
Check your installation
If you followed all steps, you should now have a working Eclair compiler build from source! You can check this by running the following command in your terminal:
$ eclair --help
This should print out the help page for the compiler.