For other platforms it should be possible to compile it on any platform LLVM can compile to. You will need git and CMake installed.

1. Install LLVM¶

See the LLVM documentation on how to set up LLVM for development. - On MacOS, installing through Homebrew or MacPorts works fine. - Using apt-get on Linux should work fine as well. - For Windows you can download suitable pre-compiled LLVM binaries from here.

2. Clone the C3 compiler source code from Github¶

This should be as simple as doing:

git clone https://github.com/c3lang/c3c.git

... from the command line.

3. Build the compiler¶

Create the build directory:

MyMachine:c3c$ mkdir build
MyMachine:c3c$ cd build/

Use CMake to set up:

MyMachine:c3c/build$ cmake ../

Build the compiler:

MyMachine:c3c/build$ make

4. Test it out¶

MyMachine:c3c/build$ ./c3c compile-run ../resources/testfragments/helloworld.c3

Building via Docker¶

You can build c3c using either an Ubuntu 18.04 or 20.04 container:

./build-with-docker.sh 18

Replace 18 with 20 to build through Ubuntu 20.04.

For a release build specify:

./build-with-docker.sh 20 Release

A c3c executable will be found under bin/.

Building on Mac using Homebrew¶

1. Install CMake: brew install cmake
2. Install LLVM 17+: brew install llvm
3. Clone the C3C github repository: git clone https://github.com/c3lang/c3c.git
4. Enter the C3C directory cd c3c.
5. Create a build directory mkdir build
6. Change directory to the build directory cd build
7. Set up CMake build for debug: cmake ..
8. Build: cmake --build .

Building on Mac using MacPorts¶

c3c may be built on Mac systems not supported by Homebrew using the cmake, llvm-17 and clang-17 ports from MacPorts.

1. Install CMake: sudo port install cmake
2. Install LLVM 17: sudo port install llvm-17
3. Install clang 17: sudo port install clang-17
4. Clone the C3C github repository: git clone https://github.com/c3lang/c3c.git
5. Enter the C3C directory cd c3c.
6. Create a build directory mkdir build
7. Change directory to the build directory cd build
8. ❗️Important before you run cmake❗️
   Set LLVM_DIR to the directory with the llvm-17 macport .cmake files
   export LLVM_DIR=/opt/local/libexec/llvm-17/lib/cmake/llvm
9. Set up CMake build for debug: cmake ..
10. Build: cmake --build .

See also discussion #1701