lean4-htt/Lake/Build.lean

356 lines
13 KiB
Text
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/-
Copyright (c) 2017 Microsoft Corporation. All rights reserved.
Released under Apache 2.0 license as described in the file LICENSE.
Authors: Gabriel Ebner, Sebastian Ullrich, Mac Malone
-/
import Lean.Data.Name
import Lean.Elab.Import
import Lake.BuildTarget
import Lake.Resolve
import Lake.Package
import Lake.Compile
open System
open Lean hiding SearchPath
namespace Lake
-- # Build Targets
abbrev FileTarget := MTimeBuildTarget FilePath
namespace FileTarget
def mk (file : FilePath) (maxMTime : IO.FS.SystemTime) (task : BuildTask) :=
BuildTarget.mk file maxMTime task
def pure (file : FilePath) (maxMTime : IO.FS.SystemTime) :=
BuildTarget.pure file maxMTime
end FileTarget
structure LeanArtifact where
oleanFile : FilePath
cFile : FilePath
deriving Inhabited
protected def LeanArtifact.getMTime (self : LeanArtifact) : IO MTime := do
return max (← getMTime self.oleanFile) (← getMTime self.cFile)
instance : GetMTime LeanArtifact := ⟨LeanArtifact.getMTime⟩
abbrev LeanTarget := MTimeBuildTarget LeanArtifact
namespace LeanTarget
def mk (olean c : FilePath) (maxMTime : IO.FS.SystemTime) (task : BuildTask) : LeanTarget :=
BuildTarget.mk ⟨olean, c⟩ maxMTime task
def pure (olean c : FilePath) (maxMTime : IO.FS.SystemTime) : LeanTarget :=
BuildTarget.pure ⟨olean, c⟩ maxMTime
def oleanFile (self : LeanTarget) := self.artifact.oleanFile
def oleanTarget (self : LeanTarget) : FileTarget :=
{self with artifact := self.oleanFile}
def cFile (self : LeanTarget) := self.artifact.cFile
def cTarget (self : LeanTarget) : FileTarget :=
{self with artifact := self.cFile}
end LeanTarget
abbrev PackageTarget := MTimeBuildTarget (Package × NameMap LeanTarget)
namespace PackageTarget
def package (self : PackageTarget) := self.artifact.1
def moduleTargets (self : PackageTarget) : NameMap LeanTarget :=
self.artifact.2
end PackageTarget
-- # Build Components
def catchErrors (action : IO PUnit) : IO PUnit := do
try action catch e =>
-- print compile errors early
IO.eprintln e
throw e
def skipIfNewer [GetMTime a]
(artifact : a) (depMTime : MTime)
{m} [Monad m] [MonadLiftT IO m] [MonadExceptOf IO.Error m]
(build : m BuildTask) : m (MTimeBuildTarget a) := do
-- construct a nop target if we have an up-to-date file
try
if (← getMTime artifact) >= depMTime then
return MTimeBuildTarget.pure artifact depMTime
catch
| IO.Error.noFileOrDirectory .. => pure ()
| e => throw e
-- otherwise construct a proper target
return MTimeBuildTarget.mk artifact depMTime (← build)
def buildO (oFile : FilePath)
(cTarget : FileTarget) (leancArgs : Array String := #[]) : IO BuildTask :=
BuildTask.afterTarget cTarget <| catchErrors <|
compileO oFile cTarget.artifact leancArgs
def fetchOFileTarget (oFile : FilePath)
(cTarget : FileTarget) (leancArgs : Array String := #[]) : IO FileTarget :=
-- construct a nop target if we have an up-to-date .o
skipIfNewer oFile cTarget.mtime <| buildO oFile cTarget leancArgs
-- # Topological Builder
open Std
/-- A recursive object fetcher. -/
def RecFetch.{u,v,w} (k : Type u) (o : Type v) (m : Type v → Type w) :=
k → (k → m o) → m o
/-- A exception plus state monad transformer (i.e., `StateT` + `ExceptT`). -/
abbrev EStateT (ε σ m) :=
StateT σ <| ExceptT ε m
def EStateT.run (state : σ) (self : EStateT ε σ m α) : m (Except ε (α × σ)) :=
StateT.run self state |>.run
def EStateT.run' [Monad m] (state : σ) (self : EStateT ε σ m α) : m (Except ε α) :=
StateT.run' self state |>.run
/--
Monad transformer for an RBMap-based topological walk.
If a cycle is detected, the list keys traversed is thrown.
-/
abbrev RBTopT.{u,v} (k : Type u) (o : Type u) (cmp) (m : Type u → Type v) :=
EStateT (List k) (RBMap k o cmp) m
/-- Auxiliary function for `buildRBTop`. -/
partial def buildRBTopCore
{k o} {cmp} {m : Type u → Type u} [BEq k] [Inhabited o] [Monad m]
(parents : List k) (fetch : RecFetch k o (RBTopT k o cmp m))
(key : k) : RBTopT k o cmp m o := do
-- detect cyclic builds
if parents.contains key then
throw <| key :: (parents.partition (· != key)).1 ++ [key]
-- return previous output if already built
if let some output := (← get).find? key then
return output
-- build the key recursively
let output ← fetch key (buildRBTopCore (key :: parents) fetch)
-- save the output (to prevent repeated builds of the same key)
modify (·.insert key output)
return output
/--
Recursively constructs an `RBMao` of key-object pairs by
fetching objects topologically (i.e., via a deep-first search with
memoization). Called a suspending scheduler in "Build systems à la carte".
-/
def buildRBTop {k o} {cmp} {m} [BEq k] [Inhabited o] [Monad m]
(fetch : RecFetch k o (RBTopT k o cmp m)) (key : k) : RBTopT k o cmp m o :=
buildRBTopCore [] fetch key
-- # Build Modules
def parseDirectLocalImports (root : Name) (leanFile : FilePath) : IO (List Name) := do
let contents ← IO.FS.readFile leanFile
let (imports, _, _) ← Elab.parseImports contents leanFile.toString
imports.map (·.module) |>.filter (·.getRoot == root)
/-
Produces a recursive module target fetcher that
builds the target module after waiting for `depsTarget` and
its direct local imports (relative to `pkg`) to build.
The module is built with the configuration from `pkg` and
a `LEAN_PATH` that includes `oleanDirs`.
-/
def fetchAfterDirectLocalImports
(pkg : Package) (oleanDirs : List FilePath) (depsTarget : MTimeBuildTarget PUnit)
{m} [Monad m] [MonadLiftT IO m] [MonadExceptOf IO.Error m] : RecFetch Name LeanTarget m :=
let leanPath := SearchPath.toString <| pkg.oleanDir :: oleanDirs
fun mod fetch => do
let leanFile := pkg.modToSource mod
let imports ← parseDirectLocalImports pkg.module leanFile
-- calculate max dependency `MTime`
let leanMTime ← getMTime leanFile
let importMTimes ← imports.mapM fun i => getMTime <| pkg.modToSource i
let depMTime := MTime.listMax <| leanMTime :: depsTarget.mtime :: importMTimes
-- construct target
let cFile := pkg.modToC mod
let oleanFile := pkg.modToOlean mod
-- we fetch the import targets even if a rebuild is not required
-- because other build processes (ex. `.o`) rely on the map being complete
let importTasks ← imports.mapM fun i => fetch i >>= (·.buildTask)
skipIfNewer ⟨oleanFile, cFile⟩ depMTime <|
BuildTask.afterTasks (depsTarget.buildTask :: importTasks) <| catchErrors <|
compileOleanAndC leanFile oleanFile cFile leanPath pkg.dir pkg.leanArgs
/-
Equivalent to `RBTopT (cmp := Name.quickCmp) Name LeanTarget IO`.
Phrased this way to use `NameMap`.
-/
abbrev LeanTargetM :=
EStateT (List Name) (NameMap LeanTarget) IO
abbrev LeanTargetFetch :=
RecFetch Name LeanTarget LeanTargetM
abbrev RecLeanTargetM :=
ReaderT (RecFetch Name LeanTarget LeanTargetM) LeanTargetM
def throwOnCycle (mx : IO (Except (List Name) α)) : IO α :=
mx >>= fun
| Except.ok a => a
| Except.error cycle =>
let cycle := cycle.map (s!" {·}")
throw <| IO.userError s!"import cycle detected:\n{"\n".intercalate cycle}"
def Package.buildModuleTargetDAG
(oleanDirs : List FilePath) (depsTarget : MTimeBuildTarget PUnit)
(self : Package) : IO (LeanTarget × NameMap LeanTarget) := do
let fetch := fetchAfterDirectLocalImports self oleanDirs depsTarget
throwOnCycle <| buildRBTop fetch self.module |>.run {}
def Package.buildModuleTargets
(mods : List Name) (oleanDirs : List FilePath)
(depsTarget : MTimeBuildTarget PUnit) (self : Package)
: IO (List LeanTarget) := do
let fetch : LeanTargetFetch :=
fetchAfterDirectLocalImports self oleanDirs depsTarget
throwOnCycle <| mods.mapM (buildRBTop fetch) |>.run' {}
-- # Configure/Build Packages
def Package.buildTargetWithDepTargets
(depTargets : List PackageTarget) (self : Package)
: IO PackageTarget := do
let depsTarget ← MTimeBuildTarget.all depTargets
let depOLeanDirs := depTargets.map (·.package.oleanDir)
let (target, targetMap) ← self.buildModuleTargetDAG depOLeanDirs depsTarget
return {target with artifact := ⟨self, targetMap⟩}
partial def Package.buildTarget (self : Package) : IO PackageTarget := do
let deps ← solveDeps self
-- build dependencies recursively
-- TODO: share build of common dependencies
let depTargets ← deps.mapM (·.buildTarget)
self.buildTargetWithDepTargets depTargets
def Package.buildDepTargets (self : Package) : IO (List PackageTarget) := do
let deps ← solveDeps self
deps.mapM (·.buildTarget)
def Package.buildDeps (self : Package) : IO (List Package) := do
let deps ← solveDeps self
let targets ← deps.mapM (·.buildTarget)
try targets.forM (·.materialize) catch e =>
-- actual error has already been printed within the task
throw <| IO.userError "Build failed."
return deps
def configure (pkg : Package) : IO Unit :=
discard pkg.buildDeps
def Package.build (self : Package) : IO PUnit := do
let target ← self.buildTarget
try target.materialize catch _ =>
-- actual error has already been printed within the task
throw <| IO.userError "Build failed."
def build (pkg : Package) : IO PUnit :=
pkg.build
-- # Print Paths
def Package.buildModuleTargetsWithDeps
(deps : List Package) (mods : List Name) (self : Package)
: IO (List LeanTarget) := do
let oleanDirs := deps.map (·.oleanDir)
let depsTarget ← MTimeBuildTarget.all (← deps.mapM (·.buildTarget))
self.buildModuleTargets mods oleanDirs depsTarget
def Package.buildModulesWithDeps
(deps : List Package) (mods : List Name) (self : Package)
: IO PUnit := do
let targets ← self.buildModuleTargetsWithDeps deps mods
try targets.forM (·.materialize) catch e =>
-- actual error has already been printed within target
throw <| IO.userError "Build failed."
def printPaths (pkg : Package) (imports : List String := []) : IO Unit := do
let deps ← solveDeps pkg
unless imports.isEmpty do
let imports := imports.map (·.toName)
let localImports := imports.filter (·.getRoot == pkg.module)
pkg.buildModulesWithDeps deps localImports
IO.println <| SearchPath.toString <| pkg.oleanDir :: deps.map (·.oleanDir)
IO.println <| SearchPath.toString <| pkg.sourceDir :: deps.map (·.sourceDir)
-- # Build Package Lib
def PackageTarget.fetchOFileTargets
(self : PackageTarget) : IO (List FileTarget) := do
self.moduleTargets.toList.mapM fun (mod, target) => do
let oFile := self.package.modToO mod
fetchOFileTarget oFile target.cTarget self.package.leancArgs
def PackageTarget.buildStaticLib
(self : PackageTarget) : IO BuildTask := do
let oFileTargets ← self.fetchOFileTargets
let oFiles := oFileTargets.map (·.artifact) |>.toArray
BuildTask.afterTargets oFileTargets <| catchErrors <|
compileStaticLib self.package.staticLibFile oFiles
def PackageTarget.fetchStaticLibTarget
(self : PackageTarget) : IO FileTarget := do
-- construct a nop target if we have an up-to-date lib
skipIfNewer self.package.staticLibFile self.mtime self.buildStaticLib
def Package.fetchStaticLibTarget (self : Package) : IO FileTarget := do
let target ← self.buildTarget
target.fetchStaticLibTarget
def Package.fetchStaticLib (self : Package) : IO FilePath := do
let target ← self.fetchStaticLibTarget
try target.materialize catch _ =>
-- actual error has already been printed within the task
throw <| IO.userError "Build failed."
return target.artifact
def buildLib (pkg : Package) : IO PUnit :=
discard pkg.fetchStaticLib
-- # Build Package Bin
def PackageTarget.buildBin
(depTargets : List PackageTarget) (self : PackageTarget)
: IO BuildTask := do
let oFileTargets ← self.fetchOFileTargets
let oFiles := oFileTargets.map (·.artifact) |>.toArray
let libTargets ← depTargets.mapM (·.fetchStaticLibTarget)
let libFiles := libTargets.map (·.artifact) |>.toArray
BuildTask.afterTargets (oFileTargets ++ libTargets) <| catchErrors <|
compileBin self.package.binFile (oFiles ++ libFiles) self.package.linkArgs
def PackageTarget.fetchBinTarget
(depTargets : List PackageTarget) (self : PackageTarget) : IO FileTarget :=
-- construct a nop target if we have an up-to-date bin
skipIfNewer self.package.binFile self.mtime <| self.buildBin depTargets
def Package.fetchBinTarget (self : Package) : IO FileTarget := do
let depTargets ← self.buildDepTargets
let pkgTarget ← self.buildTargetWithDepTargets depTargets
pkgTarget.fetchBinTarget depTargets
def Package.fetchBin (self : Package) : IO FilePath := do
let target ← self.fetchBinTarget
try target.materialize catch _ =>
-- actual error has already been printed within the task
throw <| IO.userError "Build failed."
return target.artifact
def buildBin (pkg : Package) : IO PUnit :=
discard pkg.fetchBin