structure Lean.TagAttributeExtra : Type

• ext : Lean.PersistentEnvExtension Lean.Name Lean.Name Lean.NameSet

  The environment extension for the attribute.

• base : Lean.NameHashSet

  A list of "base" declarations which have been pre-tagged.

TagAttributeExtra works around a limitation of TagAttribute, which is that definitions must be tagged in the same file that declares the definition. This works well for definitions in lean core, but for attributes declared outside the core this is problematic because we may want to tag declarations created before the attribute was defined.

To resolve this, we allow a one-time exception to the rule that attributes must be applied in the same file as the declaration: During the declaration of the attribute itself, we can tag arbitrary other definitions, but once the attribute is declared we must tag things in the same file as normal.

instance Lean.instInhabitedTagAttributeExtra : Inhabited Lean.TagAttributeExtra

def Lean.registerTagAttributeExtra (name : Lean.Name) (descr : String) (extra : List Lean.Name) (validate : optParam (Lean.Name → Lean.AttrM Unit) fun x => pure ()) (ref : autoParam Lean.Name _auto✝) : IO Lean.TagAttributeExtra

Registers a new tag attribute. The extra field is a list of definitions from other modules which will be "pre-tagged" and are not subject to the usual restriction on tagging in the same file as the declaration.

Note: The extra fields bypass the validate function - we assume the builtins are also pre-validated.

def Lean.TagAttributeExtra.hasTag (attr : Lean.TagAttributeExtra) (env : Lean.Environment) (decl : Lean.Name) : Bool

Does declaration decl have the tag attr?

def Lean.TagAttributeExtra.getDecls (attr : Lean.TagAttributeExtra) (env : Lean.Environment) : Array Lean.Name

Get the list of declarations tagged with the tag attribute attr.

structure Lean.ParametricAttributeExtra (α : Type) : Type

• attr : Lean.ParametricAttribute α

  The underlying ParametricAttribute.

• base : Lean.HashMap Lean.Name α

  A list of pre-tagged declarations with their values.

ParametricAttributeExtra works around a limitation of ParametricAttribute, which is that definitions must be tagged in the same file that declares the definition. This works well for definitions in lean core, but for attributes declared outside the core this is problematic because we may want to tag declarations created before the attribute was defined.

To resolve this, we allow a one-time exception to the rule that attributes must be applied in the same file as the declaration: During the declaration of the attribute itself, we can tag arbitrary other definitions, but once the attribute is declared we must tag things in the same file as normal.

instance Lean.instInhabitedParametricAttributeExtra : {a : Type} → Inhabited (Lean.ParametricAttributeExtra a)

def Lean.registerParametricAttributeExtra {α : Type} [Inhabited α] (impl : Lean.ParametricAttributeImpl α) (extra : List (Lean.Name × α)) : IO (Lean.ParametricAttributeExtra α)

Registers a new parametric attribute. The extra field is a list of definitions from other modules which will be "pre-tagged" and are not subject to the usual restriction on tagging in the same file as the declaration.

def Lean.ParametricAttributeExtra.getParam? {α : Type} [Inhabited α] (attr : Lean.ParametricAttributeExtra α) (env : Lean.Environment) (decl : Lean.Name) : Option α

Gets the parameter of attribute attr associated to declaration decl, or none if decl is not tagged.

def Lean.ParametricAttributeExtra.setParam {α : Type} (attr : Lean.ParametricAttributeExtra α) (env : Lean.Environment) (decl : Lean.Name) (param : α) : Except String Lean.Environment

Applies attribute attr to declaration decl, given a value for the parameter.