Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mistermboy/pycompiler
Python Compiler
https://github.com/mistermboy/pycompiler
compiler compiler-design compilers design java lex parser python uniovi university visitor visitor-pattern yacc
Last synced: 15 days ago
JSON representation
Python Compiler
- Host: GitHub
- URL: https://github.com/mistermboy/pycompiler
- Owner: mistermboy
- License: mit
- Created: 2018-02-01T08:20:48.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2020-06-10T09:56:14.000Z (over 4 years ago)
- Last Synced: 2024-10-10T16:30:51.551Z (27 days ago)
- Topics: compiler, compiler-design, compilers, design, java, lex, parser, python, uniovi, university, visitor, visitor-pattern, yacc
- Language: Java
- Homepage:
- Size: 4.35 MB
- Stars: 14
- Watchers: 3
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PYCompiler :eyes:
PYCompiler is a compiler for a simple version of python that was develop in the subject "Programming Languaje Design" at Univeristy of Oviedo (uniovi)
## Getting Started :rocket:
To begin with the project, clone the repository in your own computer. To do so, you can use this command:
```
git clone https://github.com/mistermboy/PYCompiler.git;
```
Alternative, you can download the repository as a zip file from the [repository main page](https://github.com/mistermboy/PYCompiler).
Once you have the repository, import the project in [eclipse](https://www.eclipse.org/).
```
-> File
-> Import
-> General
-> Existing Projects into Workspace...
```
### Using PYCompyler :checkered_flag:
To use PYCompyler there are two alternatives, you can write your own program ([View the syntax](docs/syntax.md)) ([Ver la sintaxis](docs/sintaxis.md)) or use an example one.
I recommend you the second option, if it´s your first time. There are a few example programs in the folder called "program4Test".
Once you've chosen an option, you only have to run the main class, that is located in the "py" package, passing the name of the input and the output file as a parameters. Here is a example with the program "big.input.txt", that calculates the Fibonacci sequence.
```
-> Run as
-> Run configurations
-> Java Application
-> Arguments
-> programs4Test/big.input.txt output.txt
```
Now you'll see the instrospector window, that shows a general view of the AST (Abstract Syntax Tree) built by the compiler. You can take a look if you want but it´s not necesary.
Close the introspector window and check the output file. You should see the instructions of the program you passed written in a language like assembler.
#### MAPL :wrench:
At this point we need to use some tool that is able to interpret the instructions. That tool is MAPL.
Execute "MAPL.cmd".
```
Location -> PYCompiler\MAPL.cmd
```
By default, MAPL load the "output.txt" file but you can chose other in "File -> Open..."
Using MAPL is very simple. At the left of the window we have the instructions of the program loaded and the buttons to run, debugg, reload... In the middle the static memory and finally in the rigth, the stack memory. Also there is an small terminal at bottom left.
To end with the example, run the program by clicking in the green arrow and look what happends. You should see the Fibonacci sequence calculated in the terminal. :computer:
## Development :construction: ⚙️
Now you will learn how the project is composed:
* [Lexical paterns](docs/PatronesLexicos.md)
* [GLC (context-free grammar)](docs/GLC.md)
* [Abstract grammar](docs/GramaticaAbstracta.md)
* [Code templates](docs/PlantillasCodigo.md)
* [UML](docs/UML.png)
## Built With 🛠️
* [Java](https://www.java.com/es/download/)
* [JFlex](http://jflex.de/)
* [Byaccj](http://byaccj.sourceforge.net/)
## License :clipboard:
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.