moco is a Monty to
LLVM compiler built using
Java, ANTLR4 and
LLVM.
Please read the language
specification for
details on the Monty programming language and refer to the feature
overview for a list of implemented features.
Install LLVM and a JRE 7.
sudo apt-get install llvm
sudo apt-get install default-jre
If you want to build moco yourself you'll need to install the following
dependencies and a JDK 7.
sudo apt-get install git
sudo apt-get install maven
sudo apt-get install default-jdk
You can also install Graphviz to generate class diagrams. This is optional.
sudo apt-get install graphviz
Note: Please make sure you have homebrew and a JRE 7 installed.
Install LLVM using homebrew:
brew install llvm
If you want to build moco yourself you'll need to install the following
dependencies and a JDK 7.
brew install git
brew install maven
Please make sure to set the JAVA_HOME environment variable for maven.
export JAVA_HOME=$(/usr/libexec/java_home)
You can also install Graphviz to generate class diagrams. This is optional.
brew install graphviz
To use LLVM you'll need to download and install the
following executables. In addition you'll need to download and extract the
llvm-3.4-tools-windows.7z archive into the bin\ directory of your LLVM
installation. To run the executable .jar file you'll also need a JRE 7.
- http://www.microsoft.com/de-DE/download/details.aspx?id=40784 (the x86 and the x64 version)
- http://llvm.org/releases/3.4/LLVM-3.4-win32.exe
- https://github.com/CRogers/LLVM-Windows-Binaries/releases/download/v3.4/llvm-3.4-tools-windows.7z
If you want to build moco yourself you'll need to install the following
dependencies and a JDK 7. These examples use the
chocolatey package manager.
choco install maven
choco install java.jdk
choco install git.commandline
You can also install Graphviz to generate class diagrams. This is optional.
choco install graphviz
Note: Instead of building your own version you can always get a precompiled .jar file at the releases page.
For building your own version based on the most recent commit clone the git repository:
git clone https://github.com/MontysCoconut/moco.git
After that you can change into the directory and build the executable
.jar file. Now you can find the executable jar in the target/ directory.
cd moco
mvn package
If you want to generate the class documentation make sure to have
graphviz installed and run the following command.
After that you can find the generated HTML-files in the target/site
directory.
mvn site
For some background information and a guide to submit merge requests please read hacking.
To use moco you'll either need to compile your own version or fetch a
precompiled .jar file at the
releases page.
You can just pass moco a Monty-file and it will be compiled and executed.
➤ cat hello.monty
print("Hello World!")
➤ java -jar moco-0.6.jar hello.monty
Hello World!
Please see the help text for information about the command-line switches. usage: moco [--help] [-S] [-c] [-e] [-p] [-d] [-o ] [file]
The Monty compiler.
positional arguments:
file Monty file to run.
optional arguments:
--help Print this help and exit.
-S, --emit-assembly Emit the LLVM assembly and stop.
-c, --compile-only Only compile the executable without running it.
-e, --stop-on-first-error
Stop the compilation on the first encountered error.
-p, --print-ast Print the AST.
-d, --debug-parsetree Debug the parsetree without running anything.
-o <file> Write output to <file>.
Without -S or -c the program is compiled and directly executed.