Copyright	(c) The University of Glasgow 2006 Duncan Coutts 2008
Maintainer	[email protected]
Stability	alpha
Portability	portable
Safe Haskell	None
Language	Haskell2010

Distribution.Client.SetupWrapper

Description

An interface to building and installing Cabal packages. If the Built-Type field is specified as something other than Custom, and the current version of Cabal is acceptable, this performs setup actions directly. Otherwise it builds the setup script and runs it with the given arguments.

Synopsis

getSetup :: Verbosity -> SetupScriptOptions -> Maybe PackageDescription -> IO Setup
runSetup :: Verbosity -> Setup -> [String] -> IO ()
runSetupCommand :: Verbosity -> Setup -> CommandUI flags -> (flags -> CommonSetupFlags) -> flags -> [String] -> IO ()
setupWrapper :: Verbosity -> SetupScriptOptions -> Maybe PackageDescription -> CommandUI flags -> (flags -> CommonSetupFlags) -> (Version -> IO flags) -> (Version -> [String]) -> IO ()
data SetupScriptOptions = SetupScriptOptions {
- useCabalVersion :: VersionRange
- useCabalSpecVersion :: Maybe Version
- useCompiler :: Maybe Compiler
- usePlatform :: Maybe Platform
- usePackageDB :: PackageDBStackCWD
- usePackageIndex :: Maybe InstalledPackageIndex
- useProgramDb :: ProgramDb
- useDistPref :: SymbolicPath Pkg ('Dir Dist)
- useLoggingHandle :: Maybe Handle
- useWorkingDir :: Maybe (SymbolicPath CWD ('Dir Pkg))
- useExtraPathEnv :: [FilePath]
- useExtraEnvOverrides :: [(String, Maybe FilePath)]
- forceExternalSetupMethod :: Bool
- useDependencies :: [(ComponentId, PackageId)]
- useDependenciesExclusive :: Bool
- useVersionMacros :: Bool
- useWin32CleanHack :: Bool
- setupCacheLock :: Maybe Lock
- isInteractive :: Bool
- isMainLibOrExeComponent :: Bool
}
defaultSetupScriptOptions :: SetupScriptOptions

Documentation

getSetup :: Verbosity -> SetupScriptOptions -> Maybe PackageDescription -> IO Setup Source #

Prepare to build a package by configuring a SetupMethod. The returned Setup object identifies the method. The SetupScriptOptions may be changed during the configuration process; the final values are given by setupScriptOptions.

runSetup Source #

Arguments

:: Verbosity
-> Setup
-> [String]	command-line arguments
-> IO ()

Run a configured Setup with specific arguments.

runSetupCommand Source #

Arguments

:: Verbosity
-> Setup
-> CommandUI flags	command definition
-> (flags -> CommonSetupFlags)
-> flags	command flags
-> [String]	extra command-line arguments
-> IO ()

Run a command through a configured Setup.

setupWrapper Source #

Arguments

:: Verbosity
-> SetupScriptOptions
-> Maybe PackageDescription
-> CommandUI flags
-> (flags -> CommonSetupFlags)
-> (Version -> IO flags)	produce command flags given the Cabal library version
-> (Version -> [String])
-> IO ()

Configure a Setup and run a command in one step. The command flags may depend on the Cabal library version in use.

data SetupScriptOptions Source #

SetupScriptOptions are options used to configure and run Setup, as opposed to options given to the Cabal command at runtime.

Constructors

SetupScriptOptions

Fields

useCabalVersion :: VersionRange
The version of the Cabal library to use (if useDependenciesExclusive is not set). A suitable version of the Cabal library must be installed (or for some build-types be the one cabal-install was built with).
The version found also determines the version of the Cabal specification that we us for talking to the Setup.hs, unless overridden by useCabalSpecVersion.
useCabalSpecVersion :: Maybe Version
This is the version of the Cabal specification that we believe that this package uses. This affects the semantics and in particular the Setup command line interface.
This is similar to useCabalVersion but instead of probing the system for a version of the Cabal library you just say exactly which version of the spec we will use. Using this also avoid adding the Cabal library as an additional dependency, so add it to useDependencies if needed.
useCompiler :: Maybe Compiler
usePlatform :: Maybe Platform
usePackageDB :: PackageDBStackCWD
usePackageIndex :: Maybe InstalledPackageIndex
useProgramDb :: ProgramDb
useDistPref :: SymbolicPath Pkg ('Dir Dist)
useLoggingHandle :: Maybe Handle
useWorkingDir :: Maybe (SymbolicPath CWD ('Dir Pkg))
useExtraPathEnv :: [FilePath]
Extra things to add to PATH when invoking the setup script.
useExtraEnvOverrides :: [(String, Maybe FilePath)]
Extra environment variables paired with overrides, where
- Just v means "set the environment variable's value to v".
- Nothing means "unset the environment variable".
forceExternalSetupMethod :: Bool
useDependencies :: [(ComponentId, PackageId)]
List of dependencies to use when building Setup.hs.
useDependenciesExclusive :: Bool
Is the list of setup dependencies exclusive?
When this is False, if we compile the Setup.hs script we do so with the list in useDependencies but all other packages in the environment are also visible. A suitable version of Cabal library (see useCabalVersion) is also added to the list of dependencies, unless useDependencies already contains a Cabal dependency.
When True, only the useDependencies packages are used, with other packages in the environment hidden.
This feature is here to support the setup stanza in .cabal files that specifies explicit (and exclusive) dependencies, as well as the old style with no dependencies.
useVersionMacros :: Bool
Should we build the Setup.hs with CPP version macros available? We turn this on when we have a setup stanza in .cabal that declares explicit setup dependencies.
useWin32CleanHack :: Bool
setupCacheLock :: Maybe Lock
isInteractive :: Bool
Is the task we are going to run an interactive foreground task, or an non-interactive background task? Based on this flag we decide whether or not to delegate ctrl+c to the spawned task
isMainLibOrExeComponent :: Bool
Let the setup script logic know if it is being run to build a main library or executable component. This is used to determine if we should use the configure command, if the build-type is Configure. For configure, only the main library and execomponents have configure support, and thus we can skip running configure for other components.

defaultSetupScriptOptions :: SetupScriptOptions Source #