SPL Compiler

Welcome to the GitHub Repository for the Simple Programming Language compiler.

The compiler has destinct phases; Lexing, Parsing, Type Checking and finally Code Generation. Each phase is subsequently implemented and tests (thus also usage) are given in test files.

Installation

Navigate to Releases and download the latest compiler-X.X.jar. You can use the jar by naivgating to the directory and running the following command:

java -jar compiler-X.X.jar -h

This will output the usage of the compiler.

usage: Compiler
 -c,--compile-only       Only compile the code, do not run it
 -h,--help               Show compiler usage
 -i,--input-file <arg>   The SPL filepath
 -p,--python             Compile to Python instead of SSM
 -r,--reformat           Reformat SPL code and exit (WARNING: Removes
                         comments)

Steps for Executing SSM code

SSM code can be compiled with the command:

java -jar compiler-X.X.jar -i test_file.spl -c

However, when it is desired to also run the code, the -c parameter should be omited. For running the code, you need to download the latest version of the Simple Stack Machine and put it in the same directory as the compiler-X.X.jar file. The SSM can be downloaded from this page or by clicking here.

Python Installation

The python compilation uses custom data types for Lists, as it uses a LinkedList implementation, and tuples, as python tuples are immutable. If the python package is installed the will be imported, otherwise they will be appended to the generated output file when used.

To install the python package, download the latest version of the spl_types.zip from the Releases. Unzip them to your specified folder and navigate to the environment. To install them, execute the following command:

Linux

sudo python3 setup.py install

Windows

python setup.py install