# POETIC
Rust library to parse and interpret [poetic](https://mcaweb.matc.edu/winslojr/vicom128/final/index.html) source code
It supports all of the instructions and handles digit conversion accordingly, with the only difference being that it dynamically allocates more memory if needed instead of 30.000 bytes. This means memory pointer wrapping at the "end" is not possible. Maybe in the future through a option.
https://mcaweb.matc.edu/winslojr/vicom128/final/tutorial/index.html
## Tests
There are tests for the parser and interpreter which you can run with:
```Rust
cargo test
```
## Usage
It will first parse the string source input and parse it to intermediate opcode number representation.
```Rust
let mut buf = fs::read_to_string("input.ptc").unwrap();
let intermediate = Parser::parse_intermediate(&buf);
```
Then it will convert the intermediate representation to the instructions.
```Rust
let instructions = Parser::parse_instructions(&intermediate);
```
These instructions can then be executed with the interpreter
```Rust
let mut interpreter = Interpreter::new(code);
interpreter.run();
```
You can let the interpreter just fully execute it with the `run` method or step through every instruction with the `step` method.
## Example
An example usage can be found at https://github.com/mztikk/poetic_interpreter which is a cli application that will take a poetic source file and execute it.