BitsyLLVM (also "bitsyc") is a compiler for the Bitsy language implemented in C++ using the LLVM framework to handle the code generation step.

After cloning this repository, create a build folder at the project root, enter it

mkdir -p bitsy-llvm/build
cd bitsy-llvm/build

and run CMake like:

cmake                                       \
    -DCMAKE_C_COMPILER=clang                \
    -DCMAKE_CXX_COMPILER=clang++            \
    -DLLVM_DIR=/path/to/llvm/installation   \
    ..

Make sure that there is an installation of LLVM on your system. Although not strictly necessary, it is recommended to use the Clang compiler bundled with the LLVM installation to build bitsyc. The same compiler may be used at runtime if bitsyc is asked to produce an executable of a given Bitsy program instead of executing it just-in-time. CMake needs to find the LLVM configuration (LLVM_DIR). In case you do not use your system's default compiler, make sure that the values of CMAKE_C_COMPILER and CMAKE_CXX_COMPILER can be found in the PATH or use absolute paths.

Finally, build bitsyc with the build tool (Make, Ninja, ...) CMake has chosen or which you specified in the cmake call above with the -G argument. Depending on the chosen build tool, the bitsyc executable is located somewhere in build, typically (for Make, Ninja, ...) it is build/bitsyc.

The compiler bitsyc accepts some command line options. They can be displayed by bitsyc --help. By default the compiler executes the given Bitsy program directly and prints its output to standard output. All intermediate files will be put into a temporary directory on your system.

You may pass the path to bitsyc to the runspec script in the Bitsy repository to run all its reference tests against it.