Documentation

Lean.ImportingFlag

@[export lean_enable_initializer_execution]

By default the initialize code is not executed when importing .olean files. When this flag is set to true, the initializers are executed. This method is meant to be used by the Lean frontend only.

Remark: it is not safe to run initialize code when using multiple threads. Remark: Any loaded native Lean code must match its imported version. In particular, no two versions of the same module may be loaded when this flag is set. No native code may be loaded after its module has been imported. Remark: The Lean frontend executes this method at startup time.

Equations
def Lean.withImporting {α : Type} (x : IO α) :
IO α

Excute x with "importing" flag turned on. When the "importing" flag is set to true, we allow user-extensions defined with with the initialize command to update global references.

IMPORTANT: There is no semaphore controlling the access to these global references. We assume these global references are updated by a single execution thread. This is true in the Lean frontend where we process the import commands at the beginning of the execution only. Users must make sure that importModules is used, there is only one execution thread accessing the global references.

Equations