Skip to content

Latest commit

 

History

History
57 lines (39 loc) · 2.12 KB

README.md

File metadata and controls

57 lines (39 loc) · 2.12 KB
Raw

C-to-MIPS-compiler-with-C-to-Python-translator

1. The Project

This software, written in C++, serves two functions:

  1. It can compile an input C90 (ANSI) program to MIPS1 assembly
  2. It can also translate this program to the Python3 equivalent.

It conforms to this spec. All specified features are covered.

Also included are bash scripts to run the compiler against sets of test programs for both functionalities (these test cases are also included).

2. Required Software

  1. Flex, the fast lexical analyzer generator.
  2. GNU Bison, is used as parser.
  3. A C++ compiler e.g. g++

The compiler is intended to run on a Linux OS e.g. Ubuntu.

3. How to run

  1. First build: make bin/c_compiler Build will take a little bit of time.

  2. Then you may compile: bin/c_compiler -S filename.c -o output_file.s

  3. Or translate: bin/c_compiler --translate filename.c -o output_file.py

  4. To output translation to terminal window instead of to a file, use '-k' flag instead of '-o' and do not put a file name after the flag e.g. bin/c_compiler -S filename.c -k

  5. Finally, to test the compiler, run the bash script: ./compiler_test.sh

  6. And to test translator: ./c_translator_formative.sh

4. Additional Information

This project was done as part of a college assessment in a group of 2 - co-authored with Shafir360. It conforms to this spec, but the implementation is original work of the authors.

5. Acknowledgements

Around 80% of the test cases are provided by John Wickerson, and were of great help in compiler verification. The authors added more complicated tests on top of these.

We are very grateful to johnwickerson, m8pple, ymerklotz and tobhil98 for their guidance in building the compiler, which we did our best to follow.