brain-rot 0.1

Python based Brainrot language'.

BrainRot - Custom Python Syntax Extension

BrainRot is a Python-based language extension that allows you to use brainrot instead of def for defining functions. It also enables importing and executing .brainrot files as if they were regular Python modules.

Features

• Define functions using brainrot instead of def.
• Import .brainrot files directly into Python.
• Automatically transpiles BrainRot code into valid Python.
• Installable via pip from GitHub.

---

Installation

To install BrainRot from GitHub, run:

pip install git+https://github.com/Shane-Develops/Brainrot.git

---

Usage

1. Create a .brainrot File

Create a file called example.brainrot and define a function using brainrot:

brainrot sigma():
    rizz("That's a very sigma code!")

sigma()

2. Import and Execute

Save the file in the same directory as your Python script. Then, in a Python script, import the .brainrot file like a normal module:

import brain_rot
import example  # Automatically converts and executes example.brainrot

When executed, this will print:

Hello from BrainRot!

---

How It Works

• The BrainRot import system finds .brainrot files and processes them.
• It replaces brainrot with def, making the code valid Python.
• The modified code is then compiled and executed seamlessly.

---

Project Structure

brain_rot/
│── brain_rot/
│   │── __init__.py
│   │── brain_rot_importer.py
│── examples/
│   │── example.brainrot
│── setup.py
│── README.md
│── .gitignore

---

Contributing

Feel free to contribute by submitting issues or pull requests on GitHub!

---

License

This project is licensed under the MIT License.