Module Facet Builds

Build function definitions for a module's builtin facets.

@[deprecated "Deprecated without replacement" (since := "2025-03-28")]

def Lake.recBuildExternDynlibs (pkgs : Array Package) : FetchM (Array (Job Dynlib) × Array System.FilePath)

Compute library directories and build external library Jobs of the given packages.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.recFetchInput (mod : Module) : FetchM (Job ModuleInput)

Parse the header of a Lean file from its source.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.inputFacetConfig : ModuleFacetConfig inputFacet

The ModuleFacetConfig for the builtin inputFacet.

Equations

• Lake.Module.inputFacetConfig = Lake.mkFacetJobConfig Lake.Module.recFetchInput

def Lake.Module.leanFacetConfig : ModuleFacetConfig leanFacet

The ModuleFacetConfig for the builtin leanFacet.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.headerFacetConfig : ModuleFacetConfig headerFacet

The ModuleFacetConfig for the builtin headerFacet.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.recParseImports (mod : Module) : FetchM (Job (Array Module))

Compute an Array of a module's direct local imports from its header.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.importsFacetConfig : ModuleFacetConfig importsFacet

The ModuleFacetConfig for the builtin importsFacet.

Equations

• Lake.Module.importsFacetConfig = Lake.mkFacetJobConfig Lake.Module.recParseImports false

structure Lake.ModuleImportData : Type

• module : Module
• transImports : Job (Array Module)
• includeSelf : Bool

@[inline]

def Lake.collectImportsAux (leanFile : System.FilePath) (imports : Array Module) (f : Module → FetchM (Bool × Job (Array Module))) : FetchM (Job (Array Module))

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.recComputeTransImports (mod : Module) : FetchM (Job (Array Module))

Recursively compute a module's transitive imports.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.transImportsFacetConfig : ModuleFacetConfig transImportsFacet

The ModuleFacetConfig for the builtin transImportsFacet.

Equations

• Lake.Module.transImportsFacetConfig = Lake.mkFacetJobConfig Lake.Module.recComputeTransImports false

def Lake.computePrecompileImportsAux (leanFile : System.FilePath) (imports : Array Module) : FetchM (Job (Array Module))

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.recComputePrecompileImports (mod : Module) : FetchM (Job (Array Module))

Recursively compute a module's precompiled imports.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.precompileImportsFacetConfig : ModuleFacetConfig precompileImportsFacet

The ModuleFacetConfig for the builtin precompileImportsFacet.

Equations

• Lake.Module.precompileImportsFacetConfig = Lake.mkFacetJobConfig Lake.Module.recComputePrecompileImports false

def Lake.fetchImportLibs (mods : Array Module) : FetchM (Job (Array Dynlib))

For internal use.

Fetches the library dynlibs of a list of non-local imports. Modules are loaded as part of their whole library.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.recFetchSetup (mod : Module) : FetchM (Job Lean.ModuleSetup)

Recursively build a module's dependencies, including:

• Transitive local imports
• Shared libraries (e.g., extern_lib targets or precompiled modules)
• extraDepTargets of its library

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.setupFacetConfig : ModuleFacetConfig setupFacet

The ModuleFacetConfig for the builtin setupFacet.

Equations

• Lake.Module.setupFacetConfig = Lake.mkFacetJobConfig Lake.Module.recFetchSetup

def Lake.Module.depsFacetConfig : ModuleFacetConfig depsFacet

The ModuleFacetConfig for the builtin depsFacet.

Equations

• Lake.Module.depsFacetConfig = Lake.mkFacetJobConfig fun (mod : Lake.Module) => (fun (x : Lake.Job Lean.ModuleSetup) => x.toOpaque) <$> mod.setup.fetch

def Lake.Module.clearOutputHashes (mod : Module) : IO PUnit

Remove any cached file hashes of the module build outputs (in .hash files).

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.cacheOutputHashes (mod : Module) : IO PUnit

Cache the file hashes of the module build outputs in .hash files.

Equations

• One or more equations did not get rendered due to their size.

@[inline]

def Lake.ModuleOutputHashes.getArtifacts? {m : Type → Type u_1} [MonadLakeEnv m] [MonadLiftT BaseIO m] [Monad m] (hashes : ModuleOutputHashes) : m (Option ModuleOutputArtifacts)

Equations

• hashes.getArtifacts? = do let __do_lift ← Lake.getLakeCache liftM (Lake.ModuleOutputHashes.getArtifactsFrom?✝ __do_lift hashes)

instance Lake.instResolveArtifactsModuleOutputHashesModuleOutputArtifactsOfMonadLakeEnvOfMonadLiftTBaseIOOfMonad {m : Type → Type u_1} [MonadLakeEnv m] [MonadLiftT BaseIO m] [Monad m] : ResolveArtifacts m ModuleOutputHashes ModuleOutputArtifacts

Equations

• Lake.instResolveArtifactsModuleOutputHashesModuleOutputArtifactsOfMonadLakeEnvOfMonadLiftTBaseIOOfMonad = { resolveArtifacts? := Lake.ModuleOutputHashes.getArtifacts? }

def Lake.Module.recBuildLean (mod : Module) : FetchM (Job ModuleOutputArtifacts)

Recursively build a Lean module. Fetch its dependencies and then elaborate the Lean source file, producing all possible artifacts (e.g., .olean, .ilean, .c, .bc).

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.leanArtsFacetConfig : ModuleFacetConfig leanArtsFacet

The ModuleFacetConfig for the builtin leanArtsFacet.

Equations

• Lake.Module.leanArtsFacetConfig = Lake.mkFacetJobConfig Lake.Module.recBuildLean

def Lake.Module.oleanFacetConfig : ModuleFacetConfig oleanFacet

The ModuleFacetConfig for the builtin oleanFacet.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.oleanServerFacetConfig : ModuleFacetConfig oleanServerFacet

The ModuleFacetConfig for the builtin oleanServerFacet.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.oleanPrivateFacetConfig : ModuleFacetConfig oleanPrivateFacet

The ModuleFacetConfig for the builtin oleanPrivateFacet.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.ileanFacetConfig : ModuleFacetConfig ileanFacet

The ModuleFacetConfig for the builtin ileanFacet.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.cFacetConfig : ModuleFacetConfig cFacet

The ModuleFacetConfig for the builtin cFacet.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.bcFacetConfig : ModuleFacetConfig bcFacet

The ModuleFacetConfig for the builtin bcFacet.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.recBuildLeanCToOExport (self : Module) : FetchM (Job System.FilePath)

Recursively build the module's object file from its C file produced by lean with -DLEAN_EXPORTING set, which exports Lean symbols defined within the C files.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.coExportFacetConfig : ModuleFacetConfig coExportFacet

The ModuleFacetConfig for the builtin coExportFacet.

Equations

• Lake.Module.coExportFacetConfig = Lake.mkFacetJobConfig Lake.Module.recBuildLeanCToOExport

def Lake.Module.recBuildLeanCToONoExport (self : Module) : FetchM (Job System.FilePath)

Recursively build the module's object file from its C file produced by lean. This version does not export any Lean symbols.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.coNoExportFacetConfig : ModuleFacetConfig coNoExportFacet

The ModuleFacetConfig for the builtin coNoExportFacet.

Equations

• Lake.Module.coNoExportFacetConfig = Lake.mkFacetJobConfig Lake.Module.recBuildLeanCToONoExport

def Lake.Module.coFacetConfig : ModuleFacetConfig coFacet

The ModuleFacetConfig for the builtin coFacet.

Equations

• Lake.Module.coFacetConfig = Lake.mkFacetJobConfig (fun (mod : Lake.Module) => if System.Platform.isWindows = true then mod.coNoExport.fetch else mod.coExport.fetch) true false

def Lake.Module.recBuildLeanBcToO (self : Module) : FetchM (Job System.FilePath)

Recursively build the module's object file from its bitcode file produced by lean.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.bcoFacetConfig : ModuleFacetConfig bcoFacet

The ModuleFacetConfig for the builtin bcoFacet.

Equations

• Lake.Module.bcoFacetConfig = Lake.mkFacetJobConfig Lake.Module.recBuildLeanBcToO

def Lake.Module.oExportFacetConfig : ModuleFacetConfig oExportFacet

The ModuleFacetConfig for the builtin oExportFacet.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.oNoExportFacetConfig : ModuleFacetConfig oNoExportFacet

The ModuleFacetConfig for the builtin oNoExportFacet.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.oFacetConfig : ModuleFacetConfig oFacet

The ModuleFacetConfig for the builtin oFacet.

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.recBuildDynlib (mod : Module) : FetchM (Job Dynlib)

Recursively build the shared library of a module (e.g., for --load-dynlib or --plugin).

Equations

• One or more equations did not get rendered due to their size.

def Lake.Module.dynlibFacetConfig : ModuleFacetConfig dynlibFacet

The ModuleFacetConfig for the builtin dynlibFacet.

Equations

• Lake.Module.dynlibFacetConfig = Lake.mkFacetJobConfig Lake.Module.recBuildDynlib

def Lake.Module.initFacetConfigs : DNameMap ModuleFacetConfig

A name-configuration map for the initial set of Lake module facets (e.g., imports, c, o, dynlib).

Equations

• One or more equations did not get rendered due to their size.

@[reducible, inline]

abbrev Lake.initModuleFacetConfigs : DNameMap ModuleFacetConfig

A name-configuration map for the initial set of Lake module facets (e.g., imports, c, o, dynlib).

Equations

• Lake.initModuleFacetConfigs = Lake.Module.initFacetConfigs

Definitions to support lake setup-file builds.

def Lake.buildImportsAndDeps (leanFile : System.FilePath) (imports : Array Lean.Import) : FetchM (Job ModuleDeps)

Builds an Array of module imports for a Lean file. Used by lake setup-file to build modules for the Lean server and by lake lean to build the imports of a file. Returns the dynlibs and plugins built (so they can be loaded by Lean).

Equations

• One or more equations did not get rendered due to their size.