https://github.com/icepanorama/javamonkeyinterpreter
An interpreter for the Monkey programming language, written in Java.
https://github.com/icepanorama/javamonkeyinterpreter
interpreter java junit monkey-programming-language
Last synced: 7 months ago
JSON representation
An interpreter for the Monkey programming language, written in Java.
- Host: GitHub
- URL: https://github.com/icepanorama/javamonkeyinterpreter
- Owner: IcePanorama
- Created: 2024-02-27T20:49:13.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-07-05T18:44:23.000Z (over 1 year ago)
- Last Synced: 2025-03-27T18:32:43.551Z (11 months ago)
- Topics: interpreter, java, junit, monkey-programming-language
- Language: Java
- Homepage:
- Size: 137 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Java Monkey Interpreter
A tree-walking interpreter for [the Monkey programming language](https://monkeylang.org/), written in Java.
As of July 3rd, 2024, the interpreter is fully functional, supporting "mathematical expressions, variable bindings, functions and the application of those functions, conditionals, [both explicit and implicit] return statements, and advanced concepts like higher-order functions and closures" (Ball 197) as well as 5 data types: integers, booleans, strings, arrays, and hashes.
## Features
+ Read-Eval-Print-Loop (REPL) environment for typing in code
+ Lexer for tokenization
+ Pratt/Recursive descent parser for syntactic analysis.
+ Abstract syntax tree (AST) for code representation and evaluation.
All of the interpreter's features were created from scratch, without the use of any outside libraries or frameworks.
## Installation & Usage
First, verify that you have both java and maven installed on your machine.
```bash
java --version
mvn --version
```
After that, installation can be completed by simply cloning the repository on to your local machine:
```bash
git clone https://github.com/IcePanorama/JavaMonkeyInterpreter
```
You can then run the interpreter using the following commands:
```bash
cd JavaMonkeyInterpreter/
mvn package
java -cp target/classes com.monkeyinterpreter.Main
```
To quit the interpreter, type `.quit`.
## To do
+ Refactor entire codebase.
+ Create better documentation for codebase.
+ Implement float datatype.
+ Implement quality-of-life improvements for REPL.
## Acknowledgements
This project was developed using the book, ["Writing An Interpreter In Go" by Thorsten Ball](https://interpreterbook.com/). As the name implies, Ball's original project was written entirely in Go and I converted everything to Java.
As of July 3rd, 2024, I'm finished with the book, although I still plan on cleaning the project up some before I'll truly consider it "complete". After that, I'll likely add some more features to the language on my own before moving onto the Thorsten Ball's next book, ["Writing An Interpreter In Go: The Lost Chapter - A Macro System For Monkey"](https://interpreterbook.com/lost/).