https://github.com/soerlemans/acris
Acris is a compiler project for a systems programming language aimed at interoperability with multiple languages.
https://github.com/soerlemans/acris
acris ast c cmake codegen compiler cpp cpp23 interoperability language lexer llvm python3 transpiler
Last synced: 19 days ago
JSON representation
Acris is a compiler project for a systems programming language aimed at interoperability with multiple languages.
- Host: GitHub
- URL: https://github.com/soerlemans/acris
- Owner: soerlemans
- Created: 2023-08-18T18:02:40.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-01-24T22:58:12.000Z (28 days ago)
- Last Synced: 2026-01-25T05:50:07.455Z (28 days ago)
- Topics: acris, ast, c, cmake, codegen, compiler, cpp, cpp23, interoperability, language, lexer, llvm, python3, transpiler
- Language: C++
- Homepage:
- Size: 2.25 MB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Acris
=====
Home of the Acris programming language.
Named after the genus Acris which is the name of cricket frogs.
Acris syntax is somewhat inspired by Swift, Golang and Rust.
But in Hyla expressions are not statements.
This allows us to write code without any need for semicolons.
The main goal of the programming language is having seamless interoperability with other programming languages.
Besides being able to select which backend you want to use for code generation:
+ LLVM (being refactored to be generated by IR).
+ C++ (Generated from the AST).
+ C (not yet implemented)
It is also possible to select for which languages you want interoperability:
+ Python (Works for C++ backend uses `pybind11`)
+ Lua (not yet implemented)
+ JavaScript (not yet implemented)
Here is a simple sample program.
```go
module main
// Standard library includes:
#include_once
func main() -> int {
defer {
println("Defer!")
}
println("Hello World!")
}
```
Which can be compiled using:
```shell
acris --backend cpp --interop python samples/hello.ac
```
Which will create an importable Python DLL.
Or here is a simple example using C interop.
```go
module main
// Define a forward declaration for the libc abs function.
[[extern("C")]] {
declare func abs(t_x: int) -> int
}
func main() -> int {
let num = abs(-23)
println("Absolute value of -23 => {}", num)
return 0
}
```
Compile using:
```shell
acris --backend cpp samples/attribute.ac
```
This will generate a DLL which can be directly imported from Python.
## Warning
Note that the project is not yet stable at all.
And a lot of things are not working yet or feature complete.
Here is a list of the following, which is implemented:
1. Lexer.
2. Top down LR parser.
3. Pratt parser (handles operator precedence when parsing).
4. Semantic validation (type inference, type checking, type promotion, symbol table generation).
5. IR generation (currently being worked on).
6. LLVM backend (partially implemented).
7. C++ backend (fully implemented and generates from AST).
8. C++ backend - Python interop.
9. Compiler flag configuration via CLI and TOML file (`acris.toml`).
10. Variables are implemented (`let` and `var` for constants and normal variables respectively).
11. Arithmetic is implemented.
12. Loops are implemented.
13. Calling functions (and the standard library functions `print` and `println`).
14. Serializing AST and deserializing AST (important for when implementing parallel compilation of multiple translation units, to prevent memory overhead).
15. Logging infrastructure is in place.
16. Visitor pattern used for, semantic analysis, serializing, printing, code generation, IR generation, etc.
## Dependencies
In order to compile the project you will need to following dependencies:
- C++ compiler with support for C++23.
- [Invoke](https://www.pyinvoke.org/) (Used to invoke CMake and scripts)
- [Cmake](https://cmake.org/) (Main buildsysstem)
- [CLI11](https://github.com/CLIUtils/CLI11) (CLI option parsing library)
- [rang](https://github.com/agauniyal/rang/tree/master) (cross platform terminal coloring library)
- [tabulate](https://github.com/p-ranav/tabulate) (Text table library)
- [Boost](https://www.boost.org/) (Utility libraries for C++)
- [LLVM](https://llvm.org) (LLVM is used for code generation and optimization)
- [cereal](https://uscilab.github.io/cereal/) (Serialization library used for the AST)
- [libassert](https://github.com/jeremy-rifkin/libassert) (Modern assertion library for compile and runtime assertion checking)
- [pybind11](https://github.com/pybind/pybind11) (Used to generate C++ to Python bindings.)
### Buildsystem
In order to compile the project you will need a couple of dependencies.
First we use invoke to invoke different python scripts, to orchestrate building the project.
In order to install invoke it is best to use pipx.
Which is installed using:
```shell
apt install -y pipx
```
In order to make use of invoke you should install it through `pipx`.
```shell
pipx install invoke
```
The you can invoke the appropriate setup script for your OS by running:
```shell
inv setup
```
If your OS is not supported it is best to checkout `tools/setup` and figure out what dependencies you require.
### Build
After installing the necessary dependencies you can build the compiler by running:
```
inv build --parallel
```
## Project documentation
- `assets/`: Non code related assets like images.
- `cmake/`: Cmake sources that are needed to build the project.
- `src/`: Sources of the Acris project.
- `tests/`: Unit tests of the Acris project.
- `samples/`: Acris source samples to learn and play around with.
- `tools/`: Collection of tools and scripts, that aid development.