danaugrs / create-your-own-lang-with-rust

Create your own programming language with Rust (WIP)

Create your own programming language with Rust

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

Why am I writing this book?

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" ²

Requirements

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 v10.0 (Debian/Ubuntu or macOS)
   • Otherwise, in Cargo.toml you'd need to change the inkwell = { ..., branch = "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.

Roadmap

Checkout the roadmap to the 1st edition.

Donation

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