structure Lake.Workspace : Type

A Lake workspace -- the top-level package directory.

• root : Lake.Package

  The root package of the workspace.

• lakeEnv : Lake.Env

  The detected Lake.Env of the workspace.

• lakeArgs? : Option (Array String)

  The CLI arguments Lake was run with. Used by lake update to perform a restart of Lake on a toolchain update. A value of none means that Lake is not restartable via the CLI.

• packages : Array Lake.Package

  The packages within the workspace (in require declaration order).

• packageMap : Lake.DNameMap Lake.NPackage

  Name-package map of packages within the workspace.

• moduleFacetConfigs : Lake.DNameMap Lake.ModuleFacetConfig

  Name-configuration map of module facets defined in the workspace.

• packageFacetConfigs : Lake.DNameMap Lake.PackageFacetConfig

  Name-configuration map of package facets defined in the workspace.

• libraryFacetConfigs : Lake.DNameMap Lake.LibraryFacetConfig

  Name-configuration map of library facets defined in the workspace.

instance Lake.instNonemptyWorkspace : Nonempty Lake.Workspace

Equations

• Lake.instNonemptyWorkspace = ⋯

unsafe def Lake.OpaqueWorkspace.unsafeMk : Lake.Workspace → Lake.OpaqueWorkspace

unsafe def Lake.OpaqueWorkspace.unsafeGet : Lake.OpaqueWorkspace → Lake.Workspace

@[implemented_by Lake.OpaqueWorkspace.unsafeGet]

opaque Lake.OpaqueWorkspace.get : Lake.OpaqueWorkspace → Lake.Workspace

instance Lake.OpaqueWorkspace.instCoeWorkspace_1 : Coe Lake.OpaqueWorkspace Lake.Workspace

Equations

• Lake.OpaqueWorkspace.instCoeWorkspace_1 = { coe := Lake.OpaqueWorkspace.get }

instance Lake.OpaqueWorkspace.instCoeWorkspace : Coe Lake.Workspace Lake.OpaqueWorkspace

Equations

• Lake.OpaqueWorkspace.instCoeWorkspace = { coe := Lake.OpaqueWorkspace.mk }

@[implemented_by Lake.OpaqueWorkspace.unsafeMk]

opaque Lake.OpaqueWorkspace.mk : Lake.Workspace → Lake.OpaqueWorkspace

instance Lake.OpaqueWorkspace.instInhabitedOfWorkspace [Inhabited Lake.Workspace] : Inhabited Lake.OpaqueWorkspace

Equations

• Lake.OpaqueWorkspace.instInhabitedOfWorkspace = { default := Lake.OpaqueWorkspace.mk default }

@[inline]

def Lake.Workspace.dir (self : Lake.Workspace) : System.FilePath

The path to the workspace's directory (i.e., the directory of the root package).

Equations

• self.dir = self.root.dir

@[inline]

def Lake.Workspace.config (self : Lake.Workspace) : Lake.WorkspaceConfig

The workspace's configuration.

Equations

• self.config = self.root.config.toWorkspaceConfig

@[inline]

def Lake.Workspace.relLakeDir (self : Lake.Workspace) : System.FilePath

The path to the workspace' Lake directory relative to dir.

Equations

• self.relLakeDir = self.root.relLakeDir

@[inline]

def Lake.Workspace.lakeDir (self : Lake.Workspace) : System.FilePath

The full path to the workspace's Lake directory (e.g., .lake).

Equations

• self.lakeDir = self.root.lakeDir

@[inline]

def Lake.Workspace.relPkgsDir (self : Lake.Workspace) : System.FilePath

The path to the workspace's remote packages directory relative to dir.

Equations

• self.relPkgsDir = self.root.relPkgsDir

@[inline]

def Lake.Workspace.pkgsDir (self : Lake.Workspace) : System.FilePath

The workspace's dir joined with its relPkgsDir.

Equations

• self.pkgsDir = self.root.pkgsDir

@[inline]

def Lake.Workspace.manifestFile (self : Lake.Workspace) : System.FilePath

The workspace's Lake manifest.

Equations

• self.manifestFile = self.root.manifestFile

def Lake.Workspace.addPackage (pkg : Lake.Package) (self : Lake.Workspace) : Lake.Workspace

Add a package to the workspace.

Equations

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

@[inline]

def Lake.Workspace.findPackage? (name : Lean.Name) (self : Lake.Workspace) : Option (Lake.NPackage name)

Try to find a package within the workspace with the given name.

Equations

• Lake.Workspace.findPackage? name self = Lake.DRBMap.find? self.packageMap name

def Lake.Workspace.findScript? (script : Lean.Name) (self : Lake.Workspace) : Option Lake.Script

Try to find a script in the workspace with the given name.

Equations

• Lake.Workspace.findScript? script self = self.packages.findSome? fun (x : Lake.Package) => x.scripts.find? script

def Lake.Workspace.isLocalModule (mod : Lean.Name) (self : Lake.Workspace) : Bool

Check if the module is local to any package in the workspace.

Equations

• Lake.Workspace.isLocalModule mod self = self.packages.any fun (pkg : Lake.Package) => Lake.Package.isLocalModule mod pkg

def Lake.Workspace.isBuildableModule (mod : Lean.Name) (self : Lake.Workspace) : Bool

Check if the module is buildable by any package in the workspace.

Equations

• Lake.Workspace.isBuildableModule mod self = self.packages.any fun (pkg : Lake.Package) => Lake.Package.isBuildableModule mod pkg

def Lake.Workspace.findModule? (mod : Lean.Name) (self : Lake.Workspace) : Option Lake.Module

Locate the named, buildable, importable, local module in the workspace.

Equations

• Lake.Workspace.findModule? mod self = self.packages.findSome? fun (x : Lake.Package) => Lake.Package.findModule? mod x

def Lake.Workspace.findTargetModule? (mod : Lean.Name) (self : Lake.Workspace) : Option Lake.Module

Locate the named, buildable, but not necessarily importable, module in the workspace.

Equations

• Lake.Workspace.findTargetModule? mod self = self.packages.findSome? fun (x : Lake.Package) => Lake.Package.findTargetModule? mod x

def Lake.Workspace.findLeanLib? (name : Lean.Name) (self : Lake.Workspace) : Option Lake.LeanLib

Try to find a Lean library in the workspace with the given name.

Equations

• Lake.Workspace.findLeanLib? name self = self.packages.findSome? fun (pkg : Lake.Package) => Lake.Package.findLeanLib? name pkg

def Lake.Workspace.findLeanExe? (name : Lean.Name) (self : Lake.Workspace) : Option Lake.LeanExe

Try to find a Lean executable in the workspace with the given name.

Equations

• Lake.Workspace.findLeanExe? name self = self.packages.findSome? fun (pkg : Lake.Package) => Lake.Package.findLeanExe? name pkg

def Lake.Workspace.findExternLib? (name : Lean.Name) (self : Lake.Workspace) : Option Lake.ExternLib

Try to find an external library in the workspace with the given name.

Equations

• Lake.Workspace.findExternLib? name self = self.packages.findSome? fun (pkg : Lake.Package) => Lake.Package.findExternLib? name pkg

def Lake.Workspace.findTargetConfig? (name : Lean.Name) (self : Lake.Workspace) : Option ((pkg : Lake.Package) × Lake.TargetConfig pkg.name name)

Try to find a target configuration in the workspace with the given name.

Equations

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

def Lake.Workspace.addModuleFacetConfig {name : Lean.Name} (cfg : Lake.ModuleFacetConfig name) (self : Lake.Workspace) : Lake.Workspace

Add a module facet to the workspace.

Equations

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

def Lake.Workspace.findModuleFacetConfig? (name : Lean.Name) (self : Lake.Workspace) : Option (Lake.ModuleFacetConfig name)

Try to find a module facet configuration in the workspace with the given name.

Equations

• Lake.Workspace.findModuleFacetConfig? name self = Lake.DRBMap.find? self.moduleFacetConfigs name

def Lake.Workspace.addPackageFacetConfig {name : Lean.Name} (cfg : Lake.PackageFacetConfig name) (self : Lake.Workspace) : Lake.Workspace

Add a package facet to the workspace.

Equations

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

def Lake.Workspace.findPackageFacetConfig? (name : Lean.Name) (self : Lake.Workspace) : Option (Lake.PackageFacetConfig name)

Try to find a package facet configuration in the workspace with the given name.

Equations

• Lake.Workspace.findPackageFacetConfig? name self = Lake.DRBMap.find? self.packageFacetConfigs name

def Lake.Workspace.addLibraryFacetConfig {name : Lean.Name} (cfg : Lake.LibraryFacetConfig name) (self : Lake.Workspace) : Lake.Workspace

Add a library facet to the workspace.

Equations

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

def Lake.Workspace.findLibraryFacetConfig? (name : Lean.Name) (self : Lake.Workspace) : Option (Lake.LibraryFacetConfig name)

Try to find a library facet configuration in the workspace with the given name.

Equations

• Lake.Workspace.findLibraryFacetConfig? name self = Lake.DRBMap.find? self.libraryFacetConfigs name

def Lake.Workspace.binPath (self : Lake.Workspace) : System.SearchPath

The workspace's binary directories (which are added to Path).

Equations

• self.binPath = Array.foldl (fun (dirs : System.SearchPath) (pkg : Lake.Package) => pkg.binDir :: dirs) [] self.packages

def Lake.Workspace.leanPath (self : Lake.Workspace) : System.SearchPath

The workspace's Lean library directories (which are added to LEAN_PATH).

Equations

• self.leanPath = Array.foldl (fun (dirs : System.SearchPath) (pkg : Lake.Package) => pkg.leanLibDir :: dirs) [] self.packages

def Lake.Workspace.leanSrcPath (self : Lake.Workspace) : System.SearchPath

The workspace's source directories (which are added to LEAN_SRC_PATH).

Equations

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

def Lake.Workspace.sharedLibPath (self : Lake.Workspace) : System.SearchPath

The workspace's shared library path (e.g., for --load-dynlib). This is added to the sharedLibPathEnvVar by lake env.

Equations

• self.sharedLibPath = Array.foldr (fun (pkg : Lake.Package) (dirs : System.SearchPath) => pkg.nativeLibDir :: dirs) [] self.packages

def Lake.Workspace.augmentedPath (self : Lake.Workspace) : System.SearchPath

The detected PATH of the environment augmented with the workspace's binDir and Lean and Lake installations' binDir.

Equations

• self.augmentedPath = self.binPath ++ self.lakeEnv.path

def Lake.Workspace.augmentedLeanPath (self : Lake.Workspace) : System.SearchPath

The detected LEAN_PATH of the environment augmented with the workspace's leanPath and Lake's libDir.

Equations

• self.augmentedLeanPath = self.leanPath ++ self.lakeEnv.leanPath

def Lake.Workspace.augmentedLeanSrcPath (self : Lake.Workspace) : System.SearchPath

The detected LEAN_SRC_PATH of the environment augmented with the workspace's leanSrcPath and Lake's srcDir.

Equations

• self.augmentedLeanSrcPath = self.leanSrcPath ++ self.lakeEnv.leanSrcPath

def Lake.Workspace.augmentedSharedLibPath (self : Lake.Workspace) : System.SearchPath

Equations

• self.augmentedSharedLibPath = self.sharedLibPath ++ self.lakeEnv.sharedLibPath

def Lake.Workspace.augmentedEnvVars (self : Lake.Workspace) : Array (String × Option String)

The detected environment augmented with Lake's and the workspace's paths. These are the settings use by lake env / Lake.env to run executables.

Equations

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

def Lake.Workspace.clean (self : Lake.Workspace) : IO Unit

Remove all packages' build outputs (i.e., delete their build directories).

Equations

• self.clean = Array.forM (fun (pkg : Lake.Package) => pkg.clean) self.packages