Build your Crumb programs as standalone binaries 🍞.

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.

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.

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.

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

• Built by Liam Ilan