Serene/serene
Serene
/
serene
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Activity
Just another Lisp https://serene-lang.org
477 Commits 19 Branches 0 Tags 4.7 MiB
C++ 76.3%
CMake 11.5%
Nix 4.1%
Shell 3.9%
Emacs Lisp 1.4%
Other 2.8%
Go to file
Sameer Rahmani b922284a39 Fix the broken include in types.cpp 2022-06-11 18:07:09 +01:00
cmake Add new doxygen setup 2022-02-12 22:25:22 +00:00
devtools Fix the broken include in types.cpp 2022-06-11 18:07:09 +01:00
docs Add a glossary section to the spec.org 2022-06-02 15:07:01 +01:00
libserene Fix the broken include in types.cpp 2022-06-11 18:07:09 +01:00
resources Remove unwanted backup files 2022-02-19 14:49:37 +00:00
scripts Fix the remaning license headers from the MIT era 2022-03-08 13:32:10 +00:00
serene-repl Disable serenec and serene-repl tests temporarily for refactoring 2022-02-19 14:52:47 +00:00
serene-tblgen Refactor the error handling system to have only one llvm error with many variants 2022-03-10 19:31:48 +00:00
serenec Disable serenec and serene-repl tests temporarily for refactoring 2022-02-19 14:52:47 +00:00
.clang-format Hide the clang-tidy behind a build option 2021-10-17 22:22:49 +01:00
.clang-tidy Add the more resouces about JIT to dev.org 2021-12-29 13:12:36 +00:00
.dockerignore Setup the dockerfiles necessary to build serene in a container 2022-02-08 17:43:29 +00:00
.gitignore Update gitignore patterns 2022-06-02 15:00:26 +01:00
.ignore_sanitize Add the IR generation facilities to Namespace and Expression 2021-06-13 22:40:58 +01:00
CMakeLists.txt Add devtools utility set 2022-04-04 22:42:56 +01:00
LICENSE Change the license to GPL2 2021-10-12 20:51:03 +01:00
README.org Update the README file with the new LLVM SHA 2022-06-11 18:02:33 +01:00
builder Fix the builder paths for top level binaries 2022-03-29 19:49:56 +01:00
dev.org Moving to the a JIT first design 2022-06-10 21:49:11 +01:00

README.org

Serene lang

Setup development environment

Setup the githook and install dependencies using the following commands:

./builder setup

Dependencies

You would need the following dependencies to start get started with Serene development

  • LLVM (LLVM Instructions coming up.)
  • cmake
  • ninja
  • doxygen (If you want to build the docs as well)
  • Valgrind
  • CCache (If you want faster builds specially with the LLVM)

LLVM Installation

Important Note: We're trying to keep Serene up to date with the LLVM release cycle till we get to our first release. So we use the development version of the LLVM. Currently we are using 9080e21906a162cb2aabcd214d62fa3e463b7675 commit as our reference.

MLIR is a part of the LLVM project and in order to build it we need to build the LLVM itself as well. Here is a quick guide to build the latest version of the LLVM and MLIR.

  ## YES we're using the development version of MLIR
  git clone https://github.com/llvm/llvm-project.git

  mkdir llvm-project/build
  cd llvm-project/build

  cmake -G Ninja ../llvm \
        -DCMAKE_INSTALL_PREFIX=/your/target/path \
        -DLLVM_PARALLEL_COMPILE_JOBS=7 \
        -DLLVM_PARALLEL_LINK_JOBS=1 \
        -DLLVM_BUILD_EXAMPLES=ON \
        -DLLVM_TARGETS_TO_BUILD="X86" \
        -DCMAKE_BUILD_TYPE=Release \
        -DLLVM_EXTERNAL_PROJECTS=iwyu \ # Only if you want to enable the 'Include what you use' tool
        -DLLVM_EXTERNAL_IWYU_SOURCE_DIR=/path/to/iwyu \
        -DLLVM_ENABLE_ASSERTIONS=ON \
        -DLLVM_CCACHE_BUILD=ON \
        -DCMAKE_EXPORT_COMPILE_COMMANDS=ON \
        -DLLVM_ENABLE_PROJECTS='clang;lldb;lld;mlir;clang-tools-extra;compiler-rt' \
        -DCMAKE_C_COMPILER=clang \       # If you have clang installed already
        -DCMAKE_CXX_COMPILER=clang++ \   # If you have clang installed already
        -DLLVM_ENABLE_LLD=ON

  cmake --build .

  cmake --build . --target check-mlir

  cmake -DCMAKE_INSTALL_PREFIX=/your/target/location -P cmake_install.cmake

You need to have clang and lld installed to compile the LLVM with the above command. Also if you are not using ccache just remove the option related to it from the above command.

Emacs

If you're using Emacs as your development environment just install clangd and lsp.

Heads up for devs

While you're working on Serene be mindful of:

  • In DEBUG mode we dynamically link against libsan due to the fact that we build the libserene as a shared lib by default. This means we need to LD_PRELOAD the libclang_rt before we run any executable. If you're using the builder script you're all set otherwise you can run an executable like:

      LD_PRELOAD=$(clang -print-file-name=libclang_rt.asan-x86_64.so) /path/to/executable

Build the devtools

We have our own version of `mlir-opt` which is `slir-opt` and also we have an LSP server for SLIR too. Both are in the devtools directory and in order to build them all you need to do is to use -DSERENE_ENABLE_DEVTOOLS=ON parameter with cmake for example ./builder build -DSERENE_ENABLE_DEVTOOLS=ON will do the job for you.

How to build

In order to build for development (Debug mode) just use ./builder build to setup the build and build the project once and then you can just use ./builder compile to build the changed files only.

Check out the builder script for more subcommands and details.

Cheatsheets

License

Copyright (c) 2019-2022 Sameer Rahmani <lxsameer@gnu.org>

Serene is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.

Get Help

If you need help or you just want to hangout, you can find us at: