bfrun

Brainfuck CLI Interpreter

NodeJS Brainfuck and Brainfuck ♭ console interpreter

Install and use

Prerequisites

1. NodeJS

Install

1. npm i -g bfrun

Use

Command	Properties	Description
start <file>	--verbose	Runs brainfuck file
debug <file>	--verbose	Debug brainfuck project, add * to add a debug breakpoint
test <spec file> <to eval file>		Unit test a brainfuck file with brainfuck, compare the memory result
help		Help from the CLI

Brainfuck Flat (BFF / B♭)

BFF is a Brainfuck derivative inspired by Brainfuck++, it expands standard Brainfuck in two ways:

1. Having two different memory arrays
   a. The register array has a fixed 16 cells
   b. The standard memory has a dynamic length, it doubles everytime the memory pointer moves past its length
2. Adds this commands:

Command	Specification
^	Swaps between memory strip and registers strip.
#	Reads filename until a null byte is reached, input buffer will now be said file, pointer returns to original cell. If file doesn't exists the program will exit.
:	Reads filename until a null byte is reached, dumps all non-zero memory except filename in said file. If file doesn't exists the program will exit.
::	Reads filename until a null byte is reached, writes file with no content, if a file already existis it will replace it.

Unit testing

Now you can unit test a brainfuck file with another brainfuck file! To use it first create a new brainfuck file, preferably name it like the file you want to test with a _spec after the name and with extension .bf. Inside the file start with the input to test and finish the input with a !, everything before the exclamation mark will be read as input for the evaluated BF.

Insert in memory the final memory dump you expect on the evaluated file. Example: This an example of addition of a + 2 sum_spec.bf

3!
++++++++++++++++++++++++++++++++++++++++++++++++++++

sum.bf

,>++[<+>-]

Then run the command bfrun test sum_spec.bf sum.bf

(If you want header comments on your spec file add it after the exclamation mark)