This repository contains the codes and the contents for createlang.rs

The book arises from my frustration of not finding modern, clear and concise teaching materials that are readily accessible to beginners like me who wants to learn a bit on how to create their own programming language.

The following are my guidelines

"If you don't know how compilers work, then you don't know how computers work" ¹

"If you can’t explain something in simple terms, you don’t understand it" ²

Make sure you have

1. Rust toolchain installed
2. Cloned this repository (follow the instructions in each chapter)
3. LLVM installed to run and test locally cargo test --tests
   • Easiest option is LLVM v14.0 (Debian/Ubuntu or macOS)
   • Otherwise, in Cargo.toml you'd need to change the inkwell = { ..., branch = "master", features = ["your-llvm-version"] } with LLVM version on your system (output of llvm-config --version)

To build the book locally, navigate to the book subdirectory and follow the instructions in mdbook.

Checkout the roadmap to the 1st edition.

If you have found this project useful, please consider donating to any of the organizations below

• Child Foundation
• Black Lives Matter
• Food Bank of Canada