biir 1.1.0

Brainfuck Interpreter In Rust
Documentation

BIIR - Brainfuck Interpreter In Rust

Installation

cargo install biir

Usage

biir filename.bf

Numerical mode

Available through -nor --numerical-mode. Prints byte values instead of their ascii representations.

Debug mode

Entered via -d or--debug-mode. Allows the usage of !TAPE to print 10 nearby (already created) cells and also prints some debug info at the end of the execution.

Notes

  • !TAPE can be put at any point in the program, but will only do anything when running in debug mode.

  • Every , (comma) will take input the same way as getchar in C. It's also possible to provide it externally using pipes, however it will exit once the whole input was consumed.

  • (note to point above) Keep in mind that by default echo passes \n as last character. This behaviour can be avoided by using its -n flag.

TODO:

  • write a proper README
  • clap - argument parsing
  • parse files,
  • -d debug mode, prints tape at the end, enables the use of !TAPE to print 10 nearest values on the tape at any point of the program
  • -n numerical mode, prints values themselves instead of interpreting them as ascii.
  • write tests
  • configure gitlab ci to run tests automatically
  • add a CI badge to README