Interpreter and compiler for the Pascal language
Het programma vereist python versie 3.10. Het is ontwikkeld op Linux dus garantie dat eventuele onderdelen op Windows werken is er niet (het gaat hier met name over de uitvoering van shell commands die voorkomen in de compiler).
Om het programma aan te roepen moet je een aantal flags meegeven. Deze zijn:
- -f, --file voor het input bestand
- -c, --compile voor het compileren
- -i, --interpret voor het interpreteren
Een mogelijke aanroep ziet er dus als volgt uit
python3.10 main.py -f example.pas -i
of
python3.10 main.py -f example.pas -c
Mijn interpreter voor Pascal is turing compleet aangezien het de volgende functionaliteiten bevat:
- Conditional branching met behulp van if else statements, binnen deze statements kan je alle andere functionaliteiten gebruiken.
- While loops op basis van condities worden ondersteund.
- Je kan interacteren met het programma door in de main variabelen te declareren.
- De interpreter ondersteund meerdere functies per file recursieve functies worden ook ondersteund.
- Classes met inheritance: Er wordt op meerdere plekken binnen mijn interpreter gebruik gemaakt van inheritance, hieronder is een lijstje toegevoegd met plekken waar inheritance is gebruikt.
- Alle classes in ast_classes.py
- Het tokens object maakt gebruik van het interne type Enum TokensEnum
- Verder erfen alle overige objecten van het (object) type, dit kan in Python 3 ook weggelaten worden maar voor de old-schoolers onder ons vind ik dit wel netjes
- Object printing is geimplementeerd voor alle ast classed in ast_classes.py
- Een decorator die ervoor zorgt dat alle variabelen worden gecopieerd is gedefineerd in lexer.py
- Dit decorator object is gebruikt in lexer.py
- Haskell type annotation in comments: ja
- Python type hinting in functie definities: ja
- Toepassingen van hogere order functies:
- Zip
- Reduce (zelfgemaakt)
- Map op basis van list comprehension
- Map op basis van list comprehension
- Map op basis van list comprehension
- Functie resultaten worden opgeslagen in het door Pascal gedefineerde 'result' variabel
Om de werking van het programma inzichtelijk te maken staan er een aantal print statements door het programma heen. De eerste is te vinden in de main.py (regel 27), deze print alle tokens die zijn gegenereed door de lexer.
Na het printen van de tokens word de tree node van de AST geprint, dit gebeurd ook in main.py (regel 32)
Om te laten zien dat de interpreter werkt word bij elke assignment de locale scope geprint. Dit gebeurd in de interpreter in de visit_Assign functie. Tot slot returned de visit_Program functie "done" wat door de Interpreter.interpret() wordt geprint. Deze print statements zijn allemaal niet nodig en puur hier om te laten zien dat het werkt.
Om mijn compiler te testen maak ik gebruik van Lennart Janssen zijn cortex-m0 assembly interpreter. Deze wordt automatisch aangeroepen wanneer je de compiler flag meegeeft aan het programma. Zorg ervoor dat je in de root van dit project zit wanneer je het programma aanroept om eventuele directory errors te voorkomen.
Voor de checklist refereer ik naar de checklist van de Interpreter aangezien hier alle benodigde items al zijn benoemd.