This is a brainfuck interpreter that is built with a lexer, a parser and a debugger protocol.

Currently there isn't a debugger client. If you run your program with a debugger attached, the program will wait for a client to connect and do nothing else.

To run a brainfuck script, import the engine and create an engine options struct and pass it to a new engine.

package main

import (
  "github.com/CanPacis/brainfuck-interpreter/engine"
)

func main() {
  options := engine.EngineOptions{
    FilePath: "./bf/add.bf",
  }

  e := engine.NewEngine(options)
  // then simply run it
  e.Run()
}

This is actually intended to be a superset of brainfuck so there are extended capabilities of the runtime.

You can clear your tape with a * opearator.

+
>+
>+

tape is [1, 1, 1, 0, 0 ...] right now

*

tape is cleared and [0, 0, 0, 0, 0 ...] now

You need to escape the operator keywords if you are using them in your comments. The parser cannot ignore them without proper escaping.

Bad:
Calculate 7 * 8

Good:
Calculate 7 \* 8

The plan is to make brainfuck be able to read and write to more than one io target that is std. It should be able to read and write to disk, tcp or http connections or any other byte writable stream. This part is still an ongoing process.