verCE

A language frontend with LLVM pronounced like the word 'verse'. This language has almost python-like syntax with a few tidbits from C/C++. The compiler currently supports :

• double type variables
• Binary operations
• Function calls and definitions
• extern keyword
• Compiler optimizations like CSE, constant folding and propogation, etc.
• JIT compilation

More features will be added soon. Refer to docs/LANGUAGE_DOC.md for information on how to use the language, what is supported and how to get started.

Building

To build the program, just type make all when you are in the root directory. This will create /bin and /build directories. The executable will be in the /bin directory. The requirements are :

• clang>=8.0
• LLVM>=3.6
• GNU Make

To rebuild completely again, type

make remake

Running

To run the verCE compiler, there are 2 modes :

1. File Parsing

./verce <file>

In this mode, the compiler will read in the whole file and generate the IR for the entire file. By default optimizations are enabled in this mode.

1. Prompt

./verce

In this mode, a prompt >> will be provided to the user where they can type in their code line-by-line. The IR will be outputed for each line entered in.

Code Structure

The following documents the code structure of the project - what each directory does and where to find what.

verCe
├── bin/
│   └── verce           : executable file
|   └── libverCE.a      : static library for verCE 
├── build/              : object/build files
├── docs/               : documentation
├── include/            : header files
│   └── AST/            : AST header files
│   └── CodeGeneration/ : IR generation header files
├── lib/                : libraries
├── src/                : source files
│   └── CodeGeneration/ : IR generation source files
├── tests/              : test files with GTEST framework
│   └── unit_tests/     : unit tests
│   └── full_tests/     : complete program tests
├── Makefile            : makefile
├── README.md           : this file

References

[1] My First Language Frontend with LLVM Tutorial
[2] University of Waterloo CS 241 Course Notes.
[3] Let's write a compiler

This project is licensed under the Apache 2.0 License. See the LICENSE file for more information. The copyright notice is below.

Copyright (c) 2022 Keane Moraes