FORTH Interpreter Project

NAME:Tejasriram Parvathaneni UFID:60990109

Introduction

This project develops a basic FORTH interpreter using Haskell. The main target of this interpreter system focused on processing and running FORTH commands while supporting arithmetic operations with stack control together with the EMIT and CR functions and value-string converters through STR along with CONCAT2 and CONCAT3 functions. Working on this project allowed me to apply practical Haskell experience for functional programming while gaining insight into interpreter functionality.

Instructions to Run the Code:

1. Install Haskell (GHC) and Cabal: brew update brew install ghc cabal-install
2. Clone the Repository: git clone https://github.com/your-username/FORTH (Replace "your-username") cd FORTH
3. Update your package list and install dependencies (such as HSpec for testing): cabal update cabal install hspec
4. Build the Project (compile all modules and produces the executab): cabal build
5. Run Test Cases: cabal run FORTH -- tests/t1.4TH

Situations Encountered:

Version Change:
        I faced several problems from the beginning when trying to resolve dependency constraints. I began with 'base >=4.10 && <4.11' dependency in 'FORTH.cabal' yet my system contained 'base-4.21'. Debugging cryptic error messages occupied many hours before I realized that my constraint needed to be changed to 'base >=4.10 && <5.0'. Learning dependency management became tough during this experience and showed the value of mastering toolchain operations.
Balancing Features and Usability:
        When execution finished while leaving non-empty stack data was a hurdle that needed resolution. The system needed to complete command processing along with generating valuable feedback. The `Main.hs` file required a new check to display feedback with the stack contents which proved essential for the interpreter. Testing errors appeared and simultaneously made the interpreter handle execution inputs better.
Floating-Point Precision Issues:
        When working with numbers that have decimals, small differences can occur due to how computers handle floating-point math. This means the result might have extra decimal places or slightly rounded values, which can be tricky if you expect an exact output. We needed to manage these differences to ensure our tests passed.
String Conversion and Concatenation Issues:
        Converting values (like numbers) to strings using the STR command and then joining them together using commands like CONCAT2 or CONCAT3 sometimes led to problems if the wrong type of value was used. The code had to check that only proper string values were processed and give a helpful error if not. 

Results

The final interpreter successfully processes FORTH code by:

• Parsing input from text files.
• Evaluating operations and manipulating a stack.
• Producing correct output as specified in functional tests.
• Detecting and reporting if the stack is not empty at the end of execution.