errors.py

"""
Jerarquia d'excepcions per a l'intèrpret de mini FORTH.

Clasificació d'errors:
- Lèxics: Tokens no reconeguts per la gramàtica
- Sintàctics: Estructura sintàctica incorrecta
- Semàntics: Errors de context y execució
"""


class ForthError(Exception):
    """
    Excepció base per tots els errors
    """
    pass

class ForthLexicalError(ForthError):
    """
    Errors lèxics detectats pel lexer.
    
    Exemples:
    - Tokens no reconeguts a la gramàtica: @, $, #, etc.
    """
    pass


class ForthSyntaxError(ForthError):
    """
    Errors sintàctics detectats pel parser.
    
    Exemples:
    - Tokens reconeguts però estructura sintàctica incorrecta: : ;
    """
    pass


class ForthSemanticError(ForthError):
    """
    Errore semàntics. Els detecta tots el visitor, però si fos un compilador uns es detectarien en fase de compilació i altres en fase d'execució
    
    Exemples estàtics (compilació):
    - Funció no definida
    - if fora de funció
    - recurse fora de funció
    
    Exemples dinàmics (runtime):
    - Divisió per zero
    - Pila buida
    """
    pass