Hacking on Gruel

Reference material for contributors working on the compiler itself. For language usage (rather than compiler internals), start with Learn Gruel.

Specification

• Gruel Language Specification — the normative definition of the language

Library crates

API documentation generated by rustdoc for each library crate in the workspace.

• gruel-air — Typed IR produced by semantic analysis
• gruel-builtins — Built-in type definitions (String, Vec, etc.)
• gruel-cfg — Control flow graph construction and optimization
• gruel-codegen-llvm — LLVM-based code generation
• gruel-compiler — Compiler pipeline orchestration
• gruel-error — Error types and compiler diagnostics
• gruel-lexer — Tokenization of Gruel source code
• gruel-parser — AST construction from token stream
• gruel-rir — Untyped IR (post-parse, pre-semantic analysis)
• gruel-span — Source location tracking
• gruel-target — Target platform configuration