Overview

Brainrot is an esoteric programming language derived from Brain****. Bipy is a Brainrot interpreter written in Python (hence the name bipy). All writing here assumes you have a rudamentary understanding of Brainrot's parent language (i.e., you skimmed the Wikipedia article).

Symbol	Definition
>	Move one cell to the right.
<	Move one cell to the left.
+	Add one to the current cell.
-	Subtract one from the current cell.
,	Read a byte from the standard input stream to the current cel.
.	Write the current cell to the standard input stream.
[	If the current cell is zero, go to the matching ] symbol.
]	If the current cell is non-zero, go to the matching [ symbol.
(	Define a macro. The "name" of the macro is the current cell's value.
)	End a macro definition.
!	Apply the macro where the name is the current cell's value.
#	Display debug info (to stderr).

• Brainrot's cells are all exactly one octet, i.e., an eight-bit unsigned integer. For this reason, addition and subtraction are both defined modulo 256.
• The tape begins at cell 0 and goes until at least cell 2^16. Moving below cell 0 or above the maximum cell results in a syntax error.
• If any of the following symbols are unmatched, a syntax error occurs: [, ], (, ).
• The file extension on Brainrot source code is typically '.br'. A '.bf' extension implies the code is compatible with Brainrot's parent language.
• All non-symbol input characters are ignored.

Usage

To run bipy with an input file:

$ python bipy ./examples/hello_world.bf
Hello World!

To run bipy's REPL:

$ python bipy
Welcome to bipy: a Brainrot Interpreter in Python
[bipy]