Brainrot Programming Language

Brainrot is a meme-inspired programming language that translates common programming keywords into internet slang and meme references. It's built using Flex (lexical analyzer) and Bison (parser generator), making it a fun way to learn about language processing and compiler design.

History

The TRUE history behind the Brainrot programming language can be found here.

🤔 What is Brainrot?

Brainrot is a C-like programming language where traditional keywords are replaced with popular internet slang. For example:

• void → skibidi
• int → rizz
• for → flex
• return → bussin

📋 Requirements

To build and run the Brainrot compiler, you'll need:

• GCC (GNU Compiler Collection)
• Flex (Fast Lexical Analyzer)
• Bison (Parser Generator)

Installation on Different Platforms

Ubuntu/Debian

sudo apt-get update
sudo apt-get install gcc flex bison libfl-dev

Arch Linux

sudo pacman -S gcc flex bison

macOS (using Homebrew)

brew install gcc flex bison

Some macOS users are experiencing an error related to libfl. First, check if libfl is installed at:

/opt/homebrew/lib/libfl.dylib  # For Apple Silicon
/usr/local/lib/libfl.dylib  # For Intel Macs

And if not, you have to find it and symlink to it. Find it using:

find /opt/homebrew -name "libfl.*"  # For Apple Silicon
find /usr/local -name "libfl.*"  # For Intel Macs

And link it with:

sudo ln -s /path/to/libfl.dylib /opt/homebrew/lib/libfl.dylib  # For Apple Silicon
sudo ln -s /path/to/libfl.dylib /usr/local/lib/libfl.dylib  # For Intel Macs

🚀 Building the Compiler

1. Clone this repository:

git clone https://github.com/Brainrotlang/brainrot.git
cd brainrot

2. Generate the parser and lexer:

bison -d -Wcounterexamples lang.y -o lang.tab.c
flex -o lang.lex.c lang.l

3. Compile the compiler:

make

NOTE: The gcc version we use to test is v13 if you get any warnings remove -Werror flag from the Makefile

Installation

sudo make install

Uninstall

sudo make uninstall

💻 Usage

1. Create a Brainrot source file (e.g., hello.brainrot):

 skibidi main {
    yapping("Hello, World!");
    bussin 0;
}

2. Run your Brainrot program:

./brainrot hello.brainrot

Check out the examples:

• Hello world
• Fizz Buzz
• Bubble Sort
• One-dimensional Heat Equation Solver
• Fibonacci Sequence

🗪 Community

Join our community on:

• Discord
• Reddit

📚 Language Reference

Keywords

Brainrot	C Equivalent	Implemented?
skibidi	void	✅
rizz	int	✅
cap	bool	✅
cooked	auto	❌
flex	for	✅
bussin	return	✅
edgy	if	✅
amogus	else	✅
goon	while	✅
bruh	break	✅
grind	continue	✅
chad	float	✅
gigachad	double	✅
yap	char	✅
deadass	const	✅
sigma rule	case	✅
based	default	✅
mewing	do	✅
gyatt	enum	❌
whopper	extern	❌
cringe	goto	❌
giga	long	❌
smol	short	✅
nut	signed	✅
maxxing	sizeof	✅
salty	static	❌
gang	struct	❌
ohio	switch	✅
chungus	union	❌
nonut	unsigned	✅
schizo	volatile	✅
W	true	✅
L	false	✅
thicc	long long	❌
rant	string type	✅
lit	typedef	❌

Builtin functions

Check the user documentation.

Operators

The language supports basic arithmetic operators:

• + Addition
• - Subtraction
• * Multiplication
• / Division
• = Assignment
• < Less than
• > Greater than
• && Logical AND
• || Logical OR

⚠️ Limitations

Current limitations include:

• Limited support for complex expressions
• Basic error reporting
• No support for arrays in user-defined functions
• No support for pointers

🔌 VSCode Extension

Brainrot has a Visual Studio Code extension to enhance your development experience with syntax highlighting and support for the Brainrot programming language. You can find it here:

Brainrot VSCode Extension

🤝 Contributing

Feel free to contribute to this project by:

1. Forking the repository
2. Creating a new branch for your feature
3. Submitting a pull request

📝 License

This project is licensed under the GPL License - see the LICENSE file for details.

🙏 Acknowledgments

• This project is created for educational purposes
• Inspired by meme culture and internet slang
• Built using Flex and Bison tools

🐛 Issues

Please report any additional issues in the GitHub Issues section.