seandewar / brainfuck.nvim

Run Brainfuck programs in Neovim

brainfuck.nvim

Run Brainfuck programs in Neovim.

Install using your favourite package manager, then execute :source <filename>, where <filename> uses the .b, .bf or .brainfuck extensions.

Alternatively, :BrainfuckSource can be used, which also allows you to source from the current buffer (:help :ranges are supported), among other things. Examples:

" Source lines 1-3 from the current buffer.
:1,3BrainfuckSource

" Source file.bf (equivalent to `:source file.bf`).
:BrainfuckSource file.bf

" Source file.bf and also show timing information.
:BrainfuckSource! file.bf

" Source file.bf and set the memory available to the VM to 100 bytes.
" Default is 30KB. The VM's cursor wraps around if it goes out-of-bounds.
:BrainfuckSource file.bf memory_size=100

" Source file.bf without compiling it, interpreting the code instead.
" By default, sourced brainfuck programs are compiled to Lua programs, which
" typically run faster than using the interpreter.
:BrainfuckSource file.bf compile=false

" Transpile file.bf to Lua without running it. Open the result in a new buffer.
:BrainfuckSource file.bf compile=false transpile=true

" Source file.bf, but show the output in a floating terminal window.
" Programs executed this way are non-blocking, and can handle control codes
" outputted by programs properly.
"
" The program will be interpreted, as running compiled brainfuck programs in a
" terminal buffer is not yet supported.
:BrainfuckSource file.bf terminal=true

Brainfuck programs can be killed by pressing <C-c>, except for those running in a terminal window (those can be killed by simply using :quit).

Additionally, Brainfuck code can be sourced directly using :Brainfuck. Example:

:Brainfuck +++++++[>++++++++++<-]>++.+.

Where can I find some Brainfuck programs?

Daniel Cristofani's website has quite a few.

Why did you make this?

🤷

Also, I like making silly Neovim plugins.