@[reducible, inline]

abbrev Lake.LeanExe : Type

A Lean executable -- its package plus its configuration.

@[inline]

def Lake.Package.leanExes (self : Package) : Array LeanExe

The Lean executables of the package (as an Array).

@[inline]

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

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

def Lake.LeanExeConfig.toLeanLibConfig {n : Lean.Name} (self : LeanExeConfig n) : LeanLibConfig n

Converts the executable configuration into a library with a single module (the root).

@[inline]

def Lake.LeanExe.config (self : LeanExe) : LeanExeConfig self.name

The executable's user-defined configuration.

@[inline]

def Lake.LeanExe.toLeanLib (self : LeanExe) : LeanLib

Converts the executable into a library with a single module (the root).

@[inline]

def Lake.LeanExe.root (self : LeanExe) : Module

The executable's root module.

def Lake.LeanExe.isRoot? (name : Lean.Name) (self : LeanExe) : Option Module

Return the root module if the name matches; otherwise, return none.

def Lake.LeanExe.isRootSrc? (path : System.FilePath) (self : LeanExe) : Option Module

Return the root module if the file stem of the path matches the source file. Otherwise, returns none.

@[inline]

def Lake.LeanExe.fileName (self : LeanExe) : System.FilePath

The file name of binary executable (i.e., exeName plus the platform's exeExtension).

@[inline]

def Lake.LeanExe.file (self : LeanExe) : System.FilePath

The path to the executable in the package's binDir.

@[inline]

def Lake.LeanExe.supportInterpreter (self : LeanExe) : Bool

The executable's supportInterpreter configuration.

def Lake.LeanExe.linkArgs (self : LeanExe) : Array String

The arguments to pass to leanc when linking the binary executable.

By default, the package's plus the executable's moreLinkArgs. If supportInterpreter := true, Lake prepends -rdynamic on non-Windows systems. On Windows, it links in a manifest for Unicode path support.

@[inline]

def Lake.LeanExe.sharedLean (self : LeanExe) : Bool

Whether the Lean shared library should be dynamically linked to the executable.

If supportInterpreter := true, Lean symbols must be visible to the interpreter. On Windows, it is not possible to statically include these symbols in the executable due to symbol limits, so Lake dynamically links to the Lean shared library. Otherwise, Lean is linked statically.

@[inline]

def Lake.LeanExe.weakLinkArgs (self : LeanExe) : Array String

The arguments to weakly pass to leanc when linking the binary executable. That is, the package's weakLinkArgs plus the executable's weakLinkArgs.

@[inline]

def Lake.LeanExe.moreLinkObjs (self : LeanExe) : TargetArray System.FilePath

Additional objects (e.g., .o files, static libraries) to link to the executable.

@[inline]

def Lake.LeanExe.moreLinkLibs (self : LeanExe) : TargetArray Dynlib

Additional shared libraries to link to the executable.

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

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

def Lake.Package.findModuleBySrc? (path : System.FilePath) (self : Package) : Option Module

Returns the buildable module in the package whose source file is path.