Lake's Environment

Definitions related to a Lake environment. A Lake environment is computed on Lake's startup from user-specified CLI options and the process environment.

structure Lake.Env : Type

A Lake environment.

• lake : Lake.LakeInstall

  The Lake installation of the environment.

• lean : Lake.LeanInstall

  The Lean installation of the environment.

• elan? : Option Lake.ElanInstall

  The Elan installation (if any) of the environment.

• pkgUrlMap : Lake.NameMap String

  A name-to-URL mapping of URL overwrites for the named packages.

• initToolchain : String

  The initial Elan toolchain of the environment (i.e., ELAN_TOOLCHAIN).

• initLeanPath : Lake.SearchPath

  The initial Lean library search path of the environment (i.e., LEAN_PATH).

• initLeanSrcPath : Lake.SearchPath

  The initial Lean source search path of the environment (i.e., LEAN_SRC_PATH).

• initSharedLibPath : Lake.SearchPath

  The initial shared library search path of the environment.

• initPath : Lake.SearchPath

  The initial binary search path of the environment (i.e., PATH).

instance Lake.instInhabitedEnv : Inhabited Lake.Env

Equations

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

def Lake.Env.compute (lake : Lake.LakeInstall) (lean : Lake.LeanInstall) (elan? : Option Lake.ElanInstall) : EIO String Lake.Env

Compute an Lake.Env object from the given installs and set environment variables.

Equations

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

def Lake.Env.compute.computePkgUrlMap : EIO String (Lake.NameMap String)

Equations

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

def Lake.Env.toolchain (env : Lake.Env) : String

The preferred toolchain of the environment. May be empty. Tries env.initToolchain first and then Lake's Lean.toolchain.

Equations

• Lake.Env.toolchain env = if String.isEmpty env.initToolchain = true then Lean.toolchain else env.initToolchain

def Lake.Env.path (env : Lake.Env) : Lake.SearchPath

The binary search path of the environment (i.e., PATH). Combines the initial path of the environment with that of the Lake installation.

Equations

• Lake.Env.path env = if env.lake.binDir = env.lean.binDir then env.lean.binDir :: env.initPath else env.lake.binDir :: env.lean.binDir :: env.initPath

def Lake.Env.leanPath (env : Lake.Env) : Lake.SearchPath

The Lean library search path of the environment (i.e., LEAN_PATH). Combines the initial path of the environment with that of the Lake installation.

Equations

• Lake.Env.leanPath env = env.lake.libDir :: env.initLeanPath

def Lake.Env.leanSrcPath (env : Lake.Env) : Lake.SearchPath

The Lean source search path of the environment (i.e., LEAN_SRC_PATH). Combines the initial path of the environment with that of the Lake and Lean installations.

Equations

• Lake.Env.leanSrcPath env = env.lake.srcDir :: env.initLeanSrcPath

def Lake.Env.sharedLibPath (env : Lake.Env) : Lake.SearchPath

The shared library search path of the environment. Combines the initial path of the environment with that of the Lean installation.

Equations

• Lake.Env.sharedLibPath env = Lake.LeanInstall.sharedLibPath env.lean ++ env.initSharedLibPath

def Lake.Env.baseVars (env : Lake.Env) : Array (String × Option String)

Environment variable settings that are not augmented by a Lake workspace.

Equations

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

def Lake.Env.vars (env : Lake.Env) : Array (String × Option String)

Environment variable settings for the Lake.Env.

Equations

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

def Lake.Env.leanSearchPath (env : Lake.Env) : Lake.SearchPath

The default search path the Lake executable uses when interpreting package configuration files.

In order to use the Lean stdlib (e.g., Init), the executable needs the search path to include the directory with the stdlib's .olean files (e.g., from <lean-sysroot>/lib/lean). In order to use Lake's modules as well, the search path also needs to include Lake's .olean files (e.g., from build).

While this can be done by having the user augment LEAN_PATH with the necessary directories, Lake also intelligently augments the initial search path with the .olean directories of the provided Lean and Lake installations.

See findInstall? for more information on how Lake determines those directories. If everything is configured as expected, the user will not need to augment LEAN_PATH. Otherwise, they will need to provide Lake with more information (either through LEAN_PATH or through other options).

Equations

• Lake.Env.leanSearchPath env = env.lake.libDir :: env.lean.leanLibDir :: Lake.Env.leanPath env