## 方舟编译器孵化器 / MapleFE .gitee-modal { width: 500px !important; }

Explore and code with more than 5 million developers，Free private repositories ！：）
Notice: Creating folder will generate an empty file .keep, because not support in Git
[Origin of MapleFE]

This project is to create a programming language frontend, which leverages 'Autogen' to complete
most of work of lexing and parsing. The origin of this project is coming from the history in our parst twenty
years of work in compiler and programming languages. We are tired of the tons of modifications of existing
opensource frontend project like Clang, if we want to do something in new language features. So we decided to
have our own frontend, which could be easier to handle new languages.

[Key points]

1. Autogen is the key idea which automatically generates lexing/parsing data structures in .h/.cpp files which
are further included in the language frontend. The language implementors write .spec files describing the
language specifications under the language directory, such as java/.
2. The parsing algorithm is named Wavefront. The rules are categorized into recursions, and recursions are
combined into group if they reach each other. The Wavefront parsing is working on the recursion group.
It works wave by wave until it reaches the fixed point.

[Source code directory]

1. Most programming languages have very similar syntax, so it's very helpful to put
the shared part into a common directory. shared/ is for this usage. It contains
a) shared data structures representing shared syntax;
b) shared parser/translater components;
2. Language specific parts are in their own directory, such as java/. It contains some special part of this
language, the language .spec files, and gen_xxx.h/gen_xxx.cpp which are generted by autogen.
3. The tool autogen is under autogen/
4. The tool recdetect is under recdetec/. It's used to find the recursions and recursion groups.

[Preparation]

https://gitee.com/openarkcompiler-incubator/mapleall
Follow the instruction of mapleall and build the necessary libraries.
Once you are done, please update the lib and include paths in MapleFE/shared/src/Makefile accordingly.

[How to build]

1. source envsetup.sh
2. make mapleall.
This step is to build mapleall (Maple IR related libraries). If you have done it once,
you dont need do it again unless you changed the code in mapleall.
3. make
4. If you are working at Java frontend, you will see output/java/java2mpl. This is the executable
frontend.

[How to test]

1. cd test
2. ./runtests.pl all

You can find all Java test cases in test/java2mpl. Right now only java test cases
are used.

MapleFE is a unified frontend which is able to translate multiple languages into MapleIR. spread retract
C++ and 6 more languages

No release