The delaborator is the first stage of the pretty printer, and the inverse of the elaborator: it turns fully elaborated Expr core terms back into surface-level Syntax, omitting some implicit information again and using higher-level syntax abstractions like notations where possible. The exact behavior can be customized using pretty printer options; activating pp.all should guarantee that the delaborator is injective and that re-elaborating the resulting Syntax round-trips.

Pretty printer options can be given not only for the whole term, but also specific subterms. This is used both when automatically refining pp options until round-trip and when interactively selecting pp options for a subterm (both TBD). The association of options to subterms is done by assigning a unique, synthetic Nat position to each subterm derived from its position in the full term. This position is added to the corresponding Syntax object so that elaboration errors and interactions with the pretty printer output can be traced back to the subterm.

The delaborator is extensible via the [delab] attribute.

structure Lean.PrettyPrinter.Delaborator.Context : Type

• optionsPerPos : Lean.PrettyPrinter.Delaborator.OptionsPerPos
• currNamespace : Lake.Name
• openDecls : List Lean.OpenDecl
• inPattern : Bool
• subExpr : Lean.SubExpr

structure Lean.PrettyPrinter.Delaborator.State : Type

• infos : Lean.SubExpr.PosMap Lean.Elab.Info

  We attach Elab.Info at various locations in the Syntax output in order to convey its semantics. While the elaborator emits InfoTrees, here we have no real text location tree to traverse, so we use a flattened map.

• holeIter : Lean.PrettyPrinter.Delaborator.SubExpr.HoleIterator

  See SubExpr.nextExtraPos.

opaque Lean.PrettyPrinter.Delaborator.delabFailureId : Lean.InternalExceptionId

@[inline, reducible]

abbrev Lean.PrettyPrinter.Delaborator.DelabM (α : Type) : Type

@[inline, reducible]

abbrev Lean.PrettyPrinter.Delaborator.Delab : Type

instance Lean.PrettyPrinter.Delaborator.instInhabitedDelabM {α : Type} : Inhabited (Lean.PrettyPrinter.Delaborator.DelabM α)

@[inline]

def Lean.PrettyPrinter.Delaborator.orElse {α : Type} (d₁ : Lean.PrettyPrinter.Delaborator.DelabM α) (d₂ : Unit → Lean.PrettyPrinter.Delaborator.DelabM α) : Lean.PrettyPrinter.Delaborator.DelabM α

def Lean.PrettyPrinter.Delaborator.failure {α : Type} : Lean.PrettyPrinter.Delaborator.DelabM α

instance Lean.PrettyPrinter.Delaborator.instAlternativeDelabM : Alternative Lean.PrettyPrinter.Delaborator.DelabM

instance Lean.PrettyPrinter.Delaborator.instOrElseDelabM {α : Type} : OrElse (Lean.PrettyPrinter.Delaborator.DelabM α)

instance Lean.PrettyPrinter.Delaborator.instMonadReaderOfSubExprDelabM : MonadReaderOf Lean.SubExpr Lean.PrettyPrinter.Delaborator.DelabM

instance Lean.PrettyPrinter.Delaborator.instMonadWithReaderOfSubExprDelabM : MonadWithReaderOf Lean.SubExpr Lean.PrettyPrinter.Delaborator.DelabM

instance Lean.PrettyPrinter.Delaborator.instMonadStateOfHoleIteratorDelabM : MonadStateOf Lean.PrettyPrinter.Delaborator.SubExpr.HoleIterator Lean.PrettyPrinter.Delaborator.DelabM

instance Lean.PrettyPrinter.Delaborator.instMonadQuotationDelabM : Lean.MonadQuotation Lean.PrettyPrinter.Delaborator.DelabM

unsafe def Lean.PrettyPrinter.Delaborator.mkDelabAttribute : IO (Lean.KeyedDeclsAttribute Lean.PrettyPrinter.Delaborator.Delab)

opaque Lean.PrettyPrinter.Delaborator.delabAttribute : Lean.KeyedDeclsAttribute Lean.PrettyPrinter.Delaborator.Delab

def Lean.PrettyPrinter.Delaborator.getExprKind : Lean.PrettyPrinter.Delaborator.DelabM Lake.Name

def Lean.PrettyPrinter.Delaborator.getOptionsAtCurrPos : Lean.PrettyPrinter.Delaborator.DelabM Lean.Options

def Lean.PrettyPrinter.Delaborator.getPPOption (opt : Lean.Options → Bool) : Lean.PrettyPrinter.Delaborator.DelabM Bool

Evaluate option accessor, using subterm-specific options if set.

def Lean.PrettyPrinter.Delaborator.whenPPOption (opt : Lean.Options → Bool) (d : Lean.PrettyPrinter.Delaborator.Delab) : Lean.PrettyPrinter.Delaborator.Delab

def Lean.PrettyPrinter.Delaborator.whenNotPPOption (opt : Lean.Options → Bool) (d : Lean.PrettyPrinter.Delaborator.Delab) : Lean.PrettyPrinter.Delaborator.Delab

def Lean.PrettyPrinter.Delaborator.withOptionAtCurrPos {α : Type} (k : Lake.Name) (v : Lean.DataValue) (x : Lean.PrettyPrinter.Delaborator.DelabM α) : Lean.PrettyPrinter.Delaborator.DelabM α

Set the given option at the current position and execute x in this context.

def Lean.PrettyPrinter.Delaborator.annotatePos (pos : Lean.SubExpr.Pos) (stx : Lean.Term) : Lean.Term

def Lean.PrettyPrinter.Delaborator.annotateCurPos (stx : Lean.Term) : Lean.PrettyPrinter.Delaborator.Delab

def Lean.PrettyPrinter.Delaborator.getUnusedName (suggestion : Lake.Name) (body : Lean.Expr) : Lean.PrettyPrinter.Delaborator.DelabM Lake.Name

def Lean.PrettyPrinter.Delaborator.getUnusedName.bodyUsesSuggestion (body : Lean.Expr) (lctx : Lean.LocalContext) (suggestion' : Lake.Name) : Bool

def Lean.PrettyPrinter.Delaborator.withBindingBodyUnusedName {α : Type} (d : Lean.Syntax → Lean.PrettyPrinter.Delaborator.DelabM α) : Lean.PrettyPrinter.Delaborator.DelabM α

@[inline]

def Lean.PrettyPrinter.Delaborator.liftMetaM {α : Type} (x : Lean.MetaM α) : Lean.PrettyPrinter.Delaborator.DelabM α

def Lean.PrettyPrinter.Delaborator.addTermInfo (pos : Lean.SubExpr.Pos) (stx : Lean.Syntax) (e : Lean.Expr) (isBinder : optParam Bool false) : Lean.PrettyPrinter.Delaborator.DelabM Unit

def Lean.PrettyPrinter.Delaborator.addTermInfo.mkTermInfo (stx : Lean.Syntax) (e : Lean.Expr) (isBinder : optParam Bool false) : Lean.PrettyPrinter.Delaborator.DelabM Lean.Elab.Info

def Lean.PrettyPrinter.Delaborator.addFieldInfo (pos : Lean.SubExpr.Pos) (projName : Lake.Name) (fieldName : Lake.Name) (stx : Lean.Syntax) (val : Lean.Expr) : Lean.PrettyPrinter.Delaborator.DelabM Unit

def Lean.PrettyPrinter.Delaborator.addFieldInfo.mkFieldInfo (projName : Lake.Name) (fieldName : Lake.Name) (stx : Lean.Syntax) (val : Lean.Expr) : Lean.PrettyPrinter.Delaborator.DelabM Lean.Elab.Info

def Lean.PrettyPrinter.Delaborator.annotateTermInfo (stx : Lean.Term) : Lean.PrettyPrinter.Delaborator.Delab

partial def Lean.PrettyPrinter.Delaborator.delabFor : Lake.Name → Lean.PrettyPrinter.Delaborator.Delab

partial def Lean.PrettyPrinter.Delaborator.delab : Lean.PrettyPrinter.Delaborator.Delab

unsafe def Lean.PrettyPrinter.Delaborator.mkAppUnexpanderAttribute : IO (Lean.KeyedDeclsAttribute Lean.PrettyPrinter.Unexpander)

opaque Lean.PrettyPrinter.Delaborator.appUnexpanderAttribute : Lean.KeyedDeclsAttribute Lean.PrettyPrinter.Unexpander

def Lean.PrettyPrinter.delabCore (e : Lean.Expr) (optionsPerPos : optParam Lean.PrettyPrinter.Delaborator.OptionsPerPos ∅) (delab : optParam Lean.PrettyPrinter.Delaborator.Delab Lean.PrettyPrinter.Delaborator.delab) : Lean.MetaM (Lean.Term × Lean.SubExpr.PosMap Lean.Elab.Info)

def Lean.PrettyPrinter.delab (e : Lean.Expr) (optionsPerPos : optParam Lean.PrettyPrinter.Delaborator.OptionsPerPos ∅) : Lean.MetaM Lean.Term

"Delaborate" the given term into surface-level syntax using the default and given subterm-specific options.