blazefuck

A blazingly-fast (interactive) Brainfuck interpreter, written in Rust.

Description

A tiny, efficient Brainfuck interpreter, with a REPL for easy, on-the-fly evaluation

Brainfuck is a simple esoteric language with a minimal subset of commands, you can read more here.

Getting Started

Dependencies

• Install the rustup toolchain for your system.

Installing

• Add Cargo's binary directory to your path environment variables
  The rustup installer should do this for you, but if not, it should be located at ~/.cargo/bin (Linux) or %USERPROFILE\.cargo\bin (Windows).
• Simply run cargo install blazefuck at a terminal and it'll be installed from crates.io.

Executing program

• Type blazefuck at a prompt

$ blazefuck
blazefuck 1.0.0 on windows, run with "-h" or "--help" for more information.
Use "cells" to show the cell stack and "exit" to exit the interpreter.
>>> _

Also cells and exit will show the current cell stack and exit the REPL, respectively.

• Alternatively a source file can be specified with blazefuck [FILE], some examples can be found here.

$ blazefuck hello.bf
Hello World!

$ _

• Some flags can be specified as follows:

-d, --debug     Shows the cell stack after every command
-s, --strict    Activates strict mode

• Strict mode has some key differences, as opposed to normal mode, some programs will not run well with it enabled.
  It:
  • Disallows access of any cells not between #1 and #30000, normal mode wraps around to the beginning or end.
  • Disallows cell data being incremented or decremented past 0-255, normal mode also wraps around.
    
    

Building from source

• Clone this repository

$ git clone https://github.com/poopsicles/blazefuck

• Switch to the newly created directory

$ cd ./blazefuck

• Compile using cargo

$ cargo build

• Cargo will grab the required dependencies and create the binary at ./target/debug/blazefuck
  
  

Version History

• 1.0
  • Initial release
    
    

License

This project is licensed under the MIT License, more details here.