Compiler for Spring 2019 Compilers Course, implemented in python. Compiles a custom language into a subset of the 6502 opcodes.
To run the Compyler it must be installed. It can be installed either from pypi or from the source code of the directory.
Simply use pip to install the latest release of the compyler. To do so run pip install Compyler
.
Either in a Python Virtual Environment or just on your machine in the root of the directory run make install
this will install the compyler from the source code in the repo using the setup.py file. If you would like to uninstall simply run make uninstall
Once setup has been completed an Alan++ source code file can be compiled. To do so run compyler /path/to/file
path - The path of an Alan++ source file to be compiled.
--verbose or -v - when passed all actions of compiler will be logged to stdout.
--prettytree or -p - Outputs CST and AST in a fancier form.
compyler -v -p ./examples/AssignVals.txt
0.1.0 - Project1
0.2.0 - Project2
0.3.2 - Project3
0.4.0 - Project4
To develop the compyler it would be a nuisance to install each time a change is made, to avoid this use a python virtual environment. To create a Virtual environment or venv use the following command python3 -m venv/path/to/new/virtual/environment
The path should be pointed at this repository. To enter a venv that already exists navigate to the bin dir inside of env and run source activate
. In the case of this repo the command would look like this, source ./env/bin/activate
.
Once in a venv to run the compyler without installing use the following format: python3 compyler /path/to/source/file
while in the root of the directory.
To publish the latest release of the build to pypi run the following recipe: make release
. This will test, build and publish the release to pypi.