A Lean 4 Metaprogramming Book

Authors: Arthur Paulino, Damiano Testa, Edward Ayers, Evgenia Karunus, Henrik Böving, Jannis Limperg, Siddhartha Gadgil, Siddharth Bhat

A PDF is available here for download (and is rebuilt on each change).

• Main
  1. Introduction
  2. Overview
  3. Expressions
  4. MetaM
  5. Syntax
  6. Macros
  7. Elaboration
  8. DSLs
  9. Tactics
  10. Cheat sheet
• Extra
  1. Options
  2. Attributes
  3. Pretty Printing
• Solutions to exercises
  1. ...
  2. Expressions
  3. MetaM
  4. Syntax
  5. ...
  6. Elaboration

Sources to extract material from:

• Material written by Ed

Contributing

The markdown files are generated automatically via lean2md. Thus, if you're going to write or fix content for the book, please do so in the original Lean files inside the lean directory.

Important: since lean2md is so simple, please avoid using comment sections in Lean code blocks with /- ... -/. If you want to insert commentaries, do so with double dashes --.

Building the markdown files

This is not required, but if you want to build the markdown files, you can do so by running lake run build. It requires having Python installed, as well as the lean2md package.

Or, if you have viper installed and a linked environment that has lean2md, you can call lake run viper_build.