Documentation

Lean.PrettyPrinter.Delaborator.Builtins

If cond is true, wraps the syntax produced by d in a type ascription.

Instances For

    Wraps the identifier (or identifier with explicit universe levels) with @ if pp.analysis.blockImplicit is set to true.

    Instances For

      Delaborator for const expressions. This is not registered as a delaborator, as const is not an expression kind (see [delab] description and Lean.PrettyPrinter.Delaborator.getExprKind). Rather, it is called through the app delaborator.

      Instances For

        If pp.tagAppFns is set, and if the current expression is a constant application, then d is evaluated with the head constant delaborated with delabConst as the ref.

        Instances For

          A structure that records details of a function parameter.

          • name : Name

            Binder name for the parameter.

          • bInfo : BinderInfo

            Binder info for the parameter.

          • defVal : Option Expr

            The default value for the parameter, if the parameter has a default value.

          • isAutoParam : Bool

            Whether the parameter is an autoparam (i.e., whether it uses a tactic for the default value).

          Instances For

            Returns true if the parameter is an explicit parameter that has neither a default value nor a tactic.

            Instances For

              Given a function f supplied with arguments args, returns an array whose n-th element is set to the kind of the n-th argument's associated parameter. We do not assume the expression mkAppN f args is sensical, and this function captures errors (except for panics) and returns the empty array in that case.

              The returned array might be longer than the number of arguments. It gives parameter kinds for the fully-applied function. Note: the defVal expressions are only guaranteed to be valid for parameters associated to the supplied arguments; after this, they might refer to temporary fvars.

              This function properly handles "overapplied" functions. For example, while id takes one explicit argument, it can take more than one explicit argument when its arguments are specialized to function types, like in id id 2.

              Instances For

                If e is an application that is a candidate for using field notation, returns the parameter index and the field name to use. Checks that there are enough arguments.

                Instances For

                  In explicit mode, decides whether or not the applied function needs @, where numArgs is the number of arguments actually supplied to f.

                  Instances For
                    def Lean.PrettyPrinter.Delaborator.delabAppExplicitCore (fieldNotation : Bool) (numArgs : Nat) (delabHead : BoolDelab) (paramKinds : Array ParamKind) :

                    Delaborates a function application in explicit mode.

                    • If insertExplicit is true, then ensures the head syntax is wrapped with @.
                    • If fieldNotation is true, then allows the application to be pretty printed using field notation. Field notation will not be used when insertExplicit is true.
                    Instances For

                      Records how a particular argument to a function is delaborated, in non-explicit mode.

                      • skip : AppImplicitArg

                        An argument to skip, like an implicit argument.

                      • regular (s : Term) : AppImplicitArg

                        A regular argument.

                      • optional (name : Name) (s : Term) : AppImplicitArg

                        A regular argument that, if it comes as the last argument, may be omitted.

                      • named (s : TSyntax `Lean.Parser.Term.namedArgument) : AppImplicitArg

                        It's a named argument. Named arguments inhibit applying unexpanders.

                      Instances For

                        Whether unexpanding is allowed with this argument.

                        Instances For

                          If the argument has associated syntax, returns it.

                          Instances For
                            def Lean.PrettyPrinter.Delaborator.delabAppImplicitCore (unexpand : Bool) (numArgs : Nat) (delabHead : Delab) (paramKinds : Array ParamKind) :

                            Delaborates a function application in the standard mode, where implicit arguments are generally not included, unless pp.analysis.namedArg is set at that argument.

                            This delaborator is where app_unexpanders and the structure instance unexpander are applied, if unexpand is true. When unexpand is true, also considers opportunities for field notation, which takes priority over other unexpanders.

                            Assumes numArgs ≤ paramKinds.size.

                            Instances For

                              Returns true if an application should use explicit mode when delaborating. Explicit mode turns off unexpanders

                              Instances For
                                def Lean.PrettyPrinter.Delaborator.delabAppCore (maxArgs : Nat) (delabHead : BoolDelab) (unexpand : Bool) :

                                Delaborates applications. Removes up to maxArgs arguments to form the "head" of the application.

                                • delabHead is a delaborator to use for the head of the expression. It is passed whether the result needs to have @ inserted.
                                • If unexpand is true, then allow unexpanders and field notation. This should likely be set to false except in the main delabApp delaborator.

                                Propagates pp.tagAppFns into the head for delabHead.

                                Instances For

                                  Default delaborator for applications.

                                  Instances For

                                    The withOverApp combinator allows delaborators to handle "over-application" by using the core application delaborator to handle additional arguments.

                                    For example, suppose f : {A : Type} → Foo A → A and we want to implement a delaborator for applications f x to pretty print as F[x]. Because A is a type variable we might encounter a term of the form @f (A → B) x y, which has an additional argument y. With this combinator one can use an arity-2 delaborator to pretty print this as F[x] y.

                                    • arity: the expected number of arguments to f. The combinator will fail if fewer than this number of arguments are passed, and if more than this number of arguments are passed the arguments are handled using the standard application delaborator.
                                    • x: delaborates the head application of the expected arity (f x in the example). The value of pp.tagAppFns for the whole application is propagated to the expression that x sees.

                                    In the event of overapplication, the delaborator x is wrapped in Lean.PrettyPrinter.Delaborator.withAnnotateTermInfo to register TermInfo for the resulting term. The effect of this is that the term is hoverable in the Infoview.

                                    If the application would require inserting @ around the result of x, the delaborator fails since we cannot be sure that this insertion will be well-formed.

                                    Instances For

                                      Delaborate structure constructor applications using structure instance notation or anonymous constructor notation.

                                      Instances For

                                        State for delabAppMatch and helpers.

                                        • matcherTy : SubExpr

                                          The matcherTy instantiated with universe levels and the matcher parameters, with a position at the type of this application prefix.

                                        • motive : Option (Term × Expr)

                                          The motive, with the pi type version delaborated and the original expression version. Once AppMatchState is complete, this is not none.

                                        • motiveNamed : Bool

                                          Whether pp.analysis.namedArg was set for the motive argument.

                                        • discrs : Array Term

                                          The delaborated discriminants, without h : annotations.

                                        • hNames? : Array (Option Name)

                                          The collection of names used for the h : discriminant annotations, in order. Uniquified names are constructed after the first phase.

                                        • alts : Array SubExpr

                                          Lambda subexpressions for each alternate.

                                        • varNames : Array (Array Name)

                                          For each match alternative, the names to use for the pattern variables. Each ends with hNames?.filterMap id exactly.

                                        • rhss : Array Term

                                          The delaborated right-hand sides for each match alternative.

                                        Instances For

                                          Delaborates applications of "matchers" such as

                                          List.map.match_1 : {α : Type _} →
                                            (motive : List α → Sort _) →
                                              (x : List α) → (Unit → motive List.nil) → ((a : α) → (as : List α) → motive (a :: as)) → motive x
                                          
                                          Instances For

                                            Core function that delaborates a natural number (an OfNat.ofNat literal).

                                            Instances For

                                              Core function that delaborates a negative integer literal (a Neg.neg applied to OfNat.ofNat).

                                              Instances For

                                                Core function that delaborates a rational literal that is the division of an integer literal by a natural number literal. The division must be homogeneous for it to count as a rational literal.

                                                Instances For

                                                  Delaborates an OfNat.ofNat literal. @OfNat.ofNat _ n _ ~> n.

                                                  Instances For

                                                    Delaborates the negative of an OfNat.ofNat literal. -@OfNat.ofNat _ n _ ~> -n

                                                    Instances For

                                                      Delaborates a rational number literal. @OfNat.ofNat _ n _ / @OfNat.ofNat _ m > n / m and -@OfNat.ofNat _ n _ / @OfNat.ofNat _ m > -n / m

                                                      Instances For

                                                        Delaborate a projection primitive. These do not usually occur in user code, but are pretty-printed when e.g. #printing a projection function.

                                                        Instances For

                                                          This delaborator tries to elide functions which are known coercions. For example, Int.ofNat is a coercion, so instead of printing ofNat n we just print ↑n, and when re-parsing this we can (usually) recover the specific coercion being used.

                                                          Instances For

                                                            Delaborates a function application of the form f ... x (fun _ : Unit => y).

                                                            Instances For
                                                              def Lean.PrettyPrinter.Delaborator.delabForallParamsWithSignature {α : Type} (delabForall : TSyntaxArray `Lean.Parser.Term.bracketedBinderTermDelabM α) :

                                                              Pretty-prints the parameters of a forall. The pretty-printed parameters are passed to delabForall at the end.

                                                              Instances For

                                                                Pretty-prints a forall similarly to delabForall, but explicitly denotes all named parameters.

                                                                Instances For

                                                                  Pretty-prints a constant c as c.{<levels>} <params> : <type>.

                                                                  If universes is false, then the universe level parameters are omitted.

                                                                  Instances For