Toy Language Interpreter

A toy language interpreter made in Java, together with a user-friendly interface to debug and see how simple programs work.

Table of Contents

• Introduction
• Features
• Installation
• Usage
• Screenshots
• Contributing
• License

Introduction

The Toy Language Interpreter is a Java-based project that interprets a simple toy language. It provides an intuitive graphical user interface (GUI) to help users debug and visualize the execution of their programs. This project is perfect for educational purposes and for those who want to understand the basics of language interpretation and debugging.

Features

• Java-based Interpreter: Implements a simple toy language interpreter in Java.
• User-friendly Interface: Interactive GUI built using JavaFX to debug and visualize program execution.
• Real-time Debugging: Step through the code and observe variable states and control flow.
• Sample Programs: Includes example programs to demonstrate the interpreter's capabilities.

Installation

To run the Toy Language Interpreter, you need to have Java and Gradle installed on your system.

1. Clone the repository:

   git clone https://github.com/AdrianMosnegutu/Toy-Language-Interpreter.git
   cd Toy-Language-Interpreter

2. Build the project:

   ./gradlew build

3. Run the application:

   ./gradlew run

Usage

1. Launch the application: After building the project, run the application using the command mentioned above.

2. Load a sample program: Use the GUI to load one of the sample programs provided in the repository.

3. Step through the code: Use the debugging controls in the GUI to step through the code and observe the interpreter's execution.

Screenshots

Main Interface

Debugging Example

Contributing

Contributions are welcome! If you have suggestions for improvements or want to add new features, feel free to fork the repository and create a pull request.

1. Fork the repository: Click on the "Fork" button at the top right corner of this page.

2. Create a new branch:

   git checkout -b my-feature-branch

3. Make your changes: Implement your feature or fix the bug.

4. Commit your changes:

   git commit -m "Add my new feature"

5. Push to your branch:

   git push origin my-feature-branch

6. Create a pull request: Click on the "New Pull Request" button on the repository page.

License

This project is licensed under the MIT License. See the LICENSE file for more details.