Loaf

February 24, 2025 · View on GitHub

Build your Crumb programs as standalone binaries 🍞.

What is this?

Loaf is a Crumb program, that compiles other Crumb programs into standalone binaries. This is done by injecting the the source of your crumb programs into the Crumb interpreter's source code, compiling your scripts with the Crumb runtime.

Install

You do not need to clone this repo to use Crumb/Loaf. Instead, follow the instructions in this template repo. Only clone this repo if you are working on Loaf itself.

Getting Started

Crumb is built for POSIX compliant systems, and utilizes ioctl.h and unistd.h. To use Crumb on windows, either use WSL, or use a Linux container.

First, build crumb.

chmod +x setup.sh && ./setup.sh

You can now try to run Loaf on itself, bootstrapping it's own binary.

./crumb ./loaf.crumb ./loaf.crumb ./loaf

This will create a loaf binary you can invoke from anywhere, on any crumb program.

./loaf ENTRY_POINT.crumb OUTPUT_BINARY_PATH

To bundle app.crumb,

./loaf app.crumb app

To bootstrap Loaf again, you can run

./loaf ./loaf.crumb ./loaf2

You can also control the version of Crumb to use.

./loaf ENTRY_POINT.crumb OUTPUT_BINARY_PATH TAG

Loaf will recursively traverse any directory it is run from, and make any file that ends with .crumb available to the use function.

Crumb

Built for and with the Crumb Programming language: https://github.com/liam-ilan/crumb.

Author