https://github.com/csvancea/glyphointerpreter
An interpreter for Glypho - an esoteric programming language
https://github.com/csvancea/glyphointerpreter
Last synced: about 2 months ago
JSON representation
An interpreter for Glypho - an esoteric programming language
- Host: GitHub
- URL: https://github.com/csvancea/glyphointerpreter
- Owner: csvancea
- Created: 2021-02-08T15:03:33.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-02-25T17:35:22.000Z (over 5 years ago)
- Last Synced: 2025-12-28T11:09:23.384Z (6 months ago)
- Language: Java
- Homepage:
- Size: 199 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Glypho Interpreter - Cosmin-Razvan VANCEA - 333CA
Structura si implementare:
--------------------------
* Codul este impartit in 3 pachete:
1. decoder (decodifica un sir de glife)
2. executor (executa instructiunile decodificate)
3. main (citeste si valideaza argumentele primite de la linia de comanda)
* Pachetul `decoder`:
- are rolul de a traduce un sir de glife intr-o lista de instructiuni
- o instructiune decodificata este formata din:
- cod de operatie (opcode)
- jump index (optional; se aplica doar operatiilor care efectueaza salturi (*BRACE))
- decodificarea se desfasoara astfel:
- se verifica daca numarul de glife este divizibil cu 4
- se citesc blocuri de cate 4 simboluri si se determina codul de operatie
- se genereaza instructiunea decodificata si se adauga in lista
- in plus: exista o stiva care memoreaza adresele la care s-au gasit instructiuni
LBRACE pentru a se putea face asocierea LBRACE-RBRACE (balanced brackets)
- daca la orice pas se detecteaza o eroare de sintaxa, atunci se arunca exceptia
`SyntaxException` care indica indexul instructiunii si o scurta descriere a
problemei (descrierea este doar pentru debugging)
- la finalul traducerii va rezulta o lista de instructiuni in formatul prezentat mai sus
* Pachetul `executor`:
- se comporta ca un procesor - are rolul de a executa un sir de instructiuni decodificate
- clasa `Executor` are in componenta:
- o lista de instructiuni decodificate (primita de la Decoder)
- un "registru" care indica indexul instructiunii care trebuie executata la pasul curent
- o stiva pentru simboluri (implementata printr-o lista dublu-inlantuita
deoarece instructiunile lucreaza cu ambele capete ale "stivei")
- o functie care "implementeaza" codul din spatele fiecarui opcode
- daca la orice pas se detecteaza o eroare de runtime, atunci se arunca exceptia
`RuntimeException` care indica indexul instructiunii si o scurta descriere a
problemei (descrierea este doar pentru debugging)
* Pachetul `main`:
- imbina pachetele `decoder` si `executor`
- prinde exceptiile aruncate si afiseaza erorile corespunzator la stderr