Safe Haskell | None |
---|---|
Language | Haskell2010 |
Distribution.Client.ProjectBuilding.UnpackedPackage
Contents
Description
This module exposes functions to build and register unpacked packages.
Mainly, unpacked packages are either: * Built and registered in-place * Built and installed
The two cases differ significantly for there to be a distinction. For instance, we only care about file monitoring and re-building when dealing with "inplace" registered packages, whereas for installed packages we don't.
Synopsis
- buildInplaceUnpackedPackage :: Verbosity -> DistDirLayout -> Maybe SemaphoreName -> BuildTimeSettings -> Lock -> Lock -> ElaboratedSharedConfig -> ElaboratedInstallPlan -> ElaboratedReadyPackage -> BuildStatusRebuild -> FilePath -> FilePath -> IO BuildResult
- buildAndInstallUnpackedPackage :: Verbosity -> DistDirLayout -> StoreDirLayout -> Maybe SemaphoreName -> BuildTimeSettings -> Lock -> Lock -> ElaboratedSharedConfig -> ElaboratedInstallPlan -> ElaboratedReadyPackage -> FilePath -> FilePath -> IO BuildResult
- buildAndRegisterUnpackedPackage :: Verbosity -> DistDirLayout -> Maybe SemaphoreName -> BuildTimeSettings -> Lock -> Lock -> ElaboratedSharedConfig -> ElaboratedInstallPlan -> ElaboratedReadyPackage -> FilePath -> FilePath -> Maybe FilePath -> (PackageBuildingPhase -> IO ()) -> IO ()
- data PackageBuildingPhase
- annotateFailure :: Maybe FilePath -> (SomeException -> BuildFailureReason) -> IO a -> IO a
- annotateFailureNoLog :: (SomeException -> BuildFailureReason) -> IO a -> IO a
Documentation
buildInplaceUnpackedPackage :: Verbosity -> DistDirLayout -> Maybe SemaphoreName -> BuildTimeSettings -> Lock -> Lock -> ElaboratedSharedConfig -> ElaboratedInstallPlan -> ElaboratedReadyPackage -> BuildStatusRebuild -> FilePath -> FilePath -> IO BuildResult #
buildAndInstallUnpackedPackage #
Arguments
:: Verbosity | |
-> DistDirLayout | |
-> StoreDirLayout | |
-> Maybe SemaphoreName | Whether to pass a semaphore to build process this is different to BuildTimeSettings because the name of the semaphore is created freshly each time. |
-> BuildTimeSettings | |
-> Lock | |
-> Lock | |
-> ElaboratedSharedConfig | |
-> ElaboratedInstallPlan | |
-> ElaboratedReadyPackage | |
-> FilePath | |
-> FilePath | |
-> IO BuildResult |
Auxiliary definitions
buildAndRegisterUnpackedPackage #
Arguments
:: Verbosity | |
-> DistDirLayout | |
-> Maybe SemaphoreName | Whether to pass a semaphore to build process this is different to BuildTimeSettings because the name of the semaphore is created freshly each time. |
-> BuildTimeSettings | |
-> Lock | |
-> Lock | |
-> ElaboratedSharedConfig | |
-> ElaboratedInstallPlan | |
-> ElaboratedReadyPackage | |
-> FilePath | |
-> FilePath | |
-> Maybe FilePath | The path to an initialized log file |
-> (PackageBuildingPhase -> IO ()) | |
-> IO () |
Structures the phases of building and registering a package amongst others
(see PackageBuildingPhase
). Delegates logic specific to a certain
building style (notably, inplace vs install) to the delegate function that
receives as an argument PackageBuildingPhase
)
data PackageBuildingPhase #
Each unpacked package is processed in the following phases:
- Configure phase
- Build phase
- Haddock phase
- Install phase (copy + register)
- Register phase
- Test phase
- Bench phase
- Repl phase
Depending on whether we are installing the package or building it inplace, the phases will be carried out differently. For example, when installing, the test, benchmark, and repl phase are ignored.
Utilities
annotateFailure :: Maybe FilePath -> (SomeException -> BuildFailureReason) -> IO a -> IO a #
annotateFailureNoLog :: (SomeException -> BuildFailureReason) -> IO a -> IO a #