{"id":13608188,"url":"https://github.com/ehsanmok/create-your-own-lang-with-rust","last_synced_at":"2025-05-16T18:06:55.242Z","repository":{"id":39991956,"uuid":"270167613","full_name":"ehsanmok/create-your-own-lang-with-rust","owner":"ehsanmok","description":"Create your own programming language with Rust","archived":false,"fork":false,"pushed_at":"2024-07-26T23:22:17.000Z","size":1476,"stargazers_count":779,"open_issues_count":5,"forks_count":44,"subscribers_count":35,"default_branch":"master","last_synced_at":"2025-05-10T04:52:00.907Z","etag":null,"topics":["book","compiler","compiler-design","language-design","programming-language","rust-lang","teaching-materials"],"latest_commit_sha":null,"homepage":"https://createlang.rs","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ehsanmok.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-06-07T02:27:00.000Z","updated_at":"2025-05-08T18:13:20.000Z","dependencies_parsed_at":"2024-01-14T07:04:57.024Z","dependency_job_id":"f33006dc-7320-4042-afc7-6e8a3d82d872","html_url":"https://github.com/ehsanmok/create-your-own-lang-with-rust","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehsanmok%2Fcreate-your-own-lang-with-rust","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehsanmok%2Fcreate-your-own-lang-with-rust/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehsanmok%2Fcreate-your-own-lang-with-rust/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehsanmok%2Fcreate-your-own-lang-with-rust/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ehsanmok","download_url":"https://codeload.github.com/ehsanmok/create-your-own-lang-with-rust/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254582905,"owners_count":22095518,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["book","compiler","compiler-design","language-design","programming-language","rust-lang","teaching-materials"],"created_at":"2024-08-01T19:01:24.960Z","updated_at":"2025-05-16T18:06:55.224Z","avatar_url":"https://github.com/ehsanmok.png","language":"Rust","funding_links":[],"categories":["Rust","Summary","\u003ca name=\"Rust\"\u003e\u003c/a\u003eRust"],"sub_categories":[],"readme":"# Create your own programming language with Rust\n\n![Github Pages](https://github.com/ehsanmok/create-your-own-lang-with-rust/workflows/Github%20Pages/badge.svg?branch=master)\n![CI](https://github.com/ehsanmok/create-your-own-lang-with-rust/workflows/CI/badge.svg?branch=master)\n\nThis repository contains the codes and the contents for [createlang.rs](https://createlang.rs)\n\n## Why am I writing this book?\n\nThe 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.\n\nThe following are my guidelines\n\n\u003e \"If you don't know how *compilers* work, then you don't know how computers work\" \u003csup\u003e[1](http://steve-yegge.blogspot.com/2007/06/rich-programmer-food.html?)\u003c/sup\u003e\n\n\n\u003e \"If you can’t explain something in simple terms, you don’t understand it\" \u003csup\u003e[2](https://skeptics.stackexchange.com/questions/8742/did-einstein-say-if-you-cant-explain-it-simply-you-dont-understand-it-well-en)\u003c/sup\u003e\n\n## Requirements\n\nMake sure you have\n\n1. [Rust toolchain installed](https://www.rust-lang.org/tools/install)\n2. Cloned this repository (follow the instructions in each chapter)\n3. LLVM installed to run and test locally `cargo test --tests`\n    * Easiest option is LLVM v14.0 ([Debian/Ubuntu](https://apt.llvm.org/) or [macOS](https://formulae.brew.sh/formula/llvm))\n    * 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`)\n\n\nTo build the book locally, navigate to the `book` subdirectory and follow the instructions in [mdbook](https://github.com/rust-lang/mdBook).\n\n## Roadmap\n\nCheckout the [roadmap to the 1st edition](https://github.com/ehsanmok/create-your-own-lang-with-rust/projects).\n\n## Donation\n\nIf you have found this project useful, please consider donating to any of the organizations below\n\n* [Child Foundation](https://mycf.childfoundation.org/s/donate)\n* [Black Lives Matter](https://blacklivesmatter.com/)\n* [Food Bank of Canada](https://www.foodbankscanada.ca/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fehsanmok%2Fcreate-your-own-lang-with-rust","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fehsanmok%2Fcreate-your-own-lang-with-rust","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fehsanmok%2Fcreate-your-own-lang-with-rust/lists"}