Cranefuck

🚧 PROTOTYPE – NOT PRODUCTION READY! 🚧
(But let's be honest: Brainfuck is never ready for production.)

Cranefuck is a high-performance Just-In-Time (JIT) Brainfuck runtime powered by Cranelift. Designed with speed, simplicity, and elegance in mind, this project is the brainchild of a single developer.

Features

• 🚀 High-Speed JIT Compilation powered by Cranelift
• 🧩 Minimalist Design for maximum efficiency
• 🖥️ Cross-Platform Compatibility (currently tested on Windows)
• 📦 Lightweight Dependencies without sacrificing performance
• 🛠️ Optimized Execution Pipeline for running Brainfuck programs

Installation

Via Cargo

Install directly from GitHub:

cargo install --git https://github.com/skyne98/cranefuck

Building from Source

Clone the repository and build the release version:

git clone https://github.com/skyne98/cranefuck.git
cd cranefuck
cargo build --release

Usage

Running a Brainfuck File

Execute a Brainfuck program from a file:

cranefuck --file examples/hello.bf

Running from Standard Input

Pipe Brainfuck code directly into Cranefuck:

echo "+[----->+++<]>++." | cranefuck

Running interpreter mode

Disable JIT compilation and run in interpreter mode:

cranefuck --file examples/hello.bf --mode "interpreter"

Contributing

🚨 FEEDBACK WANTED! 🚨

As a solo developer, I welcome you guys to turn this project into a fun community playground for performant brainfuck! Please share your feedback and submit PRs! GitHub.

License

This project is distributed under the MIT License.

---

Made with ❤️ by skyne98